## Basic tool info Model name: PixVerse/image-to-video-v6 Model description: PixVerse Image to Video V6 animates a still image into a cinematic MP4 clip, with optional first-to-last frame transitions, multi-shot scenes, and audio. Model cover: https://cdn.wiro.ai/uploads/models/pixverse-image-to-video-v6-cover.mp4 Model categories: - tool - partner - PixVerse - text-to-video - nogpu-pipeline - image-to-video - quick-showcase Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/pixverse/image-to-video-v6 Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Model Inputs: - name: inputImage label: First Frame Image help: First frame (i2v) or first frame of transition. Leave empty for text-to-video. type: combinefileinput default: pixverse-image-to-video-v6-input-1.jpg - name: inputImageLast label: Last Frame Image help: Last frame of transition. Leave empty for i2v or t2v. type: combinefileinput default: - name: prompt label: Prompt help: Describe the video you want to generate. type: textarea default: The brown and white border collie turns and bolts forward, running and leaping playfully through the tall green grass. Dynamic low-angle tracking shot following the dog's fast motion. Realistic animal physics, fluid grass interaction. - name: duration label: Duration help: Duration of the video in seconds. type: select default: 5 options: - value: "5" label: 5 - value: "10" label: 10 - value: "15" label: 15 - name: quality label: Quality help: Quality of the video. type: select default: 540p options: - value: "360p" label: 360p (Turbo) - value: "540p" label: 540p - value: "720p" label: 720p - value: "1080p" label: 1080p - name: motionMode label: Motion Mode help: Only applies to image-to-video. Fast is limited to 5 seconds and does not support 1080p. type: select default: normal options: - value: "normal" label: Normal - value: "fast" label: Fast (5s only, no 1080p) - name: ratio label: Aspect Ratio help: Only applied for text-to-video. Ignored when an image is provided. type: select default: 16:9 options: - value: "16:9" label: 16:9 - value: "9:16" label: 9:16 - value: "1:1" label: 1:1 - value: "4:3" label: 4:3 - value: "3:4" label: 3:4 - value: "3:2" label: 3:2 - value: "2:3" label: 2:3 - value: "21:9" label: 21:9 - name: seed label: Seed help: Leave 0 to randomize. type: number default: 0 - name: audioSwitch label: Generate Audio help: Generate audio alongside the video. Increases credit cost. type: select default: false options: - value: "false" label: false - value: "true" label: true - name: multiClipSwitch label: Multi Clip help: Not supported for transition mode. type: select default: false options: - value: "false" label: false - value: "true" label: true ## Model Parameter Inspires: - prompt: A high-speed, low-flying POV perspective weaving rapidly through a dense cyberpunk alleyway. The camera zips between tight metallic fire escapes and glowing holographic advertisements. A dark, rain-slicked city corridor with neon pink and electric blue signs reflecting on wet asphalt, steam rising from ground grates. Extreme high-speed tracking shot with a wide-angle fisheye lens effect, executing sharp banking turns while maintaining perfect geometric stability of the surrounding architecture. Cyberpunk style, photorealistic textures, smooth motion blur, high sensory depth. - inputImage: - prompt: An elderly wizard with deep, realistic wrinkles and a long silver beard, wearing an embroidered velvet robe. He smiles warmly, his eyes twinkling, and speaks clearly with matching mouth-sync: 'The ancient magic is waking up.' He slowly raises a glowing crystalline staff. A dimly lit, atmospheric medieval library filled with ancient spellbooks and floating candles casting soft flickering shadows. Extreme close-up focusing on his facial expressions, slowly zooming out to a medium shot. Cinematic fantasy, realistic skin textures, volumetric lighting, rich color grading. - inputImage: - prompt: The brown and white border collie turns and bolts forward, running and leaping playfully through the tall green grass. Dynamic low-angle tracking shot following the dog's fast motion. Realistic animal physics, fluid grass interaction. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/pixverse-image-to-video-v6-input-1.jpg - prompt: The yellow tram moves smoothly forward along the tracks past the station platform. Cars with glowing headlights drive down the roads on either side. Realistic urban motion, dusk atmosphere, natural flickering on the digital information board. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/pixverse-image-to-video-v6-input-2.jpg ## 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/pixverse/image-to-video-v6" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputImage": "pixverse-image-to-video-v6-input-1.jpg", "inputImageLast": "", "prompt": "The brown and white border collie turns and bolts forward, running and leaping playfully through the tall green grass. Dynamic low-angle tracking shot following the dog's fast motion. Realistic animal physics, fluid grass interaction.", "duration": "5", "quality": "540p", "motionMode": "normal", "ratio": "16:9", "seed": 0, "audioSwitch": "false", "multiClipSwitch": "false", "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 with Task ID ```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 '{ "taskid": "2221" }'; ``` ## Get Task Detail - Make HTTP Post Request with Socket Access Token ```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 } ``` ## Kill Task - Make HTTP Post Request with Task ID ```bash curl -X POST "https://api.wiro.ai/v1/Task/Kill" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "534574" }'; ``` ## Kill Task - Make HTTP Post Request with Socket Access Token ```bash curl -X POST "https://api.wiro.ai/v1/Task/Kill" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE" }'; ``` ## Kill Task - Response ```json { "errors": [], "tasklist": [ { "id": "534574", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "name": "", "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE", "parameters": { "inputImage": "https://api.wiro.ai/v1/File/mCmUXgZLG1FNjjjwmbtPFr2LVJA112/inputImage-6060136.png" }, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_cancel", "cps": "0.000585000000", "totalcost": "0.003510000000", "guestid": null, "projectid": "699", "modelid": "598", "description": "", "basemodelid": "0", "runtype": "model", "modelfolderid": "", "modelfileid": "", "callbackurl": "", "marketplaceid": null, "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "pexit": "0", "categories": "["tool","image-to-image","quick-showcase","compare-landscape"]", "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", "foldercount": "0", "filecount": "0", "ispublic": 0, "expiretime": null, "url": "https://cdn1.wiro.ai/6a6af820-c5050aee-40bd7b83-a2e186c6-7f61f7da-3894e49c-fc0eeb66-9b500fe2/0.png" } ], "size": "202472" } ], "result": true } ``` ## Cancel Task - Make HTTP Post Request (For tasks on queue) ```bash curl -X POST "https://api.wiro.ai/v1/Task/Cancel" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "taskid": "634574" }'; ``` ## Cancel Task - Response ```json { "errors": [], "tasklist": [ { "id": "634574", "uuid": "15bce51f-442f-4f44-a71d-13c6374a62bd", "name": "", "socketaccesstoken": "ZpYote30on42O4jjHXNiKmrWAZqbRE", "parameters": { "inputImage": "https://api.wiro.ai/v1/File/mCmUXgZLG1FNjjjwmbtPFr2LVJA112/inputImage-6060136.png" }, "debugoutput": "", "debugerror": "", "starttime": "1734513809", "endtime": "1734513813", "elapsedseconds": "6.0000", "status": "task_cancel", "cps": "0.000585000000", "totalcost": "0.003510000000", "guestid": null, "projectid": "699", "modelid": "598", "description": "", "basemodelid": "0", "runtype": "model", "modelfolderid": "", "modelfileid": "", "callbackurl": "", "marketplaceid": null, "createtime": "1734513807", "canceltime": "0", "assigntime": "1734513807", "accepttime": "1734513807", "preprocessstarttime": "1734513807", "preprocessendtime": "1734513807", "postprocessstarttime": "1734513813", "postprocessendtime": "1734513814", "pexit": "0", "categories": "["tool","image-to-image","quick-showcase","compare-landscape"]", "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", "foldercount": "0", "filecount": "0", "ispublic": 0, "expiretime": null, "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.