## Basic tool info Tool name: plasmo/vox2 Tool description: 3D pixel art, Jak's Voxel-ish Image Pack v.1.2 for Stable Diffusion Tool cover: https://cdn.wiro.ai/uploads/models/plasmo-vox2-cover.jpg Tool categories: - model - sd - text-to-image - checkpoint-folder - fp32 - persistent Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/plasmo/vox2 Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: prompt label: prompt help: prompt-help type: textarea default: voxel-ish, portrait of Bill Gates, intricate detail - name: negativePrompt label: negativeprompt help: negativeprompt-help type: textarea default: - name: samples label: numberofoutputs help: numberofoutputs-help type: number default: 4 - name: steps label: inferencesteps help: inferencesteps-help type: number default: 30 - name: scale label: guidancescale help: guidancescale-help type: float default: 7.5 - name: seed label: seed help: seed-help type: text default: 123456 - name: clipSkip label: clip-skip help: clip-skip-help type: number default: 4 - name: width label: width help: width-help type: number default: 512 - name: height label: height help: height-help type: number default: 512 - name: scheduler label: scheduler help: scheduler-help type: select default: EulerDiscreteScheduler options: - value: "EulerDiscreteScheduler" label: EulerDiscreteScheduler - value: "DDIMScheduler" label: DDIMScheduler - value: "LMSDiscreteScheduler" label: LMSDiscreteScheduler - value: "DPMSolverMultistepScheduler" label: DPMSolverMultistepScheduler - value: "EulerDiscreteScheduler" label: EulerDiscreteScheduler - value: "PNDMScheduler" label: PNDMScheduler - value: "DDPMScheduler" label: DDPMScheduler - value: "EulerAncestralDiscreteScheduler" label: EulerAncestralDiscreteScheduler ## Tool Parameter Inspires: - prompt: voxel-ish, portrait of Mustafa Kemal Ataturk, intricate detail - negativePrompt: color - prompt: voxel-ish, portrait of Bill Gates, intricate detail - negativePrompt: - prompt: voxel-ish, picture of a shiny blue car, intricate detail - negativePrompt: - prompt: voxel-ish, cute pastel yellow cate with long white whiskers, intricate detail - negativePrompt: bright yellow, bright colors, dark colors - prompt: voxel-ish,high cliff near the ocean, sunset, orange tones, yellow tones. nature, intricate detail - negativePrompt: - prompt: voxel-ish, whimsical adorable character design 3d octane render, wide shot, chibi extremely cute tiny duck going on adventure in the rain, beautiful scenery, wisteria flowers, spring time, red rain boots, big eyes, award winning, hypermaximalist, octane render, cinematic lighting, detailed --s 1000 --chaos 30 - negativePrompt: - prompt: voxel-ish, portrait of cute Japanese school girl in school uniform looking up in the sky, green eyes, side profile, reflection in eyes, intricate detail, pastel tones - negativePrompt: bright colors, dark colors - prompt: voxel-ish, A beautiful demon girl. Slender body. Fill body. Beautiful symmetrical demon horns. Demon wings. Elegant clothes. A beautiful face. A fantastic face. Beautiful eyes. Fantastic eyes. Symmetrical eyes. Ultra detailed. Lots of details. High resolution. A masterpiece., intricate detail - negativePrompt: Smeared face. fuzzy picture. bad anatomy, ugly, badly drawn, broken arms, mutated, mutilated, mutation, deformation, 6 fingers, 7 fingers, 4 fingers, extra fingers, extra arm, extra leg, extra limbs. bad eyes. Poor picture quality. Blurred picture. Smeared eyes. Dick. Not clear eyes. 1 leg. 3 legs. Defective legs. Defective face. Poor face quality. Extra legs and arms. Extra fingers. Crooked eyes. Smudged eyes. Artifact jpeg. Shumy. Watermark. NSFW. - prompt: voxel-ish, (Masterpiece, Award winning , Best Quality:1. 2), (ultra detailed), (highres), production art, 1girl, red eyes, detailed face, long hair, solo, flower, necktie, black hair, red necktie, shirt, looking at viewer, belt, white shirt, black vest, hair between eyes, collared shirt, floating hair, vest, bangs, closed mouth, full body, long sleeves, building, red flower, blue flower, petals, outdoors, night, star (sky), (full moon:1. 2) , , 16k, UHD, HDR, (Masterpiece:1. 5), (best quality:1. 5), intricate detail - negativePrompt: (worst quality, low quality:1.3), (blurry:1.2), deformed iris, deformed pupils, bad eyes, cross eyed,(poorly drawn face), cloned face, extra fingers, mutated hands, (fused fingers), (too many fingers), (missing arms), (missing legs), (extra arms), (extra legs), (poorly drawn hands), (bad anatomy), (bad proportions), cropped, lowres, text, jpeg artifacts, signature, watermark, username, artist name, trademark, watermark, title, multiple view, Reference sheet, long neck, Out of Frame,(Naked, Nude, NSFW, Erotica:2.0) - prompt: voxel-ish, space girl| standing alone on hill| centered| detailed gorgeous face| anime style| key visual| intricate detail| highly detailed| breathtaking| vibrant| panoramic| cinematic| Carne Griffiths| Conrad Roset| ghibli, intricate detail - negativePrompt: - prompt: voxel-ish, a city with tall buildings set in cyberpunk 2077 where a blonde girl stares at the buildings holding a red plasma sword in her right hand, intricate detail - negativePrompt: - prompt: voxel-ish, Elysium, dreamlike, A perfect paradise, intricate detail - negativePrompt: - prompt: voxel-ish, Wonder Woman Dress up, Delicate Smooth female, bust Portrait, Asian actress face, super Clear facial details, elegant, realistic: 1, Perspective, highly detailed, digital painting, art station, concept art, Smooth, Sharp focus, illustration, 8k, intricate detail - negativePrompt: ## 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/plasmo/vox2" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "prompt": "voxel-ish, portrait of Bill Gates, intricate detail", "negativePrompt": "", "samples": 4, "steps": 30, "scale": "7.5", "seed": "123456", "clipSkip": 4, "width": 512, "height": 512, "scheduler": "EulerDiscreteScheduler", "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 ```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 } ``` ## 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.