## Basic tool info Model name: alibaba/wan 2.7 Model description: Generate videos from text prompts using Alibaba's WAN 2.7 model. Supports both text-to-video and image-to-video conversion with customizable duration and resolution. Model cover: https://cdn.wiro.ai/uploads/models/alibaba-wan-2-7-cover.mp4 Model categories: - tool - partner - text-to-video - image-to-video - alibaba - nogpu-pipeline - hero-showcase Model tags: - video generator - alibaba Run Task Endpoint (POST): https://api.wiro.ai/v1/Run/alibaba/wan-2-7 Get Task Detail Endpoint (POST): https://api.wiro.ai/v1/Task/Detail ## Model Inputs: - name: inputImage label: Image (First Frame) help: Optional. First frame image for i2v. If not provided, model runs as t2v. Formats: JPEG, JPG, PNG, WEBP. Resolution: 240-8000px. Max 20 MB. type: combinefileinput default: alibaba-wan-2-7-input-2.jpg - name: prompt label: prompt help: Required. Describes the elements and visual characteristics for the generated video. Up to 5,000 characters. type: textarea default: The scene comes alive with a gentle breeze. The calm green water begins to ripple naturally, softly distorting the crisp reflections of the brightly colored buildings. The moored boats gently bob up and down against their wooden poles, creating small, realistic wakes. On the left, the man in the foreground casually walks forward a few steps while looking around. The camera executes a very slow, stable push-in straight down the center of the canal. - name: negativePrompt label: Negative Prompt help: Optional. Specify what to exclude from the output. Up to 500 characters. type: textarea default: - name: inputAudio label: Audio help: Optional. Driving audio for i2v or background audio for t2v. If not provided, model auto-generates audio. Formats: WAV, MP3. Duration: 2-30s. Max 15 MB. type: combinefileinput default: - name: inputVideo label: Video (First Clip) help: Optional. For video continuation. Model continues from this clip. Formats: MP4, MOV. Duration: 2-10s. Max 100 MB. type: combinefileinput default: - name: duration label: Duration help: Required. Duration of the generated video in seconds. type: select default: 5 options: - value: "5" label: 5 - value: "10" label: 10 - value: "15" label: 15 - name: resolution label: Resolution help: Required. Resolution tier for the generated video. type: select default: 720P options: - value: "720P" label: 720P - value: "1080P" label: 1080P - name: ratio label: Ratio help: For t2v only. If image or video is provided, ratio is determined by the input media. 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 - name: promptExtend label: Prompt Extend help: Optional. When enabled, an LLM rewrites the prompt. Improves quality for short prompts but increases processing time. type: select default: false options: - value: "false" label: false - value: "true" label: true - name: watermark label: Watermark help: Optional. Add 'AI Generated' watermark in the lower-right corner. type: select default: false options: - value: "false" label: false - value: "true" label: true - name: seed label: Seed help: Optional. Random seed for reproducibility (0-2147483647). type: number default: ## Model Parameter Inspires: - inputImage: - prompt: The yellow commuter train finishes passing through the frame, with its final carriages exiting smoothly to the right, revealing the empty tracks and green trees behind the fence. Just as the train disappears, a person riding a vintage bicycle enters the frame from the bottom left foreground. They pedal leisurely down the left side of the empty street, riding over the white painted arrow and away from the camera. The leaves on the trees in the background gently rustle in a sudden light breeze, and the daytime lighting remains perfectly consistent, casting realistic, moving shadows of the cyclist onto the asphalt. - inputVideo: https://cdn.wiro.ai/uploads/sampleinputs/alibaba-wan-2-7-input-1.mp4 - duration: 15 - inputImage: https://cdn.wiro.ai/uploads/sampleinputs/alibaba-wan-2-7-input-2.jpg - prompt: The scene comes alive with a gentle breeze. The calm green water begins to ripple naturally, softly distorting the crisp reflections of the brightly colored buildings. The moored boats gently bob up and down against their wooden poles, creating small, realistic wakes. On the left, the man in the foreground casually walks forward a few steps while looking around. The camera executes a very slow, stable push-in straight down the center of the canal. - inputVideo: - duration: 5 - inputImage: - prompt: A highly detailed macro shot of a crystal-clear glass on a rustic wooden table. Thick, steaming hot espresso is slowly poured into cold milk, creating intricate, physically accurate swirling gradients and foam patterns. As the liquids mix, the ambient lighting drastically shifts from cool, dim morning blue to intense, warm golden-hour sunlight, casting realistic dynamic shadows across the table. - inputVideo: - duration: 5 ## 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/alibaba/wan-2-7" -H "Content-Type: multipart/form-data" -H "x-api-key: ${YOUR_API_KEY}" -H "x-nonce: ${NONCE}" -H "x-signature: ${SIGNATURE}" -d '{ "inputImage": "alibaba-wan-2-7-input-2.jpg", "prompt": "The scene comes alive with a gentle breeze. The calm green water begins to ripple naturally, softly distorting the crisp reflections of the brightly colored buildings. The moored boats gently bob up and down against their wooden poles, creating small, realistic wakes. On the left, the man in the foreground casually walks forward a few steps while looking around. The camera executes a very slow, stable push-in straight down the center of the canal.", "negativePrompt": "", "inputAudio": "", "inputVideo": "", "duration": "5", "resolution": "720P", "ratio": "16:9", "promptExtend": "false", "watermark": "false", "seed": null, "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.