## Basic tool info Tool name: black-forest-labs/flux-pro-1-1-ultra Tool description: A state-of-the-art text-based image editing model that delivers high-quality outputs with excellent prompt following and consistent results for transforming images through natural language Tool cover: https://cdn.wiro.ai/uploads/models/black-forest-labs-flux-pro-1-1-ultra-cover.png Tool categories: - tool - bfl - flux-pro - text-to-image - image-to-image - partner Tool tags: - image generation - flux-pro Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/black-forest-labs/flux-pro-1-1-ultra Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: prompt label: prompt help: Text prompt for image generation. type: textarea default: A quiet, sun-drenched Los Angeles street from a low, eye-level perspective. Tall, slender palm trees line the sidewalk, their fronds swaying gently against a clear, cerulean sky. Vintage streetlights stand sentinel, and the asphalt shimmers with heat. In the distance, the iconic Hollywood Sign is subtly visible between buildings, and the faint outlines of the Hollywood Hills rise beyond. Sunlight casts long, sharp shadows of telephone poles and power lines across the scene. Urban, serene, realistic, street-level view, cinematic lighting, high detail, 8K. - name: promptUpsampling label: Prompt Upsampling help: Whether to perform upsampling on the prompt. If active, automatically modifies the prompt for more creative generation. type: select default: false options: - value: "false" label: NO - value: "true" label: YES - name: safetyTolerance label: Safety Tolerance help: Tolerance level for input and output moderation. Between 0 and 6, 0 being most strict, 6 being least strict. type: select default: 2 options: - value: "2" label: 2 - name: aspectRatio label: Aspect Ratio help: Aspect ratio of the image. type: select default: 16:9 options: - value: "1:1" label: 1:1 - value: "16:9" label: 16:9 - value: "9:16" label: 9:16 - value: "4:3" label: 4:3 - value: "3:4" label: 3:4 - value: "3:2" label: 3:2 - value: "2:3" label: 2:3 - value: "4:5" label: 4:5 - value: "5:4" label: 5:4 - value: "21:9" label: 21:9 - value: "9:21" label: 9:21 - value: "2:1" label: 2:1 - value: "1:2" label: 1:2 - name: seed label: seed help: seed-help type: text default: 42 - name: outputFormat label: Output Format help: Output format for the generated image. Can be 'jpeg' or 'png'. type: select default: png options: - value: "jpeg" label: jpeg - value: "png" label: png ## Tool Parameter Inspires: - prompt: An elderly man reads a newspaper at a corner café, surrounded by vintage wooden furniture and sunlit potted plants. Morning light streams through the open windows, casting soft shadows across the tiled floor. His glasses rest low on his nose, and a cup of steaming espresso sits untouched on the table. - prompt: A lone lighthouse stands on a rugged coastline, waves crashing against the rocks below. The sky is heavy with storm clouds, and a bolt of lightning illuminates the turbulent sea. The lighthouse’s warm beam cuts through the darkness, guiding unseen ships from afar. - prompt: A sleek motorcycle parked under a neon-lit bridge in a rainy city at night. Reflections of purple, blue, and pink lights shimmer across wet pavement. A figure wearing a black helmet leans casually against the bike, the glow of a nearby holographic ad casting colored highlights on their jacket. - prompt: A child wearing a superhero cape runs through a golden wheat field at sunset, arms outstretched like airplane wings. The wind ripples through the tall stalks, and a scarecrow in the distance mirrors the child’s pose. Warm, cinematic, nostalgic. - prompt: A glass terrarium filled with tiny, bioluminescent plants, glowing softly in shades of green and blue. Miniature waterfalls cascade over mossy rocks inside. The container rests on a wooden shelf with books and scientific instruments in the background. - prompt: A detailed model of a steam locomotive surrounded by miniature passengers, trees, and train tracks. Smoke gently curls from the engine’s smokestack as golden light filters through a nearby window, creating a nostalgic, museum-like atmosphere. - prompt: A close-up of a sunflower blooming in a cracked sidewalk, juxtaposed against a gritty urban backdrop. Tiny dew droplets cling to its petals as early morning light reflects off nearby graffiti-covered brick walls. Urban resilience, nature vs. manmade. ## Integration Header Prepare ```bash # Sign up Wiro dashboard and create project export YOUR_API_KEY="{{useSelectedProjectAPIKey}}"; export YOUR_API_SECRET="XXXXXXXXX"; # unix time or any random integer value export NONCE=$(date +%s); # hmac-SHA256 (YOUR_API_SECRET+Nonce) with YOUR_API_KEY export SIGNATURE="$(echo -n "${YOUR_API_SECRET}${NONCE}" | openssl dgst -sha256 -hmac "${YOUR_API_KEY}")"; ``` ## Run Command - Make HTTP Post Request ```bash curl -X POST "https://api.wiro.ai/v1/Run/black-forest-labs/flux-pro-1-1-ultra" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "prompt": "A quiet, sun-drenched Los Angeles street from a low, eye-level perspective. Tall, slender palm trees line the sidewalk, their fronds swaying gently against a clear, cerulean sky. Vintage streetlights stand sentinel, and the asphalt shimmers with heat. In the distance, the iconic Hollywood Sign is subtly visible between buildings, and the faint outlines of the Hollywood Hills rise beyond. Sunlight casts long, sharp shadows of telephone poles and power lines across the scene. Urban, serene, realistic, street-level view, cinematic lighting, high detail, 8K.", "promptUpsampling": "false", "safetyTolerance": "2", "aspectRatio": "16:9", "seed": "42", "outputFormat": "png", "callbackUrl": "You can provide a callback URL; Wiro will send a POST request to it when the task is completed." }'; ``` ## Run Command - Response ```json { "errors": [], "taskid": "2221", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "result": true } ``` ## Get Task Detail - Make HTTP Post Request with Task ID ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "2221" }'; ``` ## Get Task Detail - Make HTTP Post Request with Socket Access Token ```bash curl -X POST "https://api.wiro.ai/v1/Task/Detail" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "tasktoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt" }'; ``` ## Get Task Detail - Response ```json { "total": "1", "errors": [], "tasklist": [ { "id": "2221", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "socketaccesstoken": "eDcCm5yyUfIvMFspTwww49OUfgXkQt", "parameters": {}, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_postprocess_end", "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Kill Task - Make HTTP Post Request with Task ID ```bash curl -X POST "https://api.wiro.ai/v1/Task/Kill" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "534574" }'; ``` ## Kill Task - Make HTTP Post Request with Socket Access Token ```bash curl -X POST "https://api.wiro.ai/v1/Task/Kill" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE" }'; ``` ## Kill Task - Response ```json { "errors": [], "tasklist": [ { "id": "534574", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "name": "", "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE", "parameters": { "inputImage": "https://api.wiro.ai/v1/File/mCmUXgZLG1FNjjjwmbtPFr2LVJA112/inputImage-6060136.png" }, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_cancel", "cps": "0.000585000000", "totalcost": "0.003510000000", "guestid": null, "projectid": "699", "modelid": "598", "description": "", "basemodelid": "0", "runtype": "model", "modelfolderid": "", "modelfileid": "", "callbackurl": "", "marketplaceid": null, "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "pexit": "0", "categories": "["tool","image-to-image","quick-showcase","compare-landscape"]", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "foldercount": "0", "filecount": "0", "ispublic": 0, "expiretime": null, "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Cancel Task - Make HTTP Post Request (For tasks on queue) ```bash curl -X POST "https://api.wiro.ai/v1/Task/Cancel" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "634574" }'; ``` ## Cancel Task - Response ```json { "errors": [], "tasklist": [ { "id": "634574", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "name": "", "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE", "parameters": { "inputImage": "https://api.wiro.ai/v1/File/mCmUXgZLG1FNjjjwmbtPFr2LVJA112/inputImage-6060136.png" }, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_cancel", "cps": "0.000585000000", "totalcost": "0.003510000000", "guestid": null, "projectid": "699", "modelid": "598", "description": "", "basemodelid": "0", "runtype": "model", "modelfolderid": "", "modelfileid": "", "callbackurl": "", "marketplaceid": null, "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "pexit": "0", "categories": "["tool","image-to-image","quick-showcase","compare-landscape"]", "outputs": [ { "id": "6bc392c93856dfce3a7d1b4261e15af3", "name": "0.png", "contenttype": "image/png", "parentid": "6c1833f39da71e6175bf292b18779baf", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "size": "202472", "addedtime": "1734513812", "modifiedtime": "1734513812", "accesskey": "dFKlMApaSgMeHKsJyaDeKrefcHahUK", "foldercount": "0", "filecount": "0", "ispublic": 0, "expiretime": null, "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Task Status Information This section defines the possible task status values returned by the API when polling for task completion. ### Completed Task Statuses (Polling can stop) These indicate that the task has reached a terminal state — either success or failure. Once any of these is received, polling should stop. - task_postprocess_end : Task completed successfully and post-processing is done. - task_cancel : Task was cancelled by the user or system. ### Running Task Statuses (Continue polling) These statuses indicate that the task is still in progress. Polling should continue if one of these is returned. - task_queue : Task is waiting in the queue. - task_accept : Task has been accepted for processing. - task_assign : Task is being assigned to a worker. - task_preprocess_start : Preprocessing is starting. - task_preprocess_end : Preprocessing is complete. - task_start : Task execution has started. - task_output : Output is being generated.