## Basic tool info Tool name: wiro/story-diffusion-advanced Tool description: It generates comic book-style images of the entered storylines in sequence. Additionally, we can specify our comic book character in the model. Tool cover: https://cdn.wiro.ai/uploads/models/wiro-story-diffusion-cover.png Tool categories: - tool - image-to-image - sdxl Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/wiro/story-diffusion-advanced Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: selectedModel label: select-model help: select-model-help type: select default: "79" options: - value: "1201" label: King_Hatchet/SereneXL description: SereneXL triggerwords: [] generatesettings: [] - value: "1107" label: advokat/5DN-Hyperdetailed description: 5DN Hyperdetailed triggerwords: [] generatesettings: [] - value: "1097" label: Coolreal/PureRealism-Mix-XL description: PureRealism Mix XL triggerwords: [] generatesettings: [] - value: "1096" label: mastertouch711/NaturaLust description: NaturaLust triggerwords: [] generatesettings: [] - value: "1095" label: terrariumbuilder497/AdeptSDXL description: AdeptSDXL triggerwords: [] generatesettings: [] - value: "1094" label: Raxephion/Tornado description: Tornado triggerwords: [] generatesettings: [] - value: "1089" label: joebowersphotography/Halcyon-SDXL-Photorealism description: Halcyon SDXL - Photorealism triggerwords: [] generatesettings: [] - value: "1088" label: PromptSharingSamaritan/Samaritan-CGI description: Samaritan CGI triggerwords: [] generatesettings: [] - value: "1082" label: PromptSharingSamaritan/Samaritan-3d-Cartoon description: Samaritan 3d Cartoon triggerwords: [] generatesettings: [] - value: "1079" label: ThinkDiffusion/ThinkDiffusionXL description: ThinkDiffusionXL triggerwords: [] generatesettings: [] - value: "1067" label: Adel_AI/Pixel-Alchemy description: Pixel Alchemy triggerwords: [] generatesettings: [] - value: "1066" label: JoeLink/WestRealistic-XL description: WestRealistic XL triggerwords: [] generatesettings: [] - value: "1061" label: galaxytimemachine/GalaxyTimeMachines-GTM-XLPlus description: GalaxyTimeMachine's GTM "XLPlus" triggerwords: [] generatesettings: [] - value: "1059" label: DarkBadBoy/NexusVisionXL description: NexusVisionXL triggerwords: [] generatesettings: [] - value: "1054" label: Splashed/Splashed-Mix-DMD description: Splashed Mix DMD triggerwords: [] generatesettings: [] - value: "1053" label: Splashed/Deep-Splashed-Something description: Deep Splashed Something triggerwords: [] generatesettings: [] - value: "1052" label: Splashed/Splashed-Journey description: Splashed Journey triggerwords: [] generatesettings: [] - value: "1049" label: Magenttta/Purple-XL-Anime description: Purple XL (Anime) triggerwords: [] generatesettings: [] - value: "1048" label: Magenttta/Fuchsia-XL description: Fuchsia XL triggerwords: [] generatesettings: [] - value: "1009" label: epiTune/chirps description: chirps triggerwords: [] generatesettings: [] - value: "1008" label: SLACK69/SLACK-ultra-real-XL-merge description: SLACK ultra real XL merge triggerwords: [] generatesettings: [] - value: "1007" label: Dark_infinity/Deep-Dark-Anime description: Deep Dark Anime triggerwords: [] generatesettings: [] - value: "999" label: 7whitefire7/RealCartoon-XL description: RealCartoon-XL triggerwords: [] generatesettings: [] - value: "995" label: Dark_infinity/Suzannes-XL-Mix description: Suzanne's XL Mix triggerwords: [] generatesettings: [] - value: "990" label: J1B/Jib-Mix-Artful description: Jib Mix Artful triggerwords: [] generatesettings: [] - value: "989" label: J1B/Jib-Mix-Realistic-XL description: Jib Mix Realistic XL triggerwords: [] generatesettings: [] - value: "984" label: socalguitarist/NightVisionXL description: NightVisionXL triggerwords: [] generatesettings: [] - value: "976" label: HorridWitch/OmnigenXL description: OmnigenXL triggerwords: [] generatesettings: [] - value: "975" label: StableDiffusionVN/SDVN6-RealXL description: SDVN6-RealXL triggerwords: [] generatesettings: [] - value: "966" label: StableDiffusionVN/SDVN7-NijiStyleXL description: SDVN7-NijiStyleXL triggerwords: ["niji style"] generatesettings: [] - value: "964" label: StableDiffusionVN/SDVN8-ArtXL description: SDVN8-ArtXL triggerwords: ["ghibli","sticker design","portrait art style","illustrator","horror style","anime style"] generatesettings: [] - value: "961" label: LEOSAM/HelloWorld-XL description: HelloWorld XL triggerwords: [] generatesettings: [] - value: "939" label: Zavy/ZavyChromaXL description: ZavyChromaXL triggerwords: [] generatesettings: [] - value: "927" label: Hevok/Endjourney-XL description: Endjourney XL triggerwords: [] generatesettings: [] - value: "904" label: Aurety/_MOHAWK_ description: _MOHAWK_ triggerwords: [] generatesettings: [] - value: "902" label: Aurety/_CHEYENNE_ description: _CHEYENNE_ triggerwords: [] generatesettings: [] - value: "900" label: sinatra/RDXL-SFW description: RDXL SFW triggerwords: [] generatesettings: [] - value: "899" label: sinatra/Real-Dream-SDXL-Classic description: Real Dream SDXL Classic triggerwords: [] generatesettings: [] - value: "880" label: SG_161222/RealVisXL-V5.0 description: RealVisXL V5.0 triggerwords: [] generatesettings: [] - value: "850" label: Lykon/DreamShaper-XL description: DreamShaper XL triggerwords: [] generatesettings: [] - value: "606" label: wangqixun/YamerMIX v8.0 description: An instruction-based image editing model SDXL. triggerwords: [] generatesettings: [] - value: "556" label: SG161222/RealVisXL_V4.0 description: An instruction-based image editing model SDXL. triggerwords: [] generatesettings: [] - value: "555" label: SG161222/RealVisXL_V3_0 description: An instruction-based image editing model SDXL. triggerwords: [] generatesettings: [] - value: "554" label: moxie1776/Moxie Diffusion XL v1.91 description: A text-to-image model trained on Stable Diffusion XL. triggerwords: [] generatesettings: [] - value: "425" label: KandooAI/Juggernaut v10.0 description: A text-to-image model trained on Stable Diffusion XL. triggerwords: [] generatesettings: [] - value: "422" label: braintacles/BriXL v5.0 description: BriXL is a fine-tuned model with a special focus on science fiction and cinematic vibes. Its imperfection is what makes it shine! It has been trained on a lot of my original content as well as cinematic materials. triggerwords: [] generatesettings: [] - value: "393" label: WarAnakin/Crystal Clear v1.0 description: A text-to-image model trained on Stable Diffusion XL. Whether you want realistic, 3D, semi-realistic, or cartoon-like images. triggerwords: [] generatesettings: [] - value: "390" label: PromptSharingSamaritan/Realistic Stock Photo v2.0 description: A text-to-image model trained on Stable Diffusion XL. triggerwords: [] generatesettings: [] - value: "389" label: Zavy/ZavyChromaXL v10.0 description: A text-to-image model trained on Stable Diffusion XL. triggerwords: [] generatesettings: [] - value: "388" label: RunDiffusion/RunDiffusion XL beta description: A text-to-image model trained on Stable Diffusion XL. triggerwords: [] generatesettings: [] - value: "79" label: stabilityai/stable-diffusion-xl-base-1.0 description: A text-to-image generative AI model that creates beautiful 1024x1024 images triggerwords: [] generatesettings: [] - name: selectedModelPrivate label: select-model-private help: select-model-private-help type: select default: "" options: - name: inputImageUrl label: pad-image-url help: In cases where we want the output to take a reference, we give image to this argument. type: text default: - name: inputImage2Url label: init-image-url help: init-imagurl-help type: text default: - name: prompt label: Character Detail Prompt help: If init_image is used, the 'img' trigger word must be added to character-details-prompt type: textarea default: img, a woman wearing red dress - name: generalPrompt label: prompt help: Images are produced as many times as the entered prompt amount. Format: ....|.....|.....|. If you need to change the caption, add a # at the end of each line. [NC]symbol (The [NC] symbol is used as a flag to indicate that no characters(init-image) should be present in the generated scene images. If you want do that, prepend the '[NC]' at the beginning of the line. For example, to generate a scene of falling leaves without any character, write: '[NC] The leaves are falling.'),Currently, support is only using Textual Description type: textarea default: wake up in the bed | have breakfast | is on the road, go to the company | work in the company | running in the playground | reading book in the home - name: negativePrompt label: negativeprompt help: negativeprompt-help type: textarea default: naked, deformed, bad anatomy, disfigured, poorly drawn face, mutation, extra limb, ugly, disgusting, poorly drawn hands, missing limb, floating limbs, disconnected limbs, blurry, watermarks, oversaturated, distorted hands, amputation - name: extraEventPrompts label: extra-event-prompt help: Format: ....|....|.... type: textarea default: siting on the sofa | on the bed, at night - name: styleName label: style-name help: style-name-help type: select default: Comic book options: - value: "Comic book" label: Comic book - value: "Japanese Anime" label: Japanese Anime - value: "Digital/Oil Painting" label: Digital/Oil Painting - value: "Pixar/Disney Character" label: Pixar/Disney Character - value: "Photographic" label: Photographic - value: "Line art" label: Line art - value: "Black and White Film Noir" label: Black and White Film Noir - value: "Isometric Rooms" label: Isometric Rooms - name: steps label: inferencesteps help: inferencesteps-help type: number default: 30 - name: width label: width help: width-help type: number default: 768 - name: height label: height help: height-help type: number default: 768 - name: fontSize label: guidancescale help: font-size-help type: number default: 30 - name: imageLength label: id-image-length help: id-image-length-help type: number default: 4 - name: scale label: guidancescale help: guidancescale-help type: float default: 2.0 - name: seed label: seed help: seed-help type: number default: 123456 ## Tool Parameter Inspires: - prompt: a man, wearing black suit - generalPrompt: wake up in the bed | have breakfast | is on the road, go to the company | work in the company | running in the playground | reading book in the home - negativePrompt: naked, deformed, bad anatomy, disfigured, poorly drawn face, mutation, extra limb, ugly, disgusting, poorly drawn hands, missing limb, floating limbs, disconnected limbs, blurry, watermarks, oversaturated, distorted hands, amputation - prompt: a policeman img, wearing a white shirt - generalPrompt: Directing traffic on the road. | walking on the streets. | Chasing a man on the street. | At the police station. - negativePrompt: naked, deformed, bad anatomy, disfigured, poorly drawn face, mutation, extra limb, ugly, disgusting, poorly drawn hands, missing limb, floating limbs, disconnected limbs, blurry, watermarks, oversaturated, distorted hands, amputation - prompt: a girl, wearing white shirt, black skirt, black tie, yellow hair - generalPrompt: at home #at home, began to go to drawing | sitting alone on a park bench. | reading a book on a park bench. | [NC]A squirrel approaches, peeking over the bench. | look around in the park. # She looks around and enjoys the beauty of nature. | [NC]leaf falls from the tree, landing on the sketchbook. | picks up the leaf, examining its details closely. | [NC]The brown squirrel appear. | is very happy # She is very happy to see the squirrel again | [NC]The brown squirrel takes the cracker and scampers up a tree. # She gives the squirrel cracker - negativePrompt: naked, deformed, bad anatomy, disfigured, poorly drawn face, mutation, extra limb, ugly, disgusting, poorly drawn hands, missing limb, floating limbs, disconnected limbs, blurry, watermarks, oversaturated, distorted hands, amputation - prompt: img, a woman wearing red dress - generalPrompt: wake up in the bed | have breakfast | is on the road, go to the company | work in the company | running in the playground | reading book in the home - negativePrompt: naked, deformed, bad anatomy, disfigured, poorly drawn face, mutation, extra limb, ugly, disgusting, poorly drawn hands, missing limb, floating limbs, disconnected limbs, blurry, watermarks, oversaturated, distorted hands, amputation ## 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/wiro/story-diffusion-advanced" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "selectedModel": "", "selectedModelPrivate": "", "inputImageUrl": "bg-img2.png", "inputImage2Url": "ic-light.png", "prompt": "img, a woman wearing red dress", "generalPrompt": "wake up in the bed | have breakfast | is on the road, go to the company | work in the company | running in the playground | reading book in the home", "negativePrompt": "naked, deformed, bad anatomy, disfigured, poorly drawn face, mutation, extra limb, ugly, disgusting, poorly drawn hands, missing limb, floating limbs, disconnected limbs, blurry, watermarks, oversaturated, distorted hands, amputation", "extraEventPrompts": "siting on the sofa | on the bed, at night", "styleName": "Comic book", "steps": 30, "width": 768, "height": 768, "fontSize": 30, "imageLength": 4, "scale": "2.0", "seed": 123456, "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.