## Basic tool info Model name: wiro/Superhero Powers Effect Model description: Cinematic superhero power-up, aura and transformation videos generated from a single portrait. 35 scenarios. Model cover: https://cdn.wiro.ai/uploads/models/wiro-superhero-powers-effect-cover.mp4 Model categories: - tool - use-agent - wiroEntertainment - fast-inference - image-to-video - wiro-app - beautykit - partner - nogpu-pipeline Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/wiro/superhero-powers-effect Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Model Inputs: - name: inputImage label: Input Image help: Required: see selected effect for image details type: combinefileinput default: ai-portrait-daily-asian-woman.webp - name: effectType label: Effect Type help: Required type: selectwithcover default: aura+powerup-golden+saiyan+desert options: - value: "aura+powerup-golden+saiyan+desert" label: Copper Ember Desert Power-Up cover: seffect/aura%2Bpowerup-golden%2Bsaiyan%2Bdesert.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-blue+kaioken+cliff" label: Blue Plasma Cliff Arc Awakening cover: seffect/aura%2Bpowerup-blue%2Bkaioken%2Bcliff.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-red+rage+ruins" label: Crimson Quarry Magma Eruption cover: seffect/aura%2Bpowerup-red%2Brage%2Bruins.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-silver+ultra+instinct" label: Silver Moon-Calm Summit Surge cover: seffect/aura%2Bpowerup-silver%2Bultra%2Binstinct.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-purple+void+villain" label: Violet Void Warehouse Ink-Field Corruption cover: seffect/aura%2Bpowerup-purple%2Bvoid%2Bvillain.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-office+worker+exploded" label: Overtime Office Magenta Awakening cover: seffect/aura%2Bpowerup-office%2Bworker%2Bexploded.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-street+anime+night" label: Jade Amber Megacity Crosswalk Ignition cover: seffect/aura%2Bpowerup-street%2Banime%2Bnight.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-training+ground+dust" label: Coral Sand Pit Levitation Awakening cover: seffect/aura%2Bpowerup-training%2Bground%2Bdust.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-rain+awakening+rooftop" label: Rainy Rooftop Jade Arc Awakening cover: seffect/aura%2Bpowerup-rain%2Bawakening%2Brooftop.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-nano+armor" label: Lattice Exosuit Bloom Assembly cover: seffect/superhero%2Beffect-nano%2Barmor.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-brute+smash" label: Stone-Oxide Colossus Ground Smash Shockwave cover: seffect/superhero%2Beffect-brute%2Bsmash.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-plasma+palm+blast" label: Overhead Plasma Palm Detonation cover: seffect/superhero%2Beffect-plasma%2Bpalm%2Bblast.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-water+dragon" label: Crystal Tide Canyon Beast Cleave cover: seffect/superhero%2Beffect-water%2Bdragon.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-thunder+dash" label: Violet Arc Saber Wraith Cleave cover: seffect/superhero%2Beffect-thunder%2Bdash.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-force+push" label: Pressure-Bubble Kinetic Shove cover: seffect/superhero%2Beffect-force%2Bpush.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-cape+flight" label: Wingsuit Hero Canyon Banked Run cover: seffect/superhero%2Beffect-cape%2Bflight.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-crystal+cave" label: Amber Crystal Cave Hero Awakening cover: seffect/superhero%2Beffect-crystal%2Bcave.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-steampunk+sky+mechanic" label: Steampunk Sky Mechanic Thunder Roc Power-Up cover: seffect/aura%2Bpowerup-steampunk%2Bsky%2Bmechanic.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-rocket+wingsuit+canyon" label: Rocket Wingsuit Storm Canyon Power-Up cover: seffect/aura%2Bpowerup-rocket%2Bwingsuit%2Bcanyon.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-nature+reclaim+city" label: Nature Reclamation City Power-Up cover: seffect/aura%2Bpowerup-nature%2Breclaim%2Bcity.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-crystal+tiny+dragon" label: Palm Crystal Tiny Dragon Summon cover: seffect/superhero%2Beffect-crystal%2Btiny%2Bdragon.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-cyberpunk+agent+skyscraper+jump" label: Cyberpunk Female Agent Skyscraper to Car Leap Powerup cover: seffect/aura%2Bpowerup-cyberpunk%2Bagent%2Bskyscraper%2Bjump.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-architectural+destruction+physics" label: Architectural Destruction Physics Superhero Mantle cover: seffect/superhero%2Beffect-architectural%2Bdestruction%2Bphysics.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-ladakh+anti+gravity+stones" label: Ladakh Shakti Stones Anti-Gravity Alternate-History Powerup cover: seffect/aura%2Bpowerup-ladakh%2Banti%2Bgravity%2Bstones.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-cyberpunk+samurai+sengoku" label: Cyberpunk Samurai Neon Sengoku Battlefield Aura cover: seffect/aura%2Bpowerup-cyberpunk%2Bsamurai%2Bsengoku.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-female+armor+assembly+flight" label: Female Armor Assembly Twilight Flight Powerup cover: seffect/aura%2Bpowerup-female%2Barmor%2Bassembly%2Bflight.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-armored+superheroine+stormy+rooftop" label: Armored Superheroine Transformation Stormy Futuristic Rooftop cover: seffect/aura%2Bpowerup-armored%2Bsuperheroine%2Bstormy%2Brooftop.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-dramatic+roar+awakening" label: Dramatic Awakening Roar Close-up Power-Up cover: seffect/aura%2Bpowerup-dramatic%2Broar%2Bawakening.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-giant+spirit+avatar+purple+lightning+gold" label: Giant Spirit Avatar Purple Lightning Power-Up cover: seffect/aura%2Bpowerup-giant%2Bspirit%2Bavatar%2Bpurple%2Blightning%2Bgold.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-celestial+goddess+summon" label: Celestial Goddess Summon cover: seffect/aura%2Bpowerup-celestial%2Bgoddess%2Bsummon.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-obsidian+throne+chains" label: Obsidian Throne Ascension cover: seffect/aura%2Bpowerup-obsidian%2Bthrone%2Bchains.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "character+reveal-starburst+kinetic+typography+duotone" label: Starburst Kinetic Typography Character Reveal Sequence cover: seffect/character%2Breveal-starburst%2Bkinetic%2Btypography%2Bduotone.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "aura+powerup-mythic+warrior+shockwave" label: Mythic Warrior Lightning Shockwave cover: seffect/aura%2Bpowerup-mythic%2Bwarrior%2Bshockwave.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "superhero+effect-mecha+angel+feather+descent" label: Mecha Angel Feather Descent Powerup cover: seffect/superhero%2Beffect-mecha%2Bangel%2Bfeather%2Bdescent.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - value: "divine+manifestation-fierce+aspect+behind+caster" label: Fierce Aspect Divine Projection Behind Caster cover: seffect/divine%2Bmanifestation-fierce%2Baspect%2Bbehind%2Bcaster.mp4 inputImageCount: 1 inputImageNote: Upload 1 human portrait photo. - name: videoMode label: Video Mode help: Required. Default Standard type: select default: std options: - value: "std" label: Standard - value: "pro" label: Pro - name: ratio label: ratio help: Required. Default 9:16 type: select default: 9:16 options: - value: "9:16" label: 9:16 - value: "16:9" label: 16:9 - value: "1:1" label: 1:1 - name: duration label: Duration help: Required. Default 5s type: select default: 5 options: - value: "5" label: 5s - value: "10" label: 10s - value: "15" label: 15s ## Model Parameter Inspires: - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/11.png - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/ai-portrait-daily-asian-woman.webp - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/ai-portrait-daily-white-man.webp - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/ai-portrait-daily-white-woman.webp - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/ai-portrait-professional-black-woman.webp ## 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/superhero-powers-effect" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputImage": "ai-portrait-daily-asian-woman.webp", "effectType": "aura+powerup-golden+saiyan+desert", "videoMode": "std", "ratio": "9:16", "duration": "5", "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.