## Basic tool info Model name: wiro/Store Image Generator Model description: Store Image Generator Model cover: https://cdn.wiro.ai/uploads/models/wiro-store-image-generator-cover.webp Model categories: - tool - image-to-image - use-agent - image-editing Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/wiro/store-image-generator Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Model Inputs: - name: inputImages label: Screenshots help: The generation process requires a minimum input of 3 images. Input sets containing fewer than 3 images will trigger an error, and any inputs beyond the fourth image will be disregarded. type: combinefileinput default: - name: description label: Description help: Provide a description or context for the image generation. type: textarea default: - name: platform label: Platform help: Select the store platform for your app screenshots. type: select default: Apple App Store options: - value: "Apple App Store" label: Apple App Store - value: "Google Play Store" label: Google Play Store - name: phone label: Device Type help: Select the device type for image sizing. type: select default: iPhone options: - value: "iPhone" label: iPhone - value: "Android" label: Android - name: color label: Background Color help: Background color of the images. Auto by default type: select default: options: - value: "" label: Auto - value: "#A6E1F9,#4BC7CE" label: Light Blue Gradients - value: "#4582c0,#6e3b88" label: Blue Purple Gradients - value: "#c9a7c7,#BDC4E3" label: Light Purple Gradients - value: "#FFFFFF,#F5F2E8" label: White Gradient - value: "#FFDA8F,#fdb300" label: Yellow Gradient - value: "#18181D,#000000" label: Black Gradient - value: "#A5ACAF,#5C5C5C" label: Gray Gradient - value: "#A17530,#703F00" label: Brown Gradient - value: "#a684a7,#550f75" label: Purple Gradient - value: "#fdb300,#bb972b" label: Gold Gradient - value: "#c4a8ff,#acadb1" label: Silver Gradient - value: "#fa9bcb,#E46FB1" label: Pink Gradient - value: "#a179a5,#6e3b88" label: Violet Gradient - value: "#4582c0,#0047ab" label: Blue Gradient - value: "#7ecaab,#028553" label: Green Gradient - value: "#e60026,#a70104" label: Red Gradient - value: "#ff9c40,#df8d04" label: Orange Gradient - value: "#000000,#FFFFFF" label: Black and White Gradient - value: "#000000,#0047aa" label: Black and Blue Gradient - value: "#4582c0,#FFFFFF" label: Blue White Gradients - value: "#18181D,#332642" label: Dark Gradient - value: "#e60026,#4582c0" label: Rainbow Gradient - value: "#7ecaab,#4582c0" label: Green Blue Gradient - value: "#e60026,#ff9c40" label: Red Orange - value: "#fdb300,#e60026" label: Yellow Red - value: "#028553,#e60026" label: Christmas - value: "#212e20,#028553" label: Dark Green Gradient - value: "#2d8a7f,#72c9ef" label: Ocean Gradient - value: "#000000,#e60026" label: Black and Red Gradient - value: "#660000,#94373e" label: Maroon Gradient - value: "#19ccb1,#0a6400" label: Teal Gradient - value: "#ff9c40,#a70104" label: Sunset Gradient - value: "#f6bcd2,#cbfff8" label: Pastel Gradient - value: "#4582c0,#fdb300" label: Blue Yellow Gradient - value: "#e60026,#FFFFFF" label: Red and White Gradient - value: "#acadb1,#5C5C5C" label: Metal Gradient - value: "#f6bcd2,#fcc9bc" label: Light Pink Gradient - value: "#332642,#6e3b88" label: Dark Purple Gradient - value: "#edd5fd,#c9a7c7" label: Lavender Gradient - value: "#fa9bcb,#4582c0" label: Pink Blue Gradient - value: "#f6bcd2,#fcc9bc" label: Pastel Pink Gradient - value: "#fdb300,#e60026" label: Flame Gradient - value: "#fa9bcb,#6e3b88" label: Pink Purple Gradient - value: "#e60026,#4582c0" label: Red White and Blue Gradient - value: "#19ccb1,#72c9ef" label: Cyan Gradient - value: "#8cb14d,#6b564a" label: Natural Gradient - value: "#ffdaab,#8f5624" label: Skin Color Gradient - value: "#b1d41d,#7ecaab" label: Light Green Gradient - value: "#012e5d,#4582c0" label: Navy Blue - value: "#72c9ef,#DCEFF4" label: Sky Gradients - name: font label: Font help: type: select default: Roboto options: - value: "Roboto" label: Roboto - value: "Open Sans" label: Open Sans - value: "Lato" label: Lato - value: "Montserrat" label: Montserrat - value: "Inter" label: Inter - value: "Poppins" label: Poppins - value: "Roboto Condensed" label: Roboto Condensed - value: "Roboto Mono" label: Roboto Mono - value: "Arimo" label: Arimo - value: "Oswald" label: Oswald - value: "Noto Sans" label: Noto Sans - value: "Raleway" label: Raleway - value: "Nunito Sans" label: Nunito Sans - value: "Nunito" label: Nunito - value: "Playfair Display" label: Playfair Display - value: "Ubuntu" label: Ubuntu - value: "Rubik" label: Rubik - value: "Roboto Slab" label: Roboto Slab - name: fontColor label: Font Color help: Please enter a hex colour code. type: textarea default: ## 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/store-image-generator" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputImages": "", "description": "", "platform": "Apple App Store", "phone": "iPhone", "color": "", "font": "Roboto", "fontColor": "", "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.