Category: provider

Model Studio EMO

Validation

CODEBLOCK0

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

Output And Evidence

• - Save normalized request payloads, detection boxes, and task polling snapshots under output/aliyun-emo/.
• Record the chosen style_level and the exact face_bbox / ext_bbox.

Use EMO when the input is a portrait image and speech audio, and you need a non-Wan expressive talking-head result.

Critical model names

Use these exact model strings:

• - INLINECODE5
• INLINECODE6

Selection guidance:

• - Run image detection first to obtain face_bbox and ext_bbox.
• Use emo-v1 only after detection succeeds.

Prerequisites

• - China mainland (Beijing) only.
• Set DASHSCOPE_API_KEY in your environment, or add dashscope_api_key to ~/.alibabacloud/credentials.
• Input files must be public HTTP/HTTPS URLs.

Normalized interface (video.emo)

Detect Request

• - model (string, optional): default INLINECODE14
• INLINECODE15 (string, required)

Generate Request

• - model (string, optional): default INLINECODE17
• INLINECODE18 (string, required)
• INLINECODE19 (string, required)
• INLINECODE20 (array, required)
• INLINECODE21 (array, required)
• INLINECODE22 (string, optional): normal, calm, or INLINECODE25

Response

• - task_id (string)
• INLINECODE27 (string)
• INLINECODE28 (string, when finished)

Quick start

CODEBLOCK1

Operational guidance

• - Do not invent face_bbox or ext_bbox; use the detection API output.
• INLINECODE31 ratio determines output format: 1:1 yields 512x512, 3:4 yields 512x704.
• Keep the input portrait clear and front-facing for better expression quality.
• EMO is portrait-focused; for full-scene human videos use other skills instead.

Output location

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

References

• - INLINECODE38