## Basic tool info Model name: ByteDance/seedream-v5-pro-uncensored Model description: Generate 1K or 2K images with strong typography and reference-guided edits. Built on ByteDance Seedream 5.0 Pro for posters, UI, and product visuals. Model cover: https://cdn.wiro.ai/uploads/models/bytedance-seedream-v5-pro-uncensored-cover.webp Model categories: - tool - partner - ByteDance - image-to-image - text-to-image - quick-showcase - price-list - nogpu-pipeline Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/bytedance/seedream-v5-pro-uncensored Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Model Inputs: - name: inputImage label: input image help: Optional list of input image URL(s) and/or file(s) for creating or editing a single image (up to 10 reference images). type: combinefileinput default: - name: prompt label: Prompt help: Describe the image you want to generate. Seedream 5.0 Pro generates a single image per request. type: textarea default: - name: resolution label: Resolution help: Required. Output resolution tier. Also determines the price. type: select default: 1k options: - value: "1k" label: 1k - value: "2k" label: 2k - name: aspectRatio label: Aspect Ratio help: Required. Aspect ratio of the generated image. type: select default: 1:1 options: - value: "1:1" label: 1:1 (1k: 1024x1024) (2k: 2048x2048) - value: "2:3" label: 2:3 (1k: 832x1248) (2k: 1664x2496) - value: "3:2" label: 3:2 (1k: 1248x832) (2k: 2496x1664) - value: "3:4" label: 3:4 (1k: 864x1152) (2k: 1776x2368) - value: "4:3" label: 4:3 (1k: 1152x864) (2k: 2368x1776) - value: "16:9" label: 16:9 (1k: 1424x800) (2k: 2816x1584) - value: "9:16" label: 9:16 (1k: 800x1424) (2k: 1584x2816) - value: "21:9" label: 21:9 (1k: 1568x672) (2k: 3136x1344) - name: outputFormat label: Output format help: The file format of the generated image. type: select default: jpeg options: - value: "jpeg" label: jpeg - value: "png" label: png - name: watermark label: Watermark help: Whether the generated image contains a watermark. type: select default: false options: - value: "false" label: false - value: "true" label: true ## Model Parameter Inspires: - prompt: a photorealistic raw photograph of one young American woman in her early twenties, natural realistic human skin texture with visible pores, no wrinkles, no freckles, clear complexion, full lips, slim athletic figure with toned stomach and long slender legs, long straight platinum blonde hair, wearing a black satin lingerie set, posing in a professional photo studio against a seamless warm beige backdrop, softbox lighting with a subtle rim light, shot on a Canon EOS R5 with an 85mm f/1.4 lens, natural color grading, sharp focus on the eyes, shallow depth of field, high fashion editorial photograph, not a painting, not an illustration, not cartoon, not anime, not 3d render, not cgi, no plastic skin, no nudity - prompt: a photorealistic raw photograph of one young American woman in her early twenties, natural realistic human skin texture with visible pores, no wrinkles, no freckles, clear complexion, dark expressive eyes, full lips, slim athletic figure, long dark wavy brunette hair, wearing a white lace bralette and denim shorts, sitting in the passenger seat of a vintage convertible with one arm resting on the open window frame, warm late afternoon sunlight through the windshield, tan leather interior, shot on a Sony A7 IV with a 50mm f/1.8 lens, natural color grading, sharp focus, shallow depth of field, candid editorial photograph, not a painting, not an illustration, not cartoon, not anime, not 3d render, not cgi, no plastic skin, no nudity - prompt: a photorealistic raw photograph of one young American woman in her early twenties, natural realistic human skin texture with visible pores, no wrinkles, no freckles, clear sun-kissed complexion, full lips, slim athletic figure with toned stomach and long tanned legs, long wavy caramel blonde hair, sitting on the hood of a classic sports car on an empty desert highway, wearing a red string bikini top and cutoff denim shorts, golden hour sunlight with long shadows, mountains blurred in the background, shot on a Canon EOS R5 with a 35mm f/2 lens, natural color grading, sharp focus, shallow depth of field, editorial photograph, not a painting, not an illustration, not cartoon, not anime, not 3d render, not cgi, no plastic skin, no nudity - prompt: a photorealistic raw photograph of one young American woman in her early twenties, natural realistic human skin texture with visible pores, no wrinkles, no freckles, clear tanned complexion, full lips, slim athletic figure with toned stomach and long legs, long dark brunette hair damp and windswept, wearing a white string bikini, standing in shallow turquoise ocean water at a tropical beach, bright midday sunlight with sparkling water reflections, shot on a Nikon Z8 with a 70-200mm f/2.8 lens, natural color grading, sharp focus on the face, shallow depth of field, editorial photograph, not a painting, not an illustration, not cartoon, not anime, not 3d render, not cgi, no plastic skin, no nudity ## 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/bytedance/seedream-v5-pro-uncensored" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputImage": "", "prompt": "", "resolution": "1k", "aspectRatio": "1:1", "outputFormat": "jpeg", "watermark": "false", "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.