API reference

Create a reference student video task (subject call)

Official documentation: https://platform.vidu.cn/docs/reference-to-video

POST/ent/v2/reference2video

Body Parametersapplication/json

prompt* string

Text prompt describing the video to generate. Max 2000 characters.

model* string

duration number

seed string

Random seed. If omitted or 0, a random value is used; otherwise the provided seed is used.

movement_amplitude string

payload string

Pass-through parameter. Not processed; forwarded as-is. Max 1048576 characters.

watermark string

Whether to add a watermark. true: add watermark; false: no watermark. Note: watermark content is fixed ("AI generated") and off by default. Use watermarked_url from the query task API for watermarked video.

wm_position string

Watermark position on the image: 1 top-left, 2 top-right, 3 bottom-right, 4 bottom-left. Default: 3.

wm_url string

Watermark content as an image URL. If omitted, the default watermark "AI generated" is used.

meta_data string

Metadata identifier as a JSON string (pass-through). You may use a custom format or the sample shape with Label, ContentProducer, etc. If empty, Vidu-generated metadata is used.

callback_url string

Callback protocol: set callback_url when creating the task (POST). On status changes, Vidu sends the latest task status (same shape as the query task API). status: processing, success, failed. See callback signature docs for auth.

audio string

subjects* array

aspect_ratio string

auto_subjects string

resolution string

Responses

200 success application/json

response-200 object

400 Bad request or validation failed application/json

response-400 object

properties

error* object

401 Missing or invalid API Key application/json

response-401 object

Request Body Example Create a reference student video task (subject call)

2"model": "viduq2",

3"subjects": [

5"id": "cat",

6"images": [

7"https://c-ssl.duitang.com/uploads/blog/202306/19/y9S765GQCblz752.jpg"

10],

11"prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨"

12}

Code Sample cURL

1curl -X POST "https://api.digislash.com/ent/v2/reference2video" \

2-H "Authorization: Bearer <API Key>" \

3-H "Content-Type: application/json" \

4-d '{

5"model": "viduq2",

6"subjects": [

8"id": "cat",

9"images": [

10"https://c-ssl.duitang.com/uploads/blog/202306/19/y9S765GQCblz752.jpg"

11]

12}

13],

14"prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨"

15}'

Response

1▼{

2"task_id": "911084878697623552",

3"type": "character2video",

4"state": "created",

5"model": "viduq2",

6"style": "general",

7"prompt": "一只可爱的@cat在草地上奔跑，阳光明媚，画面温馨",

8▼"images": [

9"https://picx.zhimg.com/v2-4911df093b40ee5511938a1ac2a5cdc4_r.jpg"

10],

11"duration": 5,

12"seed": 1830691647,

13"aspect_ratio": "16:9",

14"resolution": "720p",

15"movement_amplitude": "auto",

16"created_at": "2026-01-20T06:37:57.371761937Z",

17"credits": 45,

18"payload": "",

19"cus_priority": 0,

20"off_peak": false,

21"watermark": false,

22"is_rec": false,

23"wm_position": "unspecified",

24"wm_url": "",

25"meta_data": "",

26"client_request_id": ""

27}