Category: provider

Model Studio VideoRetalk

Validation

CODEBLOCK0

Pass criteria: command exits 0 and output/aliyun-videoretalk/validate.txt is generated.

Output And Evidence

• - Save normalized request payloads, target face selection settings, and task polling snapshots under output/aliyun-videoretalk/.
• Record the exact video/audio input URLs and whether video_extension was enabled.

Use VideoRetalk when the input is already a person video and the job is to replace lip sync with a new speech track.

Critical model names

Use this exact model string:

• - INLINECODE3

Prerequisites

• - This model currently only supports China mainland (Beijing).
• API is HTTP async only; there is no online console experience.
• Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials.

Normalized interface (video.retalk)

Request

• - model (string, optional): default INLINECODE8
• INLINECODE9 (string, required)
• INLINECODE10 (string, required)
• INLINECODE11 (string, optional): target face when input video contains multiple faces
• INLINECODE12 (bool, optional): extend video to match longer audio
• INLINECODE13 (int, optional): 120 to INLINECODE15

Response

• - task_id (string)
• INLINECODE17 (string)
• INLINECODE18 (string, when finished)
• INLINECODE19 (object, optional)

Endpoint and execution model

• - Submit task: INLINECODE20
• Poll task: INLINECODE21
• HTTP calls are async only and must set header X-DashScope-Async: enable.

Quick start

CODEBLOCK1

Operational guidance

• - Keep input videos front-facing and close enough for stable face tracking.
• If the video contains multiple faces, provide ref_image_url to anchor the intended target.
• If the new audio is longer than the input video, decide explicitly whether to extend the picture track or truncate the audio.
• URLs must be public HTTP/HTTPS links; local file paths are not accepted by the API.

Output location

• - Default output: INLINECODE24
• Override base dir with OUTPUT_DIR.

References

• - INLINECODE26