One-click Solutions
Authorizationstring*Replace {your api key} with your token
Token {your api key}imagesstring*Media, object, or style images to use when generating the result
Note 1: Supports Base64 encoding or an image URL (must be publicly accessible);
Note 2: Supports 1~7 images;
Note 3: Images must be in png, jpeg, jpg, or webp format;
Note 4: Image aspect ratio must be less than 1:4 or 4:1;
Note 5: Image size must not exceed 50 MB;
Note 6: Note that the byte length after Base64 decoding must be less than 10M, and the encoding must include the appropriate content type string, for base64,(base64_encode)normal
data:image/pngpromptstringUser prompt
Text description for generating the result film.
Note 1: Must not exceed 3000 characters
aspect_ratiostringOutput aspect ratio, default 16:9
Allowed values: 1:1, 16:9, 9:16, 4:3, 3:4
durationinteger*Duration, 1~180s
callback_urlstringCallback protocol
You need to actively set callback_url when creating the task; the request method is POST. When the video generation task's status changes, Vidu will send a callback request containing the task's latest status to this address. The structure of the callback request content is consistent with the response body of the task query API
The "status" returned by the callback includes the following states:
payloadstringPass-through parameter
Not processed in any way, used only for data transmission
Note: Maximum 1048576 characters
Authorizationstring*Replace {your api key} with your token
Token {your api key}idstring*Result film ID or subtask ID
Authorizationstring*Replace {your api key} with your token
Token {your api key}idstring*idstring*Task ID, placed in the path
job_idstring*ID of the shot to edit
promptstring*User prompt
Text description for generating the MV video.
Note 1: Must not exceed 3000 characters
callback_urlstringCallback protocol
You need to actively set callback_url when creating the task; the request method is POST. When the video generation task's status changes, Vidu will send a callback request containing the task's latest status to this address. The structure of the callback request content is consistent with the response body of the task query API
The "status" returned by the callback includes the following states:
Authorizationstring*Replace {your api key} with your token
Token {your api key}idstring*idstring*Task ID, placed in the path
job_idsstring*List of shots to compose
callback_urlstringCallback protocol
You need to actively set callback_url when creating the task; the request method is POST. When the video generation task's status changes, Vidu will send a callback request containing the task's latest status to this address. The structure of the callback request content is consistent with the response body of the task query API
The "status" returned by the callback includes the following states:
curl --request POST \
--url 'https://api.vidu.cn/ent/v2/one-click/general_one_click' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"images": "data:image/png",
"prompt": "",
"aspect_ratio": "16:9",
"duration": 15,
"callback_url": "string",
"payload": "string"
}'{
"id": "your_id_here"
}curl --request GET \
--url 'https://api.vidu.com/ent/v2/one-click/general_one_click/{id}' \
--header 'Authorization: Token {your api key}'{
"id": "901243326567555072",
"type": "one_click",
"creator_id": "869085108764676096",
"state": "success",
"input": "",
"job_records": [
{
"type": "generate_video",
"jobs": [
{
"id": "901245331704909824",
"type": "generate_video",
"input": "",
"output": "",
"state": "success",
"created_at": "2025-12-24T02:59:06.937309Z",
"updated_at": "2025-12-24T02:59:35.473978Z",
"err_code": "",
"err_msg": "",
"signed_url": "your_url",
"mv_generate_video_input": {
"duration": 3,
"prompt": "2.5D modeling style, bright and lively tones, aurora dancing above the Arctic Circle, sparkling particle light effects, camera slowly pushing in, creating a mysterious yet cheerful atmosphere.",
"lyric_text": "Intro",
"signed_images": []
},
"index": 0
}
],
"index": 0
},
{
"type": "compose",
"jobs": [
{
"id": "901245503243554816",
"type": "compose",
"input": "",
"output": "",
"state": "success",
"created_at": "2025-12-24T02:59:47.431993Z",
"updated_at": "2025-12-24T03:00:13.727780Z",
"err_code": "",
"err_msg": "",
"signed_url": "your_url",
"index": 0
}
],
"index": 0
}
],
"created_at": "2025-12-24T02:51:34.070650Z",
"updated_at": "2025-12-24T03:00:13.734086Z",
"err_code": "",
"err_msg": "",
"signed_url": "your_url"
}curl --request POST \
--url 'https://api.vidu.cn/ent/v2/one-click/general_one_click/string/edit' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"id": "string",
"job_id": "901334076999344129",
"prompt": "2.5D modeling style, cheerful and joyful atmosphere, close-up shot, the male lead dancing on a beach at the edge of the sea, waves gently lapping at his ankles, the camera following his spinning motion, showcasing his smile and energy.",
"callback_url": "string"
}'{
"id": "your_job_id_here"
}curl --request POST \
--url 'https://api.vidu.cn/ent/v2/one-click/general_one_click/string/compose' \
--header 'Authorization: Token {your api key}' \
--header 'Content-Type: application/json' \
--data '{
"id": "string",
"job_ids": [
"id1",
"id2",
"id3",
"id4",
"id5",
"id6"
],
"callback_url": "string"
}'{
"id": "your_job_id_here"
}application/jsonResponse fields
idstringThe task ID generated by Vidu for this task
application/jsonResponse fields
idstringThe task ID generated by Vidu for this task
application/jsonResponse fields
idstringThe task ID generated by Vidu for this task
application/jsonResponse fields
idstringTask ID
statestringProcessing status
Allowed values:
created: created successfully
processing: task is processing
success: task succeeded
failed: task failed
err_codestringError code, see the error code table for details
err_msgstringError-related information
created_atstringCreation time
signed_urlstringURL of the generated result film (valid for less than 3 minutes)
job_recordsarrayList of shots + composed video
typestringAllowed values:
generate_video: video shot
compose: compose all shots
indexintegerShot index
jobsarrayEdit history of a single shot
jobs.idstringSubtask ID
jobs.typestringgenerate_video/compose
jobs.statestringProcessing status
Allowed values:
created: created successfully
processing: task is processing
success: task succeeded
failed: task failed
jobs.signed_urlstringURL of the generated shot or composed video