## Basic tool info Tool name: StableDiffusionVN/SDVN3-RealArt Tool description: SDVN3-RealArt Tool cover: https://cdn.wiro.ai/uploads/models/StableDiffusionVN-SDVN3-RealArt-cover.jpeg Tool categories: - model - sd - text-to-image - checkpoint-file - fp16 - persistent Tool tags: - art - portrait - style - paint - fantasy - girls - sketch - fanart - sdvn Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/StableDiffusionVN/SDVN3-RealArt Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: prompt label: prompt help: prompt-help type: textarea default: (RAW photo,8k uhd, Analog style, Masterpiece, Best Quality, Highres:1.4), (dramatic, cinematic:1.2), BREAK,movie shot of colorful hyperdetailed fantastic fantasy mysterious magic landscape, above clouds, (medieval elven fantasy (village:1.35), (steampunk:1.05) (peasant:1.15) (robots:1.1) (crowd:1.35), playing (little steampunk (girl:1.25):1.1), (farm:1.31), (lake, (river:1.14):1.15), (bridges:1.4), (waterfalls:1.35), (boat:1.4), (dock:1.1), (cliff:1.35), road, (green:1.05) valley, (flowers:1.2), (maple trees:0.65), (green:1.05) (fields:1.3), (fences:1.3), (snowy:1.17) (pines:1.1), (pink:1.0) (flowering tree:1.12):1.22), BREAK,((mountains:1.22), (futuristic:1.15) (overgrown:1.27) (skyscrapers:1.53) (ruins:1.35), (market, water wheel, castle:1.14), (colorful houses:1.2), birds, stairs, spaceport, ((bright morning sun daylight:1.05) rainbow pure (blue:1.05) sky, glowing:1.05), starry, crescent, meteor, ((fluffy cloud:1.2), godrays, light particles:1.05), various seasons, steam, smokes:1.2), BREAK,(photorealistic:1.2), (intricate:1.3), (light theme:1.3), (inspiring joyful atmosphere:1.2), (fabulous, fantasy, mysterious, science fiction, post-apocalypse, incredible, amazing, happy, sunny, pastoral:1.2), (hyperdetailed, absurdres:1.2), (colorful, saturated:1.4), colorful lighting, BREAK - name: negativePrompt label: negativeprompt help: negativeprompt-help type: textarea default: ng_deepnegative_v1_75t, easynegative, BREAK,(Low Quality, Worst Quality, Lowres:1.4), semi-realistic, cgi, 3d, render, sketch, cartoon, drawing, anime, (blurry background, blurry:1.4), - name: samples label: numberofoutputs help: numberofoutputs-help type: number default: 4 - name: steps label: inferencesteps help: inferencesteps-help type: number default: 20 - name: scale label: guidancescale help: guidancescale-help type: float default: 7 - 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 ## 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/StableDiffusionVN/SDVN3-RealArt" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "prompt": "(RAW photo,8k uhd, Analog style, Masterpiece, Best Quality, Highres:1.4), (dramatic, cinematic:1.2), BREAK,movie shot of colorful hyperdetailed fantastic fantasy mysterious magic landscape, above clouds, (medieval elven fantasy (village:1.35), (steampunk:1.05) (peasant:1.15) (robots:1.1) (crowd:1.35), playing (little steampunk (girl:1.25):1.1), (farm:1.31), (lake, (river:1.14):1.15), (bridges:1.4), (waterfalls:1.35), (boat:1.4), (dock:1.1), (cliff:1.35), road, (green:1.05) valley, (flowers:1.2), (maple trees:0.65), (green:1.05) (fields:1.3), (fences:1.3), (snowy:1.17) (pines:1.1), (pink:1.0) (flowering tree:1.12):1.22), BREAK,((mountains:1.22), (futuristic:1.15) (overgrown:1.27) (skyscrapers:1.53) (ruins:1.35), (market, water wheel, castle:1.14), (colorful houses:1.2), birds, stairs, spaceport, ((bright morning sun daylight:1.05) rainbow pure (blue:1.05) sky, glowing:1.05), starry, crescent, meteor, ((fluffy cloud:1.2), godrays, light particles:1.05), various seasons, steam, smokes:1.2), BREAK,(photorealistic:1.2), (intricate:1.3), (light theme:1.3), (inspiring joyful atmosphere:1.2), (fabulous, fantasy, mysterious, science fiction, post-apocalypse, incredible, amazing, happy, sunny, pastoral:1.2), (hyperdetailed, absurdres:1.2), (colorful, saturated:1.4), colorful lighting, BREAK", "negativePrompt": "ng_deepnegative_v1_75t, easynegative, BREAK,(Low Quality, Worst Quality, Lowres:1.4), semi-realistic, cgi, 3d, render, sketch, cartoon, drawing, anime, (blurry background, blurry:1.4),", "samples": 4, "steps": 20, "scale": "7", "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.