Skip to main content
POST
Image-to-video (i2v). Fixed FAST mode, no speed dimension; text-to-video (t2v) is not supported — a first frame is required. Duration is fixed at ~5 seconds.

Parameters

Valid video_type values

extend-style values are not accepted; only the video_type values listed above are supported.

Request examples

Simple i2v (own first frame, batch 4):
Start/end transition (end_url auto-upgrades to start_end):

Response

Submission returns a task_id; poll GET /v1/tasks/{task_id}. On SUCCESS it includes video_url (the first) plus video_urls (length === batch_size; with batch=1 it still has 1 element):

Notes

  • Text-to-video (t2v) is not supported: you must pass image_urls or task_id, otherwise it returns 400; you cannot pass both.
  • Fixed FAST mode, no speed dimension (@video-fast / @video-turbo in the billing table are never hit).
  • batch_size is strictly validated as 1 / 2 / 4; batch=4 charges 4×, use batch=1 when budget-sensitive.
  • animate_mode=auto requires both task_id + index.
  • The first / end frame must each be ≤ 12 MiB.