/v1/videos/generations for video creation.
202 response does not wait for video generation to finish, so poll the
returned task until it reaches a terminal state. The periodic task worker
remains a recovery mechanism for pending tasks.
Prompt safety
Prompts that clearly combine a minor with exposure or emphasis of sensitive body areas, or with explicit sexual or nudity content, return HTTP400 with
code content_policy. Validation runs before task creation and credit
reservation, so no credits are charged. Revise the prompt to use an adult
subject (18+), remove sensitive-body close-ups, and keep the subject fully
clothed. Ordinary child-safe family, classroom, sports, and art scenes are not
blocked by this targeted rule.
Wan 3.0 Prime requests
Wan 3.0 Prime uses three public model IDs with separate input contracts:
All three accept an integer
duration from 2 to 30, quality of 480p,
720p, or 1080p, and aspect_ratio of adaptive, 16:9, 9:16,
1:1, 4:3, or 3:4. generate_audio defaults to true.
resolution remains an alias for quality. Automatic duration, task
cancellation, negative_prompt, and prompt_extend are not supported on
these public model IDs.
Text to video
First and last frame
image_urls; use image_start and
the optional image_end fields shown above.
Multimodal references
model_params.file_url or one web page with
model_params.link_url; those two fields are mutually exclusive. Numbering is
per media type and follows array order: Image 1, Video 1, and Audio 1
refer to the first item of their respective arrays.
Save the task ID and use polling or an HTTPS callback. Persist successful
outputs promptly because generated result URLs are temporary.
Sync variant
/v1/videos/generations/sync waits for the task result in the same HTTP request. Long-running jobs should use async creation and task polling.