## Basic tool info Tool name: PixVerse/image-to-video-v5 Tool description: PixVerse image-to-video model v5 Tool cover: https://cdn.wiro.ai/uploads/models/PixVerse-image-to-video-v5-cover.mp4 Tool categories: - tool - image-to-video - partner - PixVerse - compare-landscape Tool tags: - video generator Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/PixVerse/image-to-video-v5 Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Tool Inputs: - name: inputImageUrl label: Image URL help: First frame of the video type: text default: - name: prompt label: prompt help: The prompt to generate the video. type: textarea default: Animate the Louvre scene with realistic effects: flare smoke rising and drifting gently behind the building, jets flying overhead with subtle motion blur, and a minimal, realistic crowd slowly moving across the bottom of the image. Maintain the original photo’s sharpness and lighting, blending all animated elements seamlessly into the scene. - name: negativePrompt label: Negative Prompt help: Specify what to exclude from the output. type: textarea default: Unrealistic jets - name: duration label: Duration help: Duration of the video. type: select default: 5 options: - value: "5" label: 5 - value: "8" label: 8 - 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: style label: Style help: You can leave style empty. type: select default: options: - value: "anime" label: anime - value: "3d_animation" label: 3d_animation - value: "clay" label: clay - value: "comic" label: comic - value: "cyberpunk" label: cyberpunk - name: seed label: seed help: Leave null to randomize type: number default: 0 - name: Watermark label: Watermark help: type: select default: false options: - value: "false" label: false - value: "true" label: true ## Tool Parameter Inspires: - prompt: Animate the Louvre scene with realistic effects: flare smoke rising and drifting gently behind the building, jets flying overhead with subtle motion blur, and a minimal, realistic crowd slowly moving across the bottom of the image. Maintain the original photo’s sharpness and lighting, blending all animated elements seamlessly into the scene. - negativePrompt: Unrealistic jets - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/pixverse_image_to_video_v5_input_1.jpg - prompt: Animate the scene by adding an off-road vehicle approaching along the road, viewed from behind. Show the vehicle moving slowly forward, with realistic wheel motion, dust and tire tracks forming on the road, and natural lighting reflecting off the vehicle’s surfaces. Keep the rest of the scene intact, blending the car seamlessly into the environment. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/pixverse_image_to_video_v5_input_2.jpg - prompt: Animate the car moving slowly through snowy weather, visible from the side mirror. Show the mirror reflecting the motion of the snowy landscape passing by, with snowflakes drifting and accumulating on the mirror and car surfaces. Add realistic light reflections, subtle wind effects, and maintain the sharpness and details of the car and mirror. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/pixverse_image_to_video_v5_input_3.jpg - prompt: Animate the castle scene with a dynamic drone-style camera movement circling around it. Make the surrounding trees sway naturally in the wind, add realistic details like birds flying, subtle clouds drifting, and sunlight casting moving shadows across the castle walls. Ensure all motion is smooth and integrated, preserving the original scene’s textures and realism. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/pixverse_image_to_video_v5_input_4.jpg - prompt: Animate the city view seen through steel bars by transforming day into night in a timelapse. Gradually shift the sky from daylight to twilight and then to night, adjusting shadows and artificial lights on buildings, streets, and windows to match the time of day. Add subtle moving clouds, streetlights turning on, and reflections in windows to enhance realism, while keeping the steel bars sharp in the foreground. - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/pixverse_image_to_video_v5_input_5.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-v5" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputImageUrl": "pixverse_image_to_video_v5_input_1.jpg", "prompt": "Animate the Louvre scene with realistic effects: flare smoke rising and drifting gently behind the building, jets flying overhead with subtle motion blur, and a minimal, realistic crowd slowly moving across the bottom of the image. Maintain the original photo’s sharpness and lighting, blending all animated elements seamlessly into the scene.", "negativePrompt": "Unrealistic jets", "duration": "5", "quality": "540p", "style": "", "seed": 0, "Watermark": "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.