Category: provider
Model Studio Emoji
Validation
CODEBLOCK0
Pass criteria: command exits 0 and output/aliyun-emoji/validate.txt is generated.
Output And Evidence
- - Save normalized request payloads, detected face boxes, selected template ID, and task polling snapshots under
output/aliyun-emoji/. - Record the exact portrait URL and whether detection passed.
Use Emoji when the user wants a fixed-template facial animation clip rather than open-ended video generation.
Critical model names
Use these exact model strings:
Selection guidance:
- - Run
emoji-detect-v1 first to obtain face_bbox and ext_bbox_face. - Use
emoji-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 image must be a public HTTP/HTTPS URL.
Normalized interface (video.emoji)
Detect Request
- -
model (string, optional): default INLINECODE12 - INLINECODE13 (string, required)
Generate Request
- -
model (string, optional): default INLINECODE15 - INLINECODE16 (string, required)
- INLINECODE17 (array, required)
- INLINECODE18 (array, required)
- INLINECODE19 (string, required)
Response
- -
task_id (string) - INLINECODE21 (string)
- INLINECODE22 (string, when finished)
Quick start
CODEBLOCK1
Operational guidance
- - Use a single-person, front-facing portrait with no face occlusion.
- Template IDs come from the official template list or console experience; do not invent them in production calls.
- Emoji output is a person video clip, not a sticker pack or text overlay asset.
Output location
- - Default output: INLINECODE23
- Override base dir with
OUTPUT_DIR.
References
技能名称: aliyun-emoji
详细描述:
类别: 提供者
模型工作室表情动画
验证
bash
mkdir -p output/aliyun-emoji
python -m pycompile skills/ai/video/aliyun-emoji/scripts/prepareemojirequest.py && echo pycompile_ok > output/aliyun-emoji/validate.txt
通过标准: 命令退出码为0,且生成了 output/aliyun-emoji/validate.txt 文件。
输出与证据
- - 将标准化后的请求负载、检测到的人脸框、选定的模板ID以及任务轮询快照保存到 output/aliyun-emoji/ 目录下。
- 记录确切的肖像URL以及检测是否通过。
当用户想要一个固定模板的人脸动画片段,而非开放式的视频生成时,使用表情动画功能。
关键模型名称
请使用以下确切的模型字符串:
- - emoji-detect-v1
- emoji-v1
选择指南:
- - 首先运行 emoji-detect-v1 以获取 facebbox 和 extbbox_face。
- 仅在检测成功后使用 emoji-v1。
前提条件
- - 仅限中国大陆(北京)区域。
- 在您的环境中设置 DASHSCOPEAPIKEY,或者将 dashscopeapikey 添加到 ~/.alibabacloud/credentials 文件中。
- 输入图像必须是公开的 HTTP/HTTPS URL。
标准化接口 (video.emoji)
检测请求
- - model (字符串,可选): 默认为 emoji-detect-v1
- image_url (字符串,必填)
生成请求
- - model (字符串,可选): 默认为 emoji-v1
- imageurl (字符串,必填)
- facebbox (整数数组,必填)
- extbboxface (整数数组,必填)
- template_id (字符串,必填)
响应
- - taskid (字符串)
- taskstatus (字符串)
- video_url (字符串,任务完成时返回)
快速开始
bash
python skills/ai/video/aliyun-emoji/scripts/prepareemojirequest.py \
--image-url https://example.com/portrait.png \
--face-bbox 302,286,610,593 \
--ext-bbox-face 71,9,840,778 \
--template-id emoji_001
操作指南
- - 使用单人、正面、无面部遮挡的肖像照片。
- 模板ID来自官方模板列表或控制台体验;在生产调用中请勿自行编造。
- 表情动画输出的是人物视频片段,而非贴纸包或文字叠加素材。
输出位置
- - 默认输出: output/aliyun-emoji/request.json
- 可通过 OUTPUT_DIR 覆盖基础目录。
参考资料