aliyun-emo
Use when generating expressive portrait videos from a person image and speech audio with Alibaba Cloud Model Studio EMO (`emo-v1`). Use when creating non-Wan avatar clips with stronger expression style control from a detected portrait image.
How do I install this agent skill?
npx skills add https://github.com/cinience/alicloud-skills --skill aliyun-emoIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a legitimate integration for Alibaba Cloud's EMO portrait video generation service, including a script for request formatting and standard configuration guidance. No security issues were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Category: provider
Model Studio EMO
Validation
mkdir -p output/aliyun-emo
python -m py_compile skills/ai/video/aliyun-emo/scripts/prepare_emo_request.py && echo "py_compile_ok" > output/aliyun-emo/validate.txt
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_leveland the exactface_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:
emo-v1-detectemo-v1
Selection guidance:
- Run image detection first to obtain
face_bboxandext_bbox. - Use
emo-v1only after detection succeeds.
Prerequisites
- China mainland (Beijing) only.
- Set
DASHSCOPE_API_KEYin your environment, or adddashscope_api_keyto~/.alibabacloud/credentials. - Input files must be public HTTP/HTTPS URLs.
Normalized interface (video.emo)
Detect Request
model(string, optional): defaultemo-v1-detectimage_url(string, required)
Generate Request
model(string, optional): defaultemo-v1image_url(string, required)audio_url(string, required)face_bbox(array<int>, required)ext_bbox(array<int>, required)style_level(string, optional):normal,calm, oractive
Response
task_id(string)task_status(string)video_url(string, when finished)
Quick start
python skills/ai/video/aliyun-emo/scripts/prepare_emo_request.py \
--image-url "https://example.com/portrait.png" \
--audio-url "https://example.com/speech.mp3" \
--face-bbox 302,286,610,593 \
--ext-bbox 71,9,840,778 \
--style-level active
Operational guidance
- Do not invent
face_bboxorext_bbox; use the detection API output. ext_bboxratio determines output format:1:1yields512x512,3:4yields512x704.- 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:
output/aliyun-emo/request.json - Override base dir with
OUTPUT_DIR.
References
references/sources.md
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/cinience/alicloud-skills/aliyun-emo">View aliyun-emo on skillZs</a>