Skip to main content
圖生唱演視頻-悅動人像EMO

EMO 視頻產生 API參考

EMO模型可基於人物肖像圖片和人聲音頻，產生人臉動態視頻。

本文檔僅適用於“中國（北京）”地區。如需使用模型，需使用“中國（北京）”地區的API Key

效果樣本

輸入樣本輸出樣本
人物肖像：上春山人聲音頻：使用動作風格強度：參數 style_level 設定為 'active'。
更多效果樣本請參見模型效果樣本。
請確保上傳的圖片、音頻檔案來源符合相關法律法規，且已獲得相應內容的使用許可。

前提條件

HTTP調用

步驟1：建立任務擷取任務ID 

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis
  • 建立任務後，系統將立即返回一個 task_id，用於“步驟2”查詢任務結果。task_id 自建立起有效期間為24小時。

請求參數

要求標頭（Headers）
X-DashScope-Asyncstring（必選）非同步處理配置參數。HTTP請求只支援非同步，必須設定為enable。
缺少此要求標頭將報錯：“current user api does not support synchronous calls”。
Authorizationstring（必選）請求身份認證。介面使用阿里雲百鍊API Key進行身份認證。樣本值：Bearer sk-xxxx。Content-Typestring（必選）請求內容類型。此參數必須設定為application/json。
請求體（Request Body）
model string （必選）模型名稱。樣本值：emo-v1。input object （必選）輸入的基本資料。

屬性

image_url string （必選）使用者上傳的圖片 URL。模型將根據EMO映像檢測API返回的 ext_bbox 參數，對原始圖片進行裁剪。裁剪後地區的寬高比直接決定了輸出視頻的畫幅比例與解析度。audio_url string （必選）使用者上傳的音頻檔案 URL， 用於EMO模型推理的輸入。face_bbox 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]。
parameters object（可選）

屬性

style_level string （可選）預設值：normal可選擇動作風格強度控制人物的運動姿態和幅度，當前支援3種：normal、calm、active，分別對應人物動作風格適中、平靜、活潑。預設為normal。
curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "emo-v1",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20251225/onmomb/emo.png",
        "audio_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250825/aejgyj/input_audio.mp3",
        "face_bbox":[302,286,610,593],
        "ext_bbox":[71,9,840,778]
        },
    "parameters": {
        "style_level": "normal"
        }
    }'

響應參數

outputobject任務輸出資訊。

屬性

task_idstring提交非同步任務的任務ID，實際任務結果需要通過非同步任務查詢介面擷取。樣本值：a8532587-fa8c-4ef8-82be-xxxxxx。task_status string提交非同步任務後的任務狀態。樣本值：“PENDING”。
request_idstring請求唯一標識。可用於請求明細溯源和問題排查。code string請求失敗時返回的錯誤碼，詳情請參見狀態代碼說明。messagestring請求失敗時返回的詳細錯誤資訊，詳情請參見狀態代碼說明。
{
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "PENDING"
    },
    "request_id": "7574ee8f-38a3-4b1e-9280-11c33ab46e51"
}

步驟2：根據任務ID查詢結果

使用上一步擷取的 task_id，輪詢任務狀態和結果。請將 URL 中的{task_id} 替換為您的實際任務ID。 
GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_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_id string（必選）需要查詢任務的task_id。樣本值：a8532587-fa8c-4ef8-82be-xxxxxx。
curl -X GET \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

響應參數

request_idstring請求唯一標識。可用於請求明細溯源和問題排查。outputobject任務輸出資訊。

屬性

task_idstring查詢任務的 task_id。樣本值：a8532587-fa8c-4ef8-82be-xxxxxx。task_status string任務狀態。

枚舉值

  • PENDING：任務排隊中
  • RUNNING：任務處理中
  • SUCCEEDED：任務執行成功
  • FAILED：任務執行失敗
  • CANCELED：任務已取消
  • UNKNOWN：任務不存在或狀態未知
submit_time 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。
code string請求失敗時返回的錯誤碼，詳情請參見狀態代碼說明。messagestring請求失敗時返回的詳細錯誤資訊，詳情請參見狀態代碼說明。
usage object

屬性

video_duration float本次請求產生視頻時間長度，單位：秒，樣本值：13.93。video_ratio string本次請求產生視頻的畫幅比例，該值為1:1或3:4。
{
    "request_id": "8190395f-ca1b-4703-9656-xxxxxx",
    "output": {
        "task_id": "a8532587-fa8c-4ef8-82be-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-09-11 14:33:38.716",
        "scheduled_time": "2025-09-11 14:33:53.089",
        "end_time": "2025-09-11 14:35:51.541",
        "results": {
            "video_url": "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xxx.mp4?Expires=xxxx"
        }
    },
    "usage": {
        "video_duration": 13.93,
        "video_ratio": "1:1"
    }
}

計費與限流

模型名稱

單價

任務下發介面QPS限制

同時處理中任務數量

emo-v1

後付費，按照輸出視頻的實際時間長度計費：

  • 產生1:1畫幅比例視頻：$0.011469/秒

  • 產生3:4畫幅比例視頻：$0.022937/秒

5

1

（超出任務將排隊）

狀態代碼說明

大模型服務平台通用狀態代碼請查閱：錯誤資訊。
使用 API
文本產生
映像產生
視頻產生
音頻
即時多模態
Realtime API
  • 概述
向量與排序
更多模型
工具包/架構
模型生產
檔案管理
更多
EMO 視頻產生 API參考 - Alibaba Cloud Model Studio