enable_sync_mode set to true (some models do not support this parameter, but you still need to query the result by id), you must call the Query Result endpoint to retrieve the final output.
data.id – the unique identifier of the predictiondata.urls[0].get – a ready-to-use GET URL that already embeds the id| Parameter | Type | Required | Default | Range | Description |
|---|---|---|---|---|---|
prompt | string | ✅ Yes | - | - | The positive prompt for the generation. Must not exceed 2,500 characters. |
image | string | ❌ No | - | - | Source image for image-to-video generation. |
last_image | string | ❌ No | - | - | last_frame is the last frame. |
images | array | ❌ No | - | - | Including reference images of the element, scene, style, etc. Max 10 (reduced to 4 when video is provided). |
video | string | ❌ No | - | - | The video URL for reference-to-video generation. |
aspect_ratio | string | ❌ No | 16:9 | 16:9, 1:1, 9:16 | The aspect ratio of the generated video. This parameter is required when the image-to-video or video editing features are not used. |
duration | integer | ❌ No | 5 | 3, 4, 5, 6, 7, 8, 9, 10 or 5, 10 | The duration of the generated media in seconds. When using text generated videos, and first frame image generated videos, only 5 and 10 seconds are supported. |
keep_original_sound | boolean | ❌ No | true | true, false | Select whether to keep the video original sound through the parameter. |
| Error Code | Error Name | Description |
|---|---|---|
| 401 | Unauthorized | API key is missing or invalid |
| 403 | Forbidden | Your API key doesn’t have permission to access this resource, or insufficient balance for the requested operation |
| 429 | Too Many Requests | You’ve exceeded your rate limit |
| 500 | Internal server error | An internal server error occurred |
| 503 | Content policy violation | Content blocked due to safety concerns (actual status code is 400) |