API Documentation

Submit a video generation task. On success, the API returns task_no; retrieve the task status and generated result through Get Task Results.

Request Body

modelstringYes

Model name. Supported values are Vimoo 1.0 and Vimoo 1.0 - Lite

scenestringYes

Generation scene. Vimoo 1.0 supports t2v, i2v, and i2v-E; Vimoo 1.0 - Lite supports only ti2v

contentarray[object]Yes

A non-empty content list. Each scene has different requirements for the number, type, and role of text and image items

Hide child attributes⌄

content[].typestringYes

• text: Text content; provide the prompt in text
• image_url: Image content; provide the image URL in image_url.url and specify its purpose with role

content[].textstringFor text items

Video generation prompt. Required and non-empty when scene is t2v, i2v, or ti2v; may be omitted or left empty when scene is i2v-E. After trimming leading and trailing whitespace, the prompt may contain up to 2,000 characters; internal spaces and line breaks count toward the limit

content[].image_urlobjectFor images

Image URL object

content[].image_url.urlstringFor images

Use the file.file_url returned by Upload a File. Only valid images uploaded by the current account are supported

content[].rolestringRequired for images

• first_frame: For scene=i2v or scene=ti2v. i2v requires exactly 1 image; ti2v accepts an optional single image
• reference_image: For scene=i2v-E, with 1–9 images

durationintegerYes

t2v, i2v, and ti2v are fixed at 5 seconds; i2v-E is fixed at 20 seconds

seedintegerNo

Random seed from 0 to 2147483647. Defaults to 42 when omitted; an explicit 0 is preserved

ratiostringYes

16:9 for t2v, auto for i2v, auto or 16:9 for ti2v, and 9:16 for i2v-E

resolutionstringYes

Fixed at 720p

Example successful response (excerpt):

Save task_no to retrieve the task details and status later. For the complete task fields, see Get Task Results.

Preserve request_id for failed write requests and confirm that no task was created before retrying.