## Basic tool info Model name: ByteDance/seedream-v5-lite-uncensored Model description: Generate high-quality images from text prompts or image inputs using the Seedream v5 Lite Uncensored model. Supports multiple resolutions and aspect ratios. Model cover: https://cdn.wiro.ai/uploads/models/bytedance-seedream-v5-lite-uncensored-cover.webp Model categories: - tool - partner - ByteDance - image-to-image - text-to-image - quick-showcase - price-list - nogpu-pipeline Model tags: - ByteDance Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/bytedance/seedream-v5-lite-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, editing or combining images type: combinefileinput default: bytedance-seedream-v5-lite-uncensored-input-1.jpg - name: prompt label: Prompt help: Please provide how many images you want to generate in the prompt. Edit max images according to it. type: textarea default: A medium close-up photograph featuring the young woman with auburn hair in a messy bun and facial freckles from image, now depicted waist-deep in clear, crystalline blue-green tropical sea water. She has a genuine, happy smile and looks directly at the camera. She is wearing two piece bikini. Her gold hoop earrings are still visible. Her hands are in the water, splashing gently. The sunlight is bright, diffused, and clear, creating shimmering caustic patterns on the sandy bottom visible through the shallow water and reflecting off the gentle ripples. The background is a vast, calm turquoise ocean stretching to the horizon under a pale blue sky, with a very distant, lush, green tropical island. The focus is sharp on her face and upper body, with a shallow depth of field for the ocean and distant island. The natural light highlights her auburn hair and freckles. The composition is clean and focused. - name: resolution label: Resolution help: Optional for i2i. Required for t2i. If image is provided it will get the first images dimensions and calculate it according to 3686400, 10404496 these pixel counts, if lower it will be scaled up, if higher it will be scaled down by the given images ratio. type: select default: auto options: - value: "" label: auto (empty string) (legacy) - value: "auto" label: auto - value: "2k" label: 2k - value: "3k" label: 3k - name: aspectRatio label: Aspect Ratio help: Optional for i2i, Required for t2i. If image(s) provided it will get the image/first image ratio. type: select default: auto options: - value: "" label: auto (empty string) (legacy) - value: "auto" label: auto - value: "1:1" label: 1:1 (2k: 2048x2048) (3k: 3072x3072) - value: "2:3" label: 2:3 (2k: 1664x2496) (3k: 2496x3744) - value: "3:2" label: 3:2 (2k: 2496x1664) (3k: 3744x2496) - value: "3:4" label: 3:4 (2k: 1728x2304) (3k: 2592x3456) - value: "4:3" label: 4:3 (2k: 2304x1728) (3k: 3456x2592) - value: "16:9" label: 16:9 (2k: 2848x1600) (3k: 4096x2304) - value: "9:16" label: 9:16 (2k: 1600x2848) (3k: 2304x4096) - value: "21:9" label: 21:9 (2k: 3136x1344) (3k: 4704x2016) - name: maxImages label: Maximum number of output images help: This is the limiter for number of outputs. Number of input reference images + Number of generated must be smaller then or equal to 15. type: number default: 1 - name: watermark label: Watermark help: Whether the generated image(s) contains a watermark. type: select default: false options: - value: "false" label: false - value: "true" label: true ## Model Parameter Inspires: - prompt: High fashion editorial, beautiful woman wearing a vibrant tropical print two-piece string bikini, walking on a white sand beach at golden hour. Shallow depth of field, shot on 85mm lens, backlit by the setting sun, glowing skin, highly detailed fabric, photorealistic, cinematic lighting, 8k resolution. - inputImage: - prompt: Medium shot studio portrait, elegant female model wearing an intricate black lace lingerie set. Dramatic moody lighting, chiaroscuro, soft shadows, sharp focus on the fine lace texture and sheer fabric, dark neutral background, professional fashion photography, hyper-realistic, highly detailed. - inputImage: - prompt: A medium close-up photograph featuring the young woman with auburn hair in a messy bun and facial freckles from image, now depicted waist-deep in clear, crystalline blue-green tropical sea water. She has a genuine, happy smile and looks directly at the camera. She is wearing two piece bikini. Her gold hoop earrings are still visible. Her hands are in the water, splashing gently. The sunlight is bright, diffused, and clear, creating shimmering caustic patterns on the sandy bottom visible through the shallow water and reflecting off the gentle ripples. The background is a vast, calm turquoise ocean stretching to the horizon under a pale blue sky, with a very distant, lush, green tropical island. The focus is sharp on her face and upper body, with a shallow depth of field for the ocean and distant island. The natural light highlights her auburn hair and freckles. The composition is clean and focused. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/bytedance-seedream-v5-lite-uncensored-input-1.jpg - prompt: A medium shot of the man from image, with his specific facial features and dark hair, standing confidently on a raised runway podium. He is a high-fashion model, wearing a dramatic, asymmetric underwear in a charcoal and black pattern. Looking directly at the camera with a self-assured expression. Studio lights and camera flashes create lens flare, highlighting his sharp cheekbones. The background is a sophisticated fashion show environment with blurred attendees and minimalist, neutral-toned screens. Shot from a low angle to emphasize his height and presence. Realistic skin texture, deep colors, film grain. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/bytedance-seedream-v5-lite-uncensored-input-2.jpg ## 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-lite-uncensored" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputImage": "bytedance-seedream-v5-lite-uncensored-input-1.jpg", "prompt": "A medium close-up photograph featuring the young woman with auburn hair in a messy bun and facial freckles from image, now depicted waist-deep in clear, crystalline blue-green tropical sea water. She has a genuine, happy smile and looks directly at the camera. She is wearing two piece bikini. Her gold hoop earrings are still visible. Her hands are in the water, splashing gently. The sunlight is bright, diffused, and clear, creating shimmering caustic patterns on the sandy bottom visible through the shallow water and reflecting off the gentle ripples. The background is a vast, calm turquoise ocean stretching to the horizon under a pale blue sky, with a very distant, lush, green tropical island. The focus is sharp on her face and upper body, with a shallow depth of field for the ocean and distant island. The natural light highlights her auburn hair and freckles. The composition is clean and focused.", "resolution": "auto", "aspectRatio": "auto", "maxImages": 1, "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.