## Basic tool info Model name: wiro/Instagram Pose Model description: Generate stylish Instagram-style poses with trendy angles, natural expressions, and modern aesthetic. Model cover: https://cdn.wiro.ai/uploads/models/wiro-instagram-pose-cover.webp Model categories: - persistent - compare-landscape - tool - nano-banana - wiroEntertainment - image-to-image - beautykit - fast-inference Model tags: - image-to-image Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/wiro/instagram-pose Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Model Inputs: - name: inputImage label: Input Image help: Provide an image file or an image URL. type: combinefileinput default: input-instagrampose-woman-1.jpg - name: effectType label: Effect Type help: type: selectwithcover default: instapose-winter-pose-winter-bloom options: - value: "instapose-instastory-street-portrait" label: Street Portrait - value: "instapose-instastory-motion-blur" label: Motion Blur - value: "instapose-instastory-pop-out" label: Pop Out - value: "instapose-skiing-snowboard-man" label: Snowboard Man - value: "instapose-skiing-snowboard-woman" label: Snowboard Woman - value: "instapose-skiing-snowboarder-woman" label: Snowboarder Woman - value: "instapose-skiing-snowboarder-man" label: Snowboarder Man - value: "instapose-skiing-skier-man" label: Skier Man - value: "instapose-skiing-skier-woman" label: Skier Woman - value: "instapose-skiing-athlete-woman" label: Athlete Woman - value: "instapose-skiing-mountain-rider" label: Mountain Rider - value: "instapose-skiing-gondola-fashion" label: Gondola Fashion - value: "instapose-instastory-sunset-glow" label: Sunset Glow - value: "instapose-winterstory-frost-woman" label: Frost Woman - value: "instapose-winterstory-glacier-man" label: Glacier Man - value: "instapose-winterstory-iceborn-woman" label: Iceborn Woman - value: "instapose-winterstory-polar-man" label: Polar Man - value: "instapose-winterstory-arctic-siren" label: Arctic Siren - value: "instapose-winterstory-snowbound-lovers" label: Snowbound Lovers - value: "instapose-winterstory-winter-devotion" label: Winter Devotion - value: "instapose-instastory-phantom-silhouette" label: Phantom Silhouette - value: "instapose-instastory-icy-capture" label: Icy Capture - value: "instapose-instastory-scarlet-vision" label: Scarlet Vision - value: "instapose-instastory-red-siren" label: Red Siren - value: "instapose-instastory-scarlet-muse" label: Scarlet Muse - value: "instapose-instastory-santa-couture" label: Santa Couture - value: "instapose-instastory-snow-bodysuit" label: Snow Bodysuit - value: "instapose-instastory-knitted-portrait" label: Knitted Portrait - value: "instapose-instastory-vintage-wealth" label: Vintage Wealth - value: "instapose-instastory-tennis-aesthetic" label: Tennis Aesthetic - value: "instapose-instastory-maternity-glow" label: Maternity Glow - value: "instapose-instastory-baby-generation" label: Baby Generation - value: "instapose-instastory-birthday-family" label: Birthday Family - value: "instapose-instastory-mono-woman" label: Mono Woman - value: "instapose-instastory-mono-man" label: Mono Man - value: "instapose-instastory-christmas-sweater" label: Christmas Sweater - value: "instapose-instastory-birthday-glam" label: Birthday Glam - value: "instapose-instastory-birthday-queen" label: Birthday Queen - value: "instapose-instastory-birthday-luxe" label: Birthday Luxe - value: "instapose-instastory-birthday-classic" label: Birthday Classic - value: "instapose-instastory-birthday-cool" label: Birthday Cool - value: "instapose-instastory-fremen-desert" label: Fremen Desert - value: "instapose-instastory-heavenly-angel" label: Heavenly Angel - value: "instapose-instastory-magic-forest" label: Magic Forest - value: "instapose-instastory-mortal-green" label: Mortal Green - value: "instapose-instastory-leopard-fashion" label: Leopard Fashion - value: "instapose-instastory-ornament-figurine" label: Ornament Figurine - value: "instapose-instastory-sakura-style" label: Sakura Style - value: "instapose-instastory-marble-statue" label: Marble Statue - value: "instapose-instastory-gta-world" label: GTA World - value: "instapose-instastory-mono-cool" label: Mono Cool - value: "instapose-instastory-mono-seated" label: Mono Seated - value: "instapose-instastory-mono-fashion" label: Mono Fashion - value: "instapose-instastory-mono-camera" label: Mono Camera - value: "instapose-sport-f1-mclaren-ignite" label: McLaren Ignite - value: "instapose-sport-f1-mclaren-horizon" label: McLaren Horizon - value: "instapose-sport-f1-redbull-fury" label: RedBull Fury - value: "instapose-sport-f1-redbull-focus" label: RedBull Focus - value: "instapose-sport-f1-paddock-champion" label: Paddock Champion - value: "instapose-sport-f1-ferrari-fury" label: Ferrari Fury - value: "instapose-sport-f1-helmet-honor" label: Helmet Honor - value: "instapose-instastory-ice-skating" label: Ice Skating - value: "instapose-instastory-frost-dance" label: Frost Dance - value: "instapose-instastory-woman-style" label: Winter Style - value: "instapose-instastory-woman-birthday" label: Birthday Party - value: "instapose-instastory-monochrome-man" label: Monochrome Man - value: "instapose-instastory-monochrome-woman" label: Monochrome Woman - value: "instapose-instastory-western-cowboy" label: Western Cowboy - value: "instapose-winter-pose-winter-bloom" label: Winter Bloom - value: "instapose-winter-pose-red-umbrella" label: Red Umbrella - value: "instapose-winter-pose-snowy-daydream" label: Snowy Daydream - value: "instapose-winter-pose-midnight-snow" label: Midnight Snow - value: "instapose-animal-pose-scarfed-cutie" label: Scarfed Cutie - value: "instapose-animal-pose-snowy-friend" label: Snowy Friend - value: "instapose-animal-pose-winter-whiskers" label: Winter Whiskers - value: "instapose-animal-pose-cozy-beanie" label: Cozy Beanie - value: "instapose-animal-withhuman-dalmatian-love" label: Dalmatian Love - value: "instapose-animal-withhuman-deer-love" label: Deer Love - value: "instapose-animal-withhuman-rabbit-love" label: Rabbit Love - value: "instapose-animal-withhuman-dachshund-love" label: Dachshund Love - value: "instapose-animal-withhuman-parrot-love" label: Parrot Love - value: "instapose-animal-withhuman-doberman-love" label: Doberman Love - value: "instapose-animal-withhuman-wolfdog-love" label: Wolfdog Love - value: "instapose-animal-withhuman-horse-love" label: Horse Love - value: "instapose-christmas-silent-lights" label: Silent Lights - value: "instapose-christmas-couch-victory" label: Couch Victory - value: "instapose-christmas-gift-wrap" label: Gift Wrap - value: "instapose-christmas-lights-defeated" label: Lights Defeated - value: "instapose-christmas-selfie-joy" label: Selfie Joy - value: "instapose-christmas-silent-prank" label: Silent Prank - value: "instapose-couple-winter-blossom" label: Winter Blossom - value: "instapose-couple-snowy-silence" label: Snowy Silence - value: "instapose-couple-midnight-bond" label: Midnight Bond - value: "instapose-couple-cold-embrace" label: Cold Embrace - value: "instapose-valentines-heart-rose" label: Heart Rose - value: "instapose-valentines-balloon-love" label: Balloon Love - value: "instapose-valentines-champagne-moment" label: Champagne Moment - value: "instapose-valentines-rose-garden" label: Rose Garden - value: "instapose-valentines-slow-dance" label: Slow Dance - value: "instapose-valentines-gift-moment" label: Gift Moment - value: "instapose-valentines-umbrella-hearts" label: Umbrella Hearts - value: "instapose-valentines-cookie-love" label: Cookie Love - value: "instapose-timetravel-timeless-evolution" label: Timeless Evolution - value: "instapose-timetravel-style-spectrum" label: Style Spectrum - value: "instapose-instastory-many-me" label: Many Me - value: "instapose-instastory-frame-me" label: Frame Me ## 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/instagram-pose" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputImage": "input-instagrampose-woman-1.jpg", "effectType": "instapose-winter-pose-winter-bloom", "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.