Emoji视频生成API详情_大模型服务平台百炼(Model Studio)-阿里云帮助中心

表情包Emoji是一款人脸动效视频生成模型，可基于通过Emoji-detect模型检测的人物肖像图片和预设的人脸动态模板，生成人脸动效视频。

模型概览

模型名	模型简介

模型名	模型简介
emoji-v1	emoji-v1是一个人物视频生成模型，用于输入通过检测的图片、对应区域的范围值以及表情包模板id，生成表情包视频。

HTTP调用接口

功能描述

用于输入通过检测的图片、对应区域的范围值以及表情包模板id，生成表情包。

使用前提

已开通服务并获得API-KEY：获取API Key。
输入图像已通过“Emoji 图像检测API”检测，并获得对应人脸区域和动态区域的范围值作为入参。

作业提交接口调用

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis

入参描述

字段	类型	传参方式	必选	描述	示例值

字段	类型	传参方式	必选	描述	示例值
Content-Type	String	header	是	请求类型：application/json	application/json
Authorization	String	header	是	API-Key，例如：Bearer d1**2a	Bearer d1**2a
X-DashScope-Async	String	header	是	使用enable，表明使用异步方式提交作业。	enable
model	String	body	是	调用的模型 emoji-v1	emoji-v1
input.face_bbox	Array	body	是	图片中人脸区域，应输入表情包人脸检测接口出参中同名字段的值	[10,20,30,40]
input.ext_bbox	Array	body	是	图片中动态区域，应输入表情包人脸检测接口出参中同名字段的值该区域的宽高比应为1:1	[10,20,30,40]
input.image_url	String	body	是	用户上传的图片 URL，该图应先通过表情包人脸检测接口。最终用于表情包生成的图片会按input.ext_bbox所指定的区域进行裁剪。图像最小边长≥400像素，最大边长≤7000像素。格式支持：jpg、jpeg、png、bmp、webp 说明上传图片仅支持HTTP链接方式，不支持本地链接方式	https://xxx.jpg
input.driven_id	String	body	是	预置的模板id，参考本文末尾的「表情包模板id」	mengwa_kaixin

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--data '{
    "model": "emoji-v1",
    "input": {
        "image_url": "https://xxx/001.jpeg",
        "driven_id": "mengwa_kaixin",
        "face_bbox": [10, 20, 30, 40],
        "ext_bbox": [10, 20, 30, 40]
    }
}'

出参描述

字段	类型	描述	示例值

字段	类型	描述	示例值
output.task_id	String	提交异步任务的作业id，实际作业结果需要通过异步任务查询接口获取。	a7632587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	提交异步任务后的作业状态	“PENDING”
request_id	String	本次请求的唯一id	69574ee8f-38a3-4b1e-9280-11c33ab46e51

作业任务状态查询和结果获取接口

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

入参描述

字段	类型	传参方式	必选	描述	示例值
Authorization	String	header	是	API-Key，例如：Bearer d1**2a	Bearer d1**2a
task_id	String	path	是	需要查询作业的task_id	a8532587-fa8c-4ef8-82be-0c46b17950d1

出参描述

字段	类型	描述	示例值
output.task_id	String	查询作业的task_id	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	被查询作业的作业状态	任务状态： PENDING 排队中 RUNNING 处理中 SUCCEEDED 成功 FAILED 失败 UNKNOWN 作业不存在或状态未知
output.video_url	String	生成表情包视频链接	http://xxxx/xxxx.mp4
usage.video_duration	Float	输出视频时长	2.23
usage.video_ratio	String	本次请求生成视频的画幅，表情包画幅为1:1，默认值standard	standard
request_id	String	本次请求的唯一id	69574ee8f-38a3-4b1e-9280-11c33ab46e51
output.code	String	生成失败时的错误码（下附枚举值）
output.message	String	生成失败时的错误消息

请求示例

curl -X GET \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
https://dashscope.aliyuncs.com/api/v1/tasks/<YOUR_TASK_ID>

响应示例（成功）

{
    "request_id": "f580fc6f-86fb-9936-b83f-71256f49d385",
    "output": {
        "task_id": "908badb4-5621-492d-ba6e-0d093ddd054b",
        "task_status": "SUCCEEDED",
        "submit_time": "2024-09-10 10:20:35.353",
        "scheduled_time": "2024-09-10 10:20:35.395",
        "end_time": "2024-09-10 10:21:17.220",
        "video_url": "xxxx"
    },
    "usage": {
        "video_duration": 2.23
        "video_ratio": "standard"
    }
}

响应示例（失败）

{
  "request_id": "0fe17354-d1b3-9437-b80d-b88ef372b3f1",
  "output": {
    "task_id": "59d7db94-197e-4c7c-b60f-aceb144fbed0",
    "task_status": "FAILED",
    "submit_time": "2024-12-19 17:34:31.352",
    "scheduled_time": "2024-12-19 17:34:31.412",
    "end_time": "2024-12-19 17:34:31.955",
    "code": "InvalidParameter",
    "message": "Invalid bbox input, expect List or Array input with a length of 4, e.g. (x1,y1,x2,y2)"
  }
}

说明

因该算法调用耗时较长，故采用异步调用的方式提交任务。

任务提交之后，系统会返回对应的作业ID，后续可通过“作业任务状态查询和结果获取接口”获取任务状态及对应结果。

状态码说明

平台通用状态码请查阅：返回状态码说明

同时本模型还有如下特定错误码：

http 返回码*	错误码（code）	错误信息（message）	含义说明
400	InvalidParameter	Field required: image_url	缺少入参“image_url”
400	InvalidParameter	Field required: driven_id	缺少入参“driven_id”
400	InvalidParameter	Invalid ext_bbox	输入ext_bbox无效
400	InvalidParameter	Driven not exist: driven_id	输入driven_id不存在

表情包模板id

序号	模板id	生成效果参考

序号	模板id	生成效果参考
1	mengwa_kaixin
2	dagong_kaixin
3	dagong_yangwang
4	jingdian_tiaopi
5	jingdian_deyi_1
6	jingdian_qidai
7	mengwa_dengyan
8	mengwa_jidong
9	dagong_kunhuo
10	dagong_zhuakuang
11	mengwa_kun_1
12	jingdian_landuo_1
13	jingdian_xianqi
14	jingdian_lei
15	dagong_wunai
16	mengwan_gandong
17	dagong_weixiao
18	mengwa_renzhen_1
19	mengwa_jiaoxie
20	dagong_ganji

说明

以上生成效果，由集成了“表情包Emoji”的通义APP生成。
表情表Emoji模型生成的内容为人物视频，不包含贴纸和文字。