## Basic tool info Tool name: wiro/hunyuan_video Tool description: HunyuanVideo is an advanced video generation tool capable of producing high-quality, precise, and visually compelling videos. Tool cover: https://cdn.wiro.ai/uploads/models/wiro-hunyuan_video-cover.mp4 Tool categories: - tool - text-to-video - quick-showcase Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/wiro/hunyuan_video Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: prompt label: prompt help: prompt-help type: textarea default: a cat walks on the grass, realistic style - name: negativePrompt label: negativeprompt help: negativeprompt-help type: textarea default: - name: scale label: guidancescale help: guidancescale-help type: float default: 1.0 - name: embeddedScale label: embedded_guidance_scale help: guidancescale-help type: float default: 6.0 - name: videoLength label: videoLength help: If N is divisible by 4, the video length should be N+1. type: number default: 65 - name: size label: size help: type: select default: 624x832 options: - value: "544x960" label: Ratio: 9:16 | 544 x 960 - value: "960x544" label: Ratio: 16:9 | 960x544 - value: "624x832" label: Ratio: 3:4 | 624 x 832 - value: "832x624" label: Ratio: 4:3 | 832 x 624 - value: "720x720" label: Ratio: 1:1 | 720 x 720 - name: steps label: inferencesteps help: inferencesteps-help type: number default: 50 - name: seed label: seed help: seed-help type: text default: 123456 ## Tool Parameter Inspires: - steps: 50 - scale: 1.0 - prompt: a cat walks on the grass, realistic style - seed: 123456 - steps: 50 - scale: 1.0 - prompt: a close-up of a young girl in a red hoodie captures her striking a match on a cold winter night. The sky is deep and dark, while fresh snow blankets the ground, with delicate flakes still drifting down. The tiny flame flickers, casting a warm, fleeting glow on her face as she watches it intently - seed: 123456 - steps: 50 - scale: 1.0 - prompt: a neon-lit cityscape hums with energy as a lone figure ignites a holographic match. The tiny flame glows electric blue, reflecting in their cybernetic eye. Hovering cars zoom past, their taillights streaking across the rainy streets. Steam rises from sewer grates, blending with the falling drizzle, creating an otherworldly, dreamlike haze - seed: 123456 - steps: 50 - scale: 1.0 - prompt: raindrops slide down a fogged-up window as distant city lights blur into soft streaks of color. A warm cup of tea rests on the windowsill, its steam curling upward. The low hum of traffic and the occasional roll of thunder create a peaceful, moody atmosphere - seed: 123456 ## 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/hunyuan_video" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "prompt": "a cat walks on the grass, realistic style", "negativePrompt": "", "scale": "1.0", "embeddedScale": "6.0", "videoLength": 65, "size": "624x832", "steps": 50, "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.