## Basic tool info Tool name: ArsMachina/3D-Fairytales-v1 Tool description: 3D Fairytales v1 Tool cover: https://cdn.wiro.ai/uploads/models/ArsMachina-3D-Fairytales-v1-cover.jpeg Tool categories: - model - text-to-image - checkpoint-file - lora-flux - bf16 - persistent Tool tags: - disney - style - laika - 3d animation - dreamwork Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/ArsMachina/3D-Fairytales-v1 Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: prompt label: prompt help: prompt-help type: textarea default: 3D Fairytales, The image shows a woman with long red hair wearing a black dress standing in front of a blurred background. Her face is clearly visible with her eyes looking directly at the viewer., 1girl, solo, red hair, jewelry, dress, long hair, earrings, makeup, breasts, floating hair - name: samples label: numberofoutputs help: numberofoutputs-help type: number default: 1 - name: steps label: inferencesteps help: inferencesteps-help type: number default: 20 - name: scale label: guidancescale help: guidancescale-help type: float default: 3.4 - name: seed label: seed help: seed-help type: text default: 13352031 - name: width label: width help: width-help type: number default: 1024 - name: height label: height help: height-help type: number default: 1024 ## Tool Parameter Inspires: - steps: 20 - scale: 3.4 - prompt: 3D Fairytales, The image shows a woman with long red hair wearing a black dress standing in front of a blurred background. Her face is clearly visible with her eyes looking directly at the viewer., 1girl, solo, red hair, jewelry, dress, long hair, earrings, makeup, breasts, floating hair - seed: 13352031 - steps: 30 - scale: 7.5 - prompt: 3D Fairytales, The image shows a woman with blonde hair and blue eyes wearing a red dress set against a dark background. Her face is animated giving the image a dynamic feel., 1girl, solo, blue eyes, eyelashes, makeup, looking at viewer, freckles, glowing, lips, blonde hair - steps: 30 - scale: 7.5 - prompt: 3D Fairytales, Full Body Portrait - steps: 30 - scale: 7.5 - prompt: 3D Fairytales, Landscape - steps: 20 - scale: 3.4 - prompt: 3D animated fairytale style meets romantic realism, large expressive eyes, soft facial features, hyper-detailed hair, golden hour lighting, warm bokeh background, inspired by Disney, Laika, and DreamWorks - seed: 13352031 - steps: 20 - scale: 3.4 - prompt: 3D Fairytales, The image shows a woman with blonde hair and blue eyes wearing a red dress set against a dark background. Her face is animated giving the image a dynamic feel., 1girl, solo, blue eyes, eyelashes, makeup, looking at viewer, freckles, glowing, lips, blonde hair - seed: 13352031 - steps: 20 - scale: 3.4 - prompt: 3D Fairytales, The image shows a woman with blue eyes and a black cat sitting on her lap. She has a human face and is wearing a necklace., 1girl, cat, jewelry, looking at viewer, black cat, animal, freckles, necklace, solo, bare shoulders - seed: 13352031 - steps: 20 - scale: 3.4 - prompt: 3D Fairytales, The image shows a girl with long black hair and green eyes wearing a red dress with a heart-shaped object in her hand against a blurred background., 1girl, solo, earrings, heart, braid, jewelry, looking at viewer, heart earrings, long hair, portrait - seed: 13352031 - steps: 20 - scale: 3.4 - prompt: 3D Fairytales, Portrait - seed: 13352031 - steps: 20 - scale: 3.4 - prompt: 3D Fairytales, Landscape - seed: 13352031 - steps: 20 - scale: 3.4 - prompt: 3D Fairytales, The image shows a man and woman in a black and blue dress standing next to each other with a few other people in the background. The man is wearing a black blazer and the woman is wearing an unknown outfit. The background is slightly blurred giving the image an animated feel., dress, dancing, flower, 1girl, makeup, hair flower, jewelry, hair ornament, smile, blurry - seed: 13352031 - steps: 20 - scale: 3.5 - prompt: The image depicts a cartoon-style elephant with exaggerated features such as large, round ears and a big, expressive green eye. The elephant has a fluffy, textured appearance with a grayish-brown color palette. It is holding a bright red mushroom in its trunk, which is raised slightly as if presenting it. The background is a gradient of light blue and white, giving a soft, dreamy effect. The elephant appears to be standing on all fours, and its posture suggests curiosity or surprise. The overall scene has a playful and whimsical tone. - seed: 38228293 - steps: 20 - scale: 1 - prompt: Boris Vallejo,A black raven with 6 red eyes looking at viewer,standing on skull, black feather, on medieval battlefield with corpses. - seed: 2480068643 - steps: 20 - scale: 1 - prompt: Boris Vallejo,A black raven with 6 red eyes looking at viewer,standing on skull, black feather, on medieval battlefield with corpses. - seed: 1468156236 - steps: 20 - scale: 1 - prompt: Boris Vallejo,A black raven with 6 red eyes looking at viewer,standing on skull, black feather, on medieval battlefield with corpses. - seed: 2946390022 ## 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/ArsMachina/3D-Fairytales-v1" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "prompt": "3D Fairytales, The image shows a woman with long red hair wearing a black dress standing in front of a blurred background. Her face is clearly visible with her eyes looking directly at the viewer., 1girl, solo, red hair, jewelry, dress, long hair, earrings, makeup, breasts, floating hair", "samples": 1, "steps": 20, "scale": "3.4", "seed": "13352031", "width": 1024, "height": 1024, "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.