One Click AI-MV | Vidu API

On this page

On this page

Solutions

POST https://api.vidu.com/ent/v2/one-click/[premium_mv](https://houxulu-vidu-api.dev.shu.team/ent/v2/one-click/premium_mv)

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

Both modes involve lip-sync rendering, and lip_ref_urls is a mandatory parameter.

Field	Required to pass	Type	value	Description
premium_mv_mode	✅ is	String	sing / sing_perform	Task mode
lip_ref_urls	- This parameter is mandatory when premium_mv_mode is set to sing or sing_perform. - This parameter is not required if premium_mv_mode is perform or dance; any passed value will be ignored.	Array[String]	Max 2 images, sorted by the vocal entry order of songs; front close-up human faces; format: jpeg/jpg/png/bmp/webp	Lip-sync Character Reference Images
images	- This parameter is optional when premium_mv_mode is set to sing or sing_perform. - This parameter is mandatory if premium_mv_mode is perform or dance.	Array[String]	6 images; input via URL or Base64; format: png/jpeg/jpg/webp; aspect ratio 1:44:1; file size ≤50MB	Other Assets (Backgrounds, Props, etc.)
audio_url	✅ is	String	URL or base64;mp3/wav/aac/m4a;10~300 s	Only audio with lyrics is supported; pure music uploads are not allowed.
style	Optional	String	Style Text	Diffusion Style、Anime Style
prompt	Optional	String	max 3000 character	prompt
aspect_ratio	Optional	String	1:1 / 16:9 / 9:16 / 4:3 / 3:4	Output Aspect Ratio, default 16:9
resolution	Optional	String	Default: 720p，Optional values: 720p, 1080p。	Resolution, default 720p
add_subtitle	Optional	Bool	true / false	Burn-in subtitles toggle, default false
subtitle_color	Optional	String	HEX,如 #FFFFFF	Subtitle color, default white
callback_url	Optional	String	URL	Status change callback

⚠ lip_ref_urls is required. A maximum of 2 images are allowed, ordered by the sequence of vocal entry in the song.

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_id_here"
}

GET https://api.vidu.cn/ent/v2/one-click/[premium_mv](https://houxulu-vidu-api.dev.shu.team/ent/v2/one-click/premium_mv)/{id}

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Parameter Name	Type	Required	Parameter Description
id	String	is	Clip ID or Subtask ID

Field	Subfield		Type	Description
id			String	Task ID
state			String	Processing Status Optional values: created - Creation successful processing - Task in progress success - Task succeeded failed - Task failed
err_code			String	Error code, see the error code table for details
err_msg			String	Error-related information
created_at			String	Creation Time
signed_url			String	URL of the generated video (available if the video is less than 3 minutes)
job_records			Array	Shot List + Composite Video
	type		String	Optional values: generate_video Video Storyboard compose Compose All Storyboards
	index		Int	Shot Index
	jobs		Array	Single shot modification history
		id	String
		type	String	generate_video/compose
		state	String	Processing Status Optional values: created - Creation successful processing - Task in progress success - Task succeeded failed - Task failed
		signed_url		URL of the storyboard or composite product

{
    "id": "901243326567555072",
    "type": "mv",
    "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245331704909824/video_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=c595b9175e4fff409c9fd79dfb4f38d55d2694ed88c28d61022deb69155effe0",
                    "mv_generate_video_input": {
                        "duration": 3,
                        "prompt": "2.5d建模风格，明亮活泼的色调，极光在北极圈上空舞动，粒子光效闪烁，镜头缓慢推进，营造神秘又欢快的氛围。",
                        "lyric_text": "前奏",
                        "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245503243554816/composed_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=faa62b949e2ff67b41f5769e2eddea728a2c5db75f2a9fd3a30eb6f5d3d591ed",
                    "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245503243554816/composed_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=faa62b949e2ff67b41f5769e2eddea728a2c5db75f2a9fd3a30eb6f5d3d591ed"
}

POST https://api.vidu.cn/ent/v2/one-click/[premium_mv](https://houxulu-vidu-api.dev.shu.team/ent/v2/one-click/premium_mv)/{id}/edit

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

Field	Required to pass	Type	Description
id	is	String	Task ID, placed in the path
job_id	is	String	ID of the shot to be edited
prompt	is	String	User Prompt Generate a text description for the MV video. Note 1: The character length cannot exceed 3000 characters.
images	Optional	Array[String]	新增。分镜参考图片列表。传入时将清空原分镜图片并以此替换;不传或传空数组时,沿用原分镜图片。（仅仅对该分镜有效）
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_job_id_here"
}

POST https://api.vidu.cn/ent/v2/one-click/[premium_mv](https://houxulu-vidu-api.dev.shu.team/ent/v2/one-click/premium_mv)/{id}/compose

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Field	Required to pass	Type	Description
id	is	String	Task ID, placed in the path
job_ids	is	String	List of shots to be synthesized
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_job_id_here"
}

Mode	分辨率	定价
perform	720p	21积分/s
sing	720p	24积分/s
sing_perform	720p	24积分/s
dance	720p	24积分/s

POST https://api.vidu.com/ent/v2/one-click/mv

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Field	Required to pass	Type	Description
images	is	Array[String]	Model images or style images when users generate MV Note 1: Supports passing in Base64-encoded images or image URLs (ensure they are accessible); Note 2: Supports inputting 1 to 7 images; Note 3: Images support formats such as png, jpeg, jpg, and webp; Note 4: The aspect ratio of images needs to be less than 1:4 or 4:1; Note 5: The size of images should not exceed 50 MB; Note 6: Please note that the byte length after base64 decoding needs to be less than 10M, and the encoding must include an appropriate content type string, for example: `data:image/png;base64,{base64_encode}`
audio_url	is	String	Audio for generating MV is required Note 1: Supports passing in Base64 encoding or audio URL (ensure it is accessible); Note 2: Supports inputting 1 audio; Note 3: Supports mp3, wav, aac, m4a formats; Note 4: Outputs the synthesized audio in one go, with the uploaded audio being at least 10 seconds and at most 180 seconds; Note 5: Only the shot list will be output. The uploaded audio should be at least 10 seconds and at most 300 seconds; Note 6: The ByteDance length after base64 decoding needs to be less than 20M, and the encoding must include an appropriate content type string, for example: `data:image/png;base64,{base64_encode}`
lip_ref_url	Optional	String	url，唱歌的人脸，需要正面对镜头，近景图像文件要求： - 内容：需包含一张清晰的人物正脸，且为视频中出现的人物 - 文件大小：文件≤10MB - 图像大小：长宽比小于等于2，最大边长小于等4096 - 格式：jpeg、jpg、png、bmp、webp 使用该参数，对口型成功率会大幅度上升 540p不支持对口型
lip_sync	Optional	bool	true：Need lip sync false：No lip-syncing required Default false After activation, 4 credits will be added per second. Note 1: Non-human subjects are not supported; Note 2: Non-frontal segments in the video are not supported; 540p不支持对口型
quality	Optional	string	high/standard high → MIX 链路。 standard → Q2 参考生链路。（默认）
prompt	Optional	string	User Prompt Generate a text description for the MV video. Note 1: The character length cannot exceed 3000 characters.
aspect_ratio	Optional	string	Output aspect ratio, default 16:9 Optional values: 1:1, 16:9, 9:16, 4:3, 3:4
resolution	Optional	String	Clarity, default 720p Available values: 540p, 720p, 1080p
subtitle	Optional	Bool	Whether subtitles are needed, default is false true: Subtitles are required false: No subtitles needed
subtitle_color	Optional	string	Default #FFFFFF, white HEX format text color
srt_url	Optional	String	Subtitle file URL
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_id_here"
}

GET https://api.vidu.com/ent/v2/one-click/mv/{id}

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Parameter Name	Type	Required	Parameter Description
id	String	is	Clip ID or Subtask ID

Field	Subfield		Type	Description
id			String	Task ID
state			String	Processing Status Optional values: created - Creation successful processing - Task in progress success - Task succeeded failed - Task failed
err_code			String	Error code, see the error code table for details
err_msg			String	Error-related information
created_at			String	Creation Time
signed_url			String	URL of the generated video (available if the video is less than 3 minutes)
job_records			Array	Shot List + Composite Video
	type		String	Optional values: generate_video Video Storyboard compose Compose All Storyboards
	index		Int	Shot Index
	jobs		Array	Single shot modification history
		id	String
		type	String	generate_video/compose
		state	String	Processing Status Optional values: created - Creation successful processing - Task in progress success - Task succeeded failed - Task failed
		signed_url		URL of the storyboard or composite product

{
    "id": "901243326567555072",
    "type": "mv",
    "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245331704909824/video_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=c595b9175e4fff409c9fd79dfb4f38d55d2694ed88c28d61022deb69155effe0",
                    "mv_generate_video_input": {
                        "duration": 3,
                        "prompt": "2.5d建模风格，明亮活泼的色调，极光在北极圈上空舞动，粒子光效闪烁，镜头缓慢推进，营造神秘又欢快的氛围。",
                        "lyric_text": "前奏",
                        "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245503243554816/composed_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=faa62b949e2ff67b41f5769e2eddea728a2c5db75f2a9fd3a30eb6f5d3d591ed",
                    "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245503243554816/composed_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=faa62b949e2ff67b41f5769e2eddea728a2c5db75f2a9fd3a30eb6f5d3d591ed"
}

POST https://api.vidu.com/ent/v2/one-click/mv/{id}/edit

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Field	Required to pass	Type	Description
id	is	String	Task ID, placed in the path
job_id	is	String	ID of the shot to be edited
prompt	is	String	User Prompt Generate a text description for the MV video. Note 1: The character length cannot exceed 3000 characters.
images	Optional	Array[String]	新增。分镜参考图片列表。传入时将清空原分镜图片并以此替换;不传或传空数组时,沿用原分镜图片。（仅仅对该分镜有效）
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_job_id_here"
}

POST https://api.vidu.com/ent/v2/one-click/mv/{id}/compose

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Field	Required to pass	Type	Description
id	is	String	Task ID, placed in the path
job_ids	is	String	List of shots to be synthesized
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_job_id_here"
}

	540p	720p	1080p
standard	6 credits/s	8 credits/s	10 credits/s
high	Not supported	24 credits/s	29 credits/s

Solutions

POST https://api.vidu.com/ent/v2/one-click/[premium_mv](https://houxulu-vidu-api.dev.shu.team/ent/v2/one-click/premium_mv)

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

Both modes involve lip-sync rendering, and lip_ref_urls is a mandatory parameter.

Field	Required to pass	Type	value	Description
premium_mv_mode	✅ is	String	sing / sing_perform	Task mode
lip_ref_urls	- This parameter is mandatory when premium_mv_mode is set to sing or sing_perform. - This parameter is not required if premium_mv_mode is perform or dance; any passed value will be ignored.	Array[String]	Max 2 images, sorted by the vocal entry order of songs; front close-up human faces; format: jpeg/jpg/png/bmp/webp	Lip-sync Character Reference Images
images	- This parameter is optional when premium_mv_mode is set to sing or sing_perform. - This parameter is mandatory if premium_mv_mode is perform or dance.	Array[String]	6 images; input via URL or Base64; format: png/jpeg/jpg/webp; aspect ratio 1:44:1; file size ≤50MB	Other Assets (Backgrounds, Props, etc.)
audio_url	✅ is	String	URL or base64;mp3/wav/aac/m4a;10~300 s	Only audio with lyrics is supported; pure music uploads are not allowed.
style	Optional	String	Style Text	Diffusion Style、Anime Style
prompt	Optional	String	max 3000 character	prompt
aspect_ratio	Optional	String	1:1 / 16:9 / 9:16 / 4:3 / 3:4	Output Aspect Ratio, default 16:9
resolution	Optional	String	Default: 720p，Optional values: 720p, 1080p。	Resolution, default 720p
add_subtitle	Optional	Bool	true / false	Burn-in subtitles toggle, default false
subtitle_color	Optional	String	HEX,如 #FFFFFF	Subtitle color, default white
callback_url	Optional	String	URL	Status change callback

⚠ lip_ref_urls is required. A maximum of 2 images are allowed, ordered by the sequence of vocal entry in the song.

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_id_here"
}

GET https://api.vidu.cn/ent/v2/one-click/[premium_mv](https://houxulu-vidu-api.dev.shu.team/ent/v2/one-click/premium_mv)/{id}

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Parameter Name	Type	Required	Parameter Description
id	String	is	Clip ID or Subtask ID

Field	Subfield		Type	Description
id			String	Task ID
state			String	Processing Status Optional values: created - Creation successful processing - Task in progress success - Task succeeded failed - Task failed
err_code			String	Error code, see the error code table for details
err_msg			String	Error-related information
created_at			String	Creation Time
signed_url			String	URL of the generated video (available if the video is less than 3 minutes)
job_records			Array	Shot List + Composite Video
	type		String	Optional values: generate_video Video Storyboard compose Compose All Storyboards
	index		Int	Shot Index
	jobs		Array	Single shot modification history
		id	String
		type	String	generate_video/compose
		state	String	Processing Status Optional values: created - Creation successful processing - Task in progress success - Task succeeded failed - Task failed
		signed_url		URL of the storyboard or composite product

{
    "id": "901243326567555072",
    "type": "mv",
    "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245331704909824/video_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=c595b9175e4fff409c9fd79dfb4f38d55d2694ed88c28d61022deb69155effe0",
                    "mv_generate_video_input": {
                        "duration": 3,
                        "prompt": "2.5d建模风格，明亮活泼的色调，极光在北极圈上空舞动，粒子光效闪烁，镜头缓慢推进，营造神秘又欢快的氛围。",
                        "lyric_text": "前奏",
                        "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245503243554816/composed_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=faa62b949e2ff67b41f5769e2eddea728a2c5db75f2a9fd3a30eb6f5d3d591ed",
                    "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245503243554816/composed_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=faa62b949e2ff67b41f5769e2eddea728a2c5db75f2a9fd3a30eb6f5d3d591ed"
}

POST https://api.vidu.cn/ent/v2/one-click/[premium_mv](https://houxulu-vidu-api.dev.shu.team/ent/v2/one-click/premium_mv)/{id}/edit

字段	值	描述
Content-Type	application/json	数据交换格式
Authorization	Token \{your api key\}	将 \{your api key\} 替换为您的 token

Field	Required to pass	Type	Description
id	is	String	Task ID, placed in the path
job_id	is	String	ID of the shot to be edited
prompt	is	String	User Prompt Generate a text description for the MV video. Note 1: The character length cannot exceed 3000 characters.
images	Optional	Array[String]	新增。分镜参考图片列表。传入时将清空原分镜图片并以此替换;不传或传空数组时,沿用原分镜图片。（仅仅对该分镜有效）
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_job_id_here"
}

POST https://api.vidu.cn/ent/v2/one-click/[premium_mv](https://houxulu-vidu-api.dev.shu.team/ent/v2/one-click/premium_mv)/{id}/compose

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Field	Required to pass	Type	Description
id	is	String	Task ID, placed in the path
job_ids	is	String	List of shots to be synthesized
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_job_id_here"
}

Mode	分辨率	定价
perform	720p	21积分/s
sing	720p	24积分/s
sing_perform	720p	24积分/s
dance	720p	24积分/s

POST https://api.vidu.com/ent/v2/one-click/mv

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Field	Required to pass	Type	Description
images	is	Array[String]	Model images or style images when users generate MV Note 1: Supports passing in Base64-encoded images or image URLs (ensure they are accessible); Note 2: Supports inputting 1 to 7 images; Note 3: Images support formats such as png, jpeg, jpg, and webp; Note 4: The aspect ratio of images needs to be less than 1:4 or 4:1; Note 5: The size of images should not exceed 50 MB; Note 6: Please note that the byte length after base64 decoding needs to be less than 10M, and the encoding must include an appropriate content type string, for example: `data:image/png;base64,{base64_encode}`
audio_url	is	String	Audio for generating MV is required Note 1: Supports passing in Base64 encoding or audio URL (ensure it is accessible); Note 2: Supports inputting 1 audio; Note 3: Supports mp3, wav, aac, m4a formats; Note 4: Outputs the synthesized audio in one go, with the uploaded audio being at least 10 seconds and at most 180 seconds; Note 5: Only the shot list will be output. The uploaded audio should be at least 10 seconds and at most 300 seconds; Note 6: The ByteDance length after base64 decoding needs to be less than 20M, and the encoding must include an appropriate content type string, for example: `data:image/png;base64,{base64_encode}`
lip_ref_url	Optional	String	url，唱歌的人脸，需要正面对镜头，近景图像文件要求： - 内容：需包含一张清晰的人物正脸，且为视频中出现的人物 - 文件大小：文件≤10MB - 图像大小：长宽比小于等于2，最大边长小于等4096 - 格式：jpeg、jpg、png、bmp、webp 使用该参数，对口型成功率会大幅度上升 540p不支持对口型
lip_sync	Optional	bool	true：Need lip sync false：No lip-syncing required Default false After activation, 4 credits will be added per second. Note 1: Non-human subjects are not supported; Note 2: Non-frontal segments in the video are not supported; 540p不支持对口型
quality	Optional	string	high/standard high → MIX 链路。 standard → Q2 参考生链路。（默认）
prompt	Optional	string	User Prompt Generate a text description for the MV video. Note 1: The character length cannot exceed 3000 characters.
aspect_ratio	Optional	string	Output aspect ratio, default 16:9 Optional values: 1:1, 16:9, 9:16, 4:3, 3:4
resolution	Optional	String	Clarity, default 720p Available values: 540p, 720p, 1080p
subtitle	Optional	Bool	Whether subtitles are needed, default is false true: Subtitles are required false: No subtitles needed
subtitle_color	Optional	string	Default #FFFFFF, white HEX format text color
srt_url	Optional	String	Subtitle file URL
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_id_here"
}

GET https://api.vidu.com/ent/v2/one-click/mv/{id}

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Parameter Name	Type	Required	Parameter Description
id	String	is	Clip ID or Subtask ID

Field	Subfield		Type	Description
id			String	Task ID
state			String	Processing Status Optional values: created - Creation successful processing - Task in progress success - Task succeeded failed - Task failed
err_code			String	Error code, see the error code table for details
err_msg			String	Error-related information
created_at			String	Creation Time
signed_url			String	URL of the generated video (available if the video is less than 3 minutes)
job_records			Array	Shot List + Composite Video
	type		String	Optional values: generate_video Video Storyboard compose Compose All Storyboards
	index		Int	Shot Index
	jobs		Array	Single shot modification history
		id	String
		type	String	generate_video/compose
		state	String	Processing Status Optional values: created - Creation successful processing - Task in progress success - Task succeeded failed - Task failed
		signed_url		URL of the storyboard or composite product

{
    "id": "901243326567555072",
    "type": "mv",
    "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245331704909824/video_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=c595b9175e4fff409c9fd79dfb4f38d55d2694ed88c28d61022deb69155effe0",
                    "mv_generate_video_input": {
                        "duration": 3,
                        "prompt": "2.5d建模风格，明亮活泼的色调，极光在北极圈上空舞动，粒子光效闪烁，镜头缓慢推进，营造神秘又欢快的氛围。",
                        "lyric_text": "前奏",
                        "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245503243554816/composed_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=faa62b949e2ff67b41f5769e2eddea728a2c5db75f2a9fd3a30eb6f5d3d591ed",
                    "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": "https://test-maas-agent.s3.ap-southeast-1.amazonaws.com/agent/mv/901243326567555072/901245503243554816/composed_result.mp4?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAZVXP2QJEYEYI65TR%2F20251226%2Fap-southeast-1%2Fs3%2Faws4_request&X-Amz-Date=20251226T112123Z&X-Amz-Expires=86400&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEIv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaDmFwLXNvdXRoZWFzdC0xIkYwRAIgCaLwSd7z5k6LhZP1dvQ%2BKQ05SrcqhA8OJ7%2Bqosar8VkCIE2K49YUVvX%2BdqnuaUuHQIIxCblm47COL0%2FuZXeWtZVdKoIFCFQQABoMNjY1MTQ5MTQ1NjczIgzBmh80PYRCvtEjLqYq3wQW%2FtA%2BTX%2BF5fk3IZplIqGZx7sr3O4TWEEc9GJAn7Jl%2BmEd2yMMUAGIuNn1jzN72qZROtrCf5WD4ndaqXCy1uFBdijmV9fWob%2FJMGxLReHLM0p1XYCHMM%2Bt%2Bdkj%2FCBMeFXgPp9xywfvbQVDCZBZouL%2BB4c3gJWqnvxn2pSlWBoxY%2B68oSSSkmF2fEQ8PXtSnS1OJzhEpu1tPhyJxMhZfzpvzkiuurV1dZHvFJB6RlpDwYeS7I8Q7QV6uOng1ubKPavfurBCoOgSqnQXTzFXr89ekpykXffrqlOE4lbyiNeu2zZ96Fn%2B2CTcsmp518s2hzeV8iPVO6Io6a%2B4Ju2ha0quhaaAX0XeEbxFggFP765sH0tBZwxvMpClkp%2FcsOUDKMiJjIM9gsY7if%2FIvgTkWMPMVkjdB2S%2BOj%2B3Cn2tTtGw%2BeDon6TAZbk6PsA%2FIFRCT%2FHK544lNVx%2Bed2dhI2ZTQUMzuOnZucN%2Fd1JkyiY9Kyfv%2BCZRtVYuZ6rNyrV4Sh9S6rQiTAGpD3Rames4GjchmEmYANxYfs4wUaBjHxqAl4KPsNIZWRFrBrqio8fmaH10MPUU520C9wIQOfMnbiTrKd%2BOzWI1D%2FTncThZtISkA%2B4DpJeUAHKcHkUtymS6ioM4ps9xYYcNpFMX3TifDDZ8bgKsizZ4NfH4MxAAJPt%2BaizeuiOKvrFjA7I96wfCTK7UhagZ1krb82Gbs8eH6iBnLp9RQNZFLITNzKYNi0%2F5EBiUbeUkXi%2BWaHu%2B8DWKVUgNJRJGgo1tLrV4CpIm8OBpzI4HzbwxMVJXT%2Bx0XUnxeGvMJXcucoGOpkBG%2FjCq82IOZRuLCX%2FUNm5OmgULMbOH8jWiNxcFHtcHzPvKWvpNr59%2FAwh4orvHK%2Fr82o1iV8J7rqwuhW%2BgMXDBEZwZI8TIFk7EoylEe8XCCdBindqi%2B6J9PxjxzW%2FqUuDkFcdsJkDpZ6mwoMuDCJWVbzIak3mYZS8n3eT7uGuiYITZ67zwjKT2FkAGSXpIqIaKeMi76sjuq4n&X-Amz-SignedHeaders=host&response-cache-control=max-age%3D86400&response-content-disposition=attachment&x-id=GetObject&X-Amz-Signature=faa62b949e2ff67b41f5769e2eddea728a2c5db75f2a9fd3a30eb6f5d3d591ed"
}

POST https://api.vidu.com/ent/v2/one-click/mv/{id}/edit

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Field	Required to pass	Type	Description
id	is	String	Task ID, placed in the path
job_id	is	String	ID of the shot to be edited
prompt	is	String	User Prompt Generate a text description for the MV video. Note 1: The character length cannot exceed 3000 characters.
images	Optional	Array[String]	新增。分镜参考图片列表。传入时将清空原分镜图片并以此替换;不传或传空数组时,沿用原分镜图片。（仅仅对该分镜有效）
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_job_id_here"
}

POST https://api.vidu.com/ent/v2/one-click/mv/{id}/compose

Field	Value	Description
Content-Type	application/json	Data Exchange Format
Authorization	Token \{your api key\}	Replace \{your api key\} with your token

Field	Required to pass	Type	Description
id	is	String	Task ID, placed in the path
job_ids	is	String	List of shots to be synthesized
callback_url	Optional	String	Callback When creating a task, you need to actively set the callback_url with a POST request. When the video generation task changes its status, Vidu will send a callback request to this URL, containing the latest status of the task. The structure of the callback request content will be the same as the return body of the Get Generation API. The "status" in the callback response includes the following states: - processing: Task is being processed. - success: Task is completed (if sending fails, it will retry the callback three times). - failed: Task failed (if sending fails, it will retry the callback three times). Vidu uses a callback signature algorithm for verification, check out the details here: Callback Signature

Field	Type	Description
id	string	Task ID generated by the vidu for this task

{
  "id": "your_job_id_here"
}

	540p	720p	1080p
standard	6 credits/s	8 credits/s	10 credits/s
high	Not supported	24 credits/s	29 credits/s

Search documentation

Search documentation