Category: provider

Model Studio Wan Video

Validation

CODEBLOCK0

Pass criteria: command exits 0 and output/alicloud-ai-video-wan-video/validate.txt is generated.

Output And Evidence

• - Save task IDs, polling responses, and final video URLs to output/alicloud-ai-video-wan-video/.
• Keep one end-to-end run log for troubleshooting.

Provide consistent video generation behavior for the video-agent pipeline by standardizing video.generate inputs/outputs and using DashScope SDK (Python) with the exact model name.

Critical model names

Use one of these exact model strings:

• - INLINECODE3
• INLINECODE4
• INLINECODE5
• INLINECODE6
• INLINECODE7
• INLINECODE8
• INLINECODE9

Prerequisites

• - Install SDK (recommended in a venv to avoid PEP 668 limits):

CODEBLOCK1

• - Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials (env takes precedence).

Normalized interface (video.generate)

Request

• - prompt (string, required)
• INLINECODE14 (string, optional)
• INLINECODE15 (number, required) seconds
• INLINECODE16 (number, required)
• INLINECODE17 (string, required) e.g. INLINECODE18
• INLINECODE19 (int, optional)
• INLINECODE20 (string | bytes, optional for t2v, required for i2v family models)
• INLINECODE21 (number, optional)

Response

• - video_url (string)
• INLINECODE23 (number)
• INLINECODE24 (number)
• INLINECODE25 (int)

Quick start (Python + DashScope SDK)

Video generation is usually asynchronous. Expect a task ID and poll until completion.
Note: Wan i2v models require an input image; pure t2v models can omit reference_image.

CODEBLOCK2

Async handling (polling)

CODEBLOCK3

Operational guidance

• - Video generation can take minutes; expose progress and allow cancel/retry.
• Cache by (prompt, negative_prompt, duration, fps, size, seed, reference_image hash, motion_strength).
• Store video assets in object storage and persist only URLs in metadata.
• INLINECODE28 can be a URL or local path; the SDK auto-uploads local files.
• If you get Field required: input.img_url, the reference image is missing or not mapped.

Size notes

• - Use WxH format (e.g. 1280*720).
• Prefer common sizes; unsupported sizes can return 400.

Output location

• - Default output: INLINECODE32
• Override base dir with OUTPUT_DIR.

Anti-patterns

• - Do not invent model names or aliases; use official Wan i2v model IDs only.
• Do not block the UI without progress updates.
• Do not retry blindly on 4xx; handle validation failures explicitly.

Workflow

1) Confirm user intent, region, identifiers, and whether the operation is read-only or mutating.
2) Run one minimal read-only query first to verify connectivity and permissions.
3) Execute the target operation with explicit parameters and bounded scope.
4) Verify results and save output/evidence files.

References

• - See references/api_reference.md for DashScope SDK mapping and async handling notes.

• - Source list: INLINECODE35