## Basic tool info Tool name: wiro/ultra_pixel Tool description: UltraPixel is designed to create exceptionally high-quality, detail-rich images at various resolutions, pushing the boundaries of ultra-high-resolution image synthesis. Tool cover: https://cdn.wiro.ai/uploads/models/wiro-ultra_pixel-cover.png Tool categories: - tool - text-to-image - quick-showcase - compare-landscape Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/wiro/ultra_pixel Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: prompt label: prompt help: prompt-help type: textarea default: fisheye effect circular composition oil painting, central close-up of a girl's face with large eyes, girl's voluminous brown curly hair swirls upwards as if windswept, bright sky blue irises wide open, conveying a surprised expression, skin is soft and pale with a slight blush on the cheeks, girl wears a blue striped top, background features swirling brush strokes blending blue, white, and yellow harmoniously, overall style emphasizes soft color transitions and textured brush strokes for a classic oil painting feel, contrast of light and shadow enhances dimensionality with particular focus on the details of the eyes and hair - name: width label: width help: width-help type: number default: 1024 - name: height label: height help: height-help type: number default: 2048 - name: samples label: numberofoutputs help: numberofoutputs-help type: number default: 1 - name: steps label: inferencesteps help: inferencesteps-help type: number default: 30 - name: scale label: guidancescale help: guidancescale-help type: float default: 7 - name: seed label: seed help: seed-help type: text default: 123456 ## Tool Parameter Inspires: - prompt: A pirate ship with black sails, viewed at close quarters in the caribbean sea, during a fierce sea storm, with crashing waves and a stormy sky. Hyperdetailed photorealistic image, highest quality - prompt: Magnificent waterfall falling into an immense, very deep natural rock basin filled with crystal clear water, in a setting of an exuberant equatorial forest invaded by vegetation, split shot, half underwater, shiny fishes swimming among algae and aquatic plants. One piranha in the foreground - prompt: Cinematic photo, elusive snow leopard, heartfelt love, affectionate, sweltering heat, shimmering air, unique and personal style, side-swept bangs, alabaster skin, serious and contemplative stance, pentax K-1, 24-70mm f2.8, rainy day mood, majestic mountains in the distance, fluffy and voluminous, determined and focused expression, ultrares, intricate details:1.12, highly detailed photo:1.1, vivid color, hdr masterpiece, natural skin texture, soft light, sharp:1.2, hyperrealism, by David Bailey - prompt: amalfi coast, oil painting, impressionist style, sunny day, colorful buildings and domes overlooking the sea with sailboats in background, lush greenery on cliffs, vibrant colors, detailed brushstrokes, textured canvas effect, impressionistic technique, high resolution - prompt: fisheye effect circular composition oil painting, central close-up of a girl's face with large eyes, girl's voluminous brown curly hair swirls upwards as if windswept, bright sky blue irises wide open, conveying a surprised expression, skin is soft and pale with a slight blush on the cheeks, girl wears a blue striped top, background features swirling brush strokes blending blue, white, and yellow harmoniously, overall style emphasizes soft color transitions and textured brush strokes for a classic oil painting feel, contrast of light and shadow enhances dimensionality with particular focus on the details of the eyes and hair ## 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/ultra_pixel" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "prompt": "fisheye effect circular composition oil painting, central close-up of a girl's face with large eyes, girl's voluminous brown curly hair swirls upwards as if windswept, bright sky blue irises wide open, conveying a surprised expression, skin is soft and pale with a slight blush on the cheeks, girl wears a blue striped top, background features swirling brush strokes blending blue, white, and yellow harmoniously, overall style emphasizes soft color transitions and textured brush strokes for a classic oil painting feel, contrast of light and shadow enhances dimensionality with particular focus on the details of the eyes and hair", "width": 1024, "height": 2048, "samples": 1, "steps": 30, "scale": "7", "seed": "123456", "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.