04-Start-End-Frame
Start-End Frame
Document Version: v1.0.0 | Last Updated: 2026-06-11 This platform fully supports the official Vidu video generation APIs. Requests and responses are transparently proxied with identical parameter semantics.
POST https://platform.dataeyes.ai/vidu/ent/v2/start-end2videoRequest Parameters
Request Headers
| Header | Required | Description |
|---|---|---|
Content-Type | Yes | application/json |
Authorization | Yes | Bearer {API_KEY} |
Request Body
| Parameter | Type | Required | Description |
|---|---|---|---|
model | String | Yes | Model name. Options: viduq3-turbo, viduq3-pro, viduq2-pro-fast, viduq2-pro, viduq2-turbo, viduq1, viduq1-classic, vidu2.0. |
images | Array[String] | Yes | Start and end frame images. Supports exactly 2 images; the first is the start frame, the second is the end frame. Note 1: The resolution ratio between start and end frames must be between 0.8–1.25; aspect ratio must be less than 1:4 or 4:1 Note 2: Supports Base64-encoded images or URLs Note 3: Supported formats: png, jpeg, jpg, webp Note 4: Image size must not exceed 50 MB Note 5: POST body must not exceed 20MB; Base64 must include content type prefix |
prompt | String | Optional | Text prompt. Maximum 5000 characters. Note: If the is_rec recommended prompt parameter is used, the model will ignore this prompt |
is_rec | Bool | Optional | Whether to use recommended prompts. Each task consumes an additional 10 credits when enabled. |
duration | Int | Optional | Video duration (seconds): - viduq3-pro, viduq3-turbo: Default 5, range 1–16- viduq2-pro-fast, viduq2-pro, viduq2-turbo: Default 5, range 1–8- viduq1, viduq1-classic: Default 5, fixed at 5- vidu2.0: Default 4, options 4, 8 |
seed | Int | Optional | Random seed. If omitted or set to 0, a random value is used. |
resolution | String | Optional | Resolution: - viduq3-pro, viduq3-turbo (1–16s): Default 720p, options 540p, 720p, 1080p- viduq2-pro-fast (1–8s): Default 720p, options 720p, 1080p- viduq2-pro, viduq2-turbo (1–8s): Default 720p, options 540p, 720p, 1080p- viduq1, viduq1-classic (5s): Default 1080p, fixed at 1080p- vidu2.0 (4s): Default 360p, options 360p, 720p, 1080p- vidu2.0 (8s): Default 720p, fixed at 720p |
movement_amplitude | String | Optional | Movement amplitude. Default auto. Note: Ineffective for q2 and q3 series models |
audio | Bool | Optional | Whether to enable audio-video output. Only supported by q3 series models; default true. |
bgm | Bool | Optional | Whether to add background music. Default false. Note: Ineffective for q3 series |
off_peak | Bool | Optional | Off-peak mode. Default false. |
watermark | Bool | Optional | Whether to add a watermark. Default is no watermark. |
wm_position | Int | Optional | Watermark position. 1: Top-left, 2: Top-right, 3: Bottom-right (default), 4: Bottom-left |
wm_url | String | Optional | Custom watermark image URL. |
payload | String | Optional | Pass-through parameter. Maximum 1048576 characters. |
meta_data | String | Optional | Metadata identifier, JSON format string, pass-through field. |
callback_url | String | Optional | Callback URL. |
Request Example
Response Parameters
| Field | Type | Description |
|---|---|---|
task_id | String | Task ID |
state | String | Processing state: created, queueing, processing, success, failed |
model | String | Model name used for this call |
prompt | String | Prompt |
images | Array[String] | Image parameters |
duration | Int | Video duration |
seed | Int | Random seed |
resolution | String | Resolution |
bgm | Bool | Whether background music is added |
movement_amplitude | String | Movement amplitude |
payload | String | Pass-through parameter |
off_peak | Bool | Whether off-peak mode is used |
credits | Int | Number of credits consumed |
watermark | Bool | Whether a watermark is used |
created_at | String | Task creation time |
Response Example
{
"task_id": "{task_id}",
"state": "created",
"model": "viduq3-pro",
"images": [
"https://example.com/start-frame.jpeg",
"https://example.com/end-frame.jpeg"
],
"prompt": "The camera zooms in on the bird, which then flies to the right.",
"duration": 5,
"seed": 123456,
"resolution": "1080p",
"audio": true,
"payload": "",
"off_peak": false,
"credits": 8,
"created_at": "2025-01-01T15:41:31.968916Z"
}