Task: Reference-to-Video
Overview
- Method:
POST - Path:
/task/vidu/reference2video - Content-Type:
application/json - Tags: Video Models (Video) / Vidu Video
Authentication
- Header:
Authorization: Bearer <token>
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | Yes | vidu2.0 / vidu1.5 / vidu1.0, default vidu2.0 |
| images | array[string] | Yes | 1-3 images (vidu1.0 supports only 1), URL or Base64, formats png/jpg/webp, <=50MB |
| prompt | string | Yes | Text prompt, up to 1500 characters |
| duration | integer | Yes | Video duration, currently 4 seconds |
| seed | integer | No | Random seed, 0 or omit for random |
| aspect_ratio | string | No | 16:9 / 9:16 (default 16:9) |
| resolution | string | Yes | 360p / 720p / 1080p (vidu1.0 only supports 360p) |
| movement_amplitude | string | No | auto / small / medium / large |
| callback_url | string | No | Callback URL, status values: processing/success/failed |
Example Request
bash
curl -X POST "https://api.gpt.ge/task/vidu/reference2video" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxx" \
-d '{
"model":"vidu2.0",
"images":["https://p1-kling.klingai.com/bs2/...png"],
"prompt":"A girl walks gracefully toward the camera...",
"duration":4,
"resolution":"720p"
}'Success Response Example (200)
json
{
"task_id":"809390691347075072",
"type":"character2video",
"state":"created",
"model":"vidu2.0",
"style":"general",
"prompt":"A girl walks gracefully toward the camera...",
"images":["https://p1-kling.klingai.com/bs2/...png"],
"duration":4,
"seed":305233514,
"aspect_ratio":"16:9",
"resolution":"720p",
"movement_amplitude":"auto",
"created_at":"2025-04-14T15:41:33.695830549Z"
}