EMO模型可基于人物肖像图片和人声音频，生成人脸动态视频。
效果示例
| 输入示例 | 输出示例 |
|---|---|
人物肖像： 人声音频： | 使用动作风格强度：参数 style_level 设置为 'active'。 |
请确保上传的图片、音频文件来源符合相关法律法规，且已获得相应内容的使用许可。
前提条件
- 需要开通模型服务并获取API Key，再配置API Key到环境变量。
- 输入图像必须先通过EMO图像检测API检测，并获得对应人脸区域（face_bbox）和动态区域（ext_bbox）的范围值作为入参。
HTTP调用
步骤1：创建任务获取任务ID
- 创建任务后，系统将立即返回一个
task_id，用于“步骤2”查询任务结果。task_id自创建起有效期为24小时。 - 新手指引请参见Postman。
请求参数请求头（Headers）X-DashScope-Asyncstring（必选）异步处理配置参数。HTTP请求只支持异步，必须设置为enable。Authorizationstring（必选）请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。Content-Typestring（必选）请求内容类型。此参数必须设置为application/json。请求体（Request Body）modelstring （必选）模型名称。示例值：emo-v1。若调用独立部署模型，则填入部署成功的模型名称 object （必选）输入的基本信息。
属性 image_url string （必选）用户上传的图片 URL。模型将根据EMO图像检测API返回的 ext_bbox 参数，对原始图片进行裁剪。裁剪后区域的宽高比直接决定了输出视频的画幅比例与分辨率。
string （必选）用户上传的音频文件 URL， 用于EMO模型推理的输入。
array（必选）图片中人脸区域bbox的像素坐标，应输入EMO图像检测API出参中同名字段的值。坐标格式[x1,y1,x2,y2]，分别对应左上和右下两个点的坐标。示例值：[302,286,610,593]。图像左上角为坐标原点(0,0)，x轴向右为正，y轴向下为正。ext_bbox array（必选）图片中动态区域bbox的像素坐标，应输入EMO图像检测API出参中同名字段的值。该区域的宽高比为1:1或3:4。坐标格式[x1,y1,x2,y2]，分别对应左上和右下两个点的坐标。示例值：[71,9,840,778]。object（可选）
属性 style_level string （可选）默认值：normal可选择动作风格强度控制人物的运动姿态和幅度，当前支持3种：normal、calm、active，分别对应人物动作风格适中、平静、活泼。默认为normal。 |
响应参数outputobject任务输出信息。
属性 task_id string提交异步任务的任务ID，实际任务结果需要通过异步任务查询接口获取。示例值：a8532587-fa8c-4ef8-82be-xxxxxx。task_status string提交异步任务后的任务状态。示例值：“PENDING”。string请求唯一标识。可用于请求明细溯源和问题排查。code string请求失败时返回的错误码，详情请参见状态码说明。messagestring请求失败时返回的详细错误信息，详情请参见状态码说明。 |
步骤2：根据任务ID查询结果
使用上一步获取的 task_id，轮询任务状态和结果。请将 URL 中的{task_id} 替换为您的实际任务ID。
- task_id 有效期：自创建起有效期24小时，超时后将无法查询结果，接口将返回任务状态为
UNKNOWN。 - 任务状态流转：一般正常处理的任务流转状态为 PENDING（排队中）→ RUNNING（处理中）→ SUCCEEDED（成功）/ FAILED（失败）。
- 任务结果获取：视频生成过程约需数分钟，查询接口默认QPS为20。建议配置异步任务回调获取结果，或者采用轮询方式并设置合理的查询间隔（如 15 秒）来获取结果。
- video_url 有效期：自任务成功时刻起有效期为 24 小时。建议在获取链接后立即下载并转存至永久存储（如阿里云 OSS）。
- 更多操作：如需批量查询、取消任务等操作，请参见管理异步任务。
请求参数请求头（Headers）Authorizationstring（必选）请求身份认证。接口使用阿里云百炼API Key进行身份认证。示例值：Bearer sk-xxxx。URL路径参数（Path parameters）task_idstring（必选）需要查询任务的task_id。示例值：a8532587-fa8c-4ef8-82be-xxxxxx。 |
响应参数request_idstring请求唯一标识。可用于请求明细溯源和问题排查。outputobject任务输出信息。
属性 task_id string查询任务的 task_id。示例值：a8532587-fa8c-4ef8-82be-xxxxxx。task_status string任务状态。
枚举值
string任务提交时间，时区为UTC+8，示例值：2025-09-11 14:33:38.716。scheduled_time string任务被安排计划开始执行的时间，时区为UTC+8，示例值：2025-09-11 14:33:53.089。end_time string任务执行结束时间，时区为UTC+8，示例值：2025-09-11 14:35:51.541。results object任务执行结果。
属性 video_url string平台输出的视频结果，video_url有效期为任务完成后24小时，请及时下载并保存视频文件。示例值：http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=xxxx。string请求失败时返回的错误码，详情请参见状态码说明。messagestring请求失败时返回的详细错误信息，详情请参见状态码说明。object
属性 video_duration float本次请求生成视频时长，单位：秒，示例值：13.93。video_ratio string本次请求生成视频的画幅比例，该值为1:1或3:4。 |
计费与限流
模式 | 模型名称 | 单价 | 免费额度（查看） | 任务下发接口QPS限制 | 同时处理中任务数量 |
|---|---|---|---|---|---|
调用百炼模型API | emo-v1 | 后付费，按照输出视频的实际时长计费：
| 1800秒 | 5 | 1 （超出任务将排队） |
独立部署模型 | 独立部署成功后将生成唯一的模型名称 | 预付费：
需部署成功后调用，仅收取部署费用。 | 无 | 5 | 1算力单元支持1并发 |