すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Model Studio:絵文字動画生成 API リファレンス

    ドキュメントセンター

    Alibaba Cloud Model Studio:絵文字動画生成 API リファレンス

    最終更新日:Oct 25, 2025

    emoji-v1 モデルは、縦向きの画像とプリセットテンプレート ID から顔の絵文字動画を生成します。

    重要

    このドキュメントは 中国 (北京) リージョンにのみ適用されます。モデルを使用するには、中国 (北京) リージョンの API キー を使用する必要があります。

    モデルの概要

    モデル

    説明

    emoji-v1

    検出された縦向きの画像、顔と動的表情領域の座標、およびテンプレート ID から顔の動画を生成します。

    前提条件

    1. 「API キーを取得」し、「API キーを環境変数として設定」する必要があります。

    2. 絵文字画像検出 を使用して入力画像を処理し、顔領域と動的表情領域の座標を取得します。これらの座標は入力パラメーターとして必須です。

    HTTP

    動画生成には時間がかかるため (通常 1～5 分)、API は非同期呼び出しを使用します。プロセスには、タスクの作成と結果のポーリングという 2 つのコアステップが含まれます。手順は次のとおりです。

    必要な時間は、キュー内のタスク数とサービスの実行ステータスによって異なります。タスクが完了するまでお待ちください。

    ステップ 1: タスクを作成してタスク ID を取得する

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

    リクエストパラメーター

    絵文字動画の生成

    curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/video-synthesis' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'X-DashScope-Async: enable' \
--header 'Content-Type: application/json' \
--data '{
    "model": "emoji-v1",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/en-US/20250912/uopnly/emoji-image-detection.png",
        "driven_id": "mengwa_kaixin",
        "face_bbox": [212,194,460,441],
        "ext_bbox": [63,30,609,575]
    }
}'
    ヘッダー

    Content-Type string (必須)

    リクエストのコンテンツタイプ。このパラメーターを application/json に設定します。

    Authorization string (必須)

    リクエストの身分認証情報。この API は、身分認証に Model Studio API キーを使用します。例: Bearer sk-xxxx。

    X-DashScope-Async string (必須)

    非同期処理の構成パラメーター。HTTP リクエストは非同期処理のみをサポートします。このパラメーターを enable に設定する必要があります。

    重要

    このリクエストヘッダーがない場合、「current user api does not support synchronous calls」というエラーメッセージが返されます。

    リクエスト本文

    model string (必須)

    モデル名。このパラメーターを emoji-v1 に設定します。

    input object (必須)

    顔画像、顔領域、絵文字領域などの基本的な入力情報。

    プロパティ

    image_url string (必須)

    正面の顔画像の公開 URL。HTTP および HTTPS プロトコルがサポートされています。

    画像要件:

    • フォーマット: JPEG、JPG、PNG、BMP、または WEBP。

    • 解像度: 幅と高さは 400～7,000 ピクセルの範囲内である必要があります。

    • ファイルサイズ: 10 MB 以下。

    • 画像は 絵文字画像検出 に合格する必要があります。

    例: https://help-static-aliyun-doc.aliyuncs.com/xxx.png。

    face_bbox array of integer (必須)

    画像内の顔領域の座標。フォーマットは [x1, y1, x2, y2] (ピクセル単位) で、左上と右下の点に対応します。

    このパラメーターを 絵文字画像検出 API 応答の output.bbox_face フィールドの値に設定します。

    例: [212,194,460,441]。

    ext_bbox array of integer (必須)

    動的表情領域の座標。この領域の縦横比は約 1:1 です。フォーマットは [x1, y1, x2, y2] (ピクセル単位) で、左上と右下の点に対応します。

    このパラメーターを 絵文字画像検出 API 応答の output.ext_bbox_face フィールドの値に設定します。

    例: [63,30,609,575]。

    注: 動的表情領域は、動画生成中にモデルがフォーカスする正方形の領域です。通常、顔領域よりわずかに大きく、自然なアニメーション効果を確保するために、背景と肩の一部が含まれます。

    driven_id string (必須)

    プリセットテンプレートの ID。有効な値のリストについては、「付録: テンプレート ID のリスト」をご参照ください。

    例: mengwa_kaixin。

    応答パラメーター

    成功応答

    task_id を保存して、タスクのステータスと結果をクエリします。

    {
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

    エラー応答

    タスクの作成に失敗しました。詳細については、「エラーメッセージ」をご参照ください。

    {
    "code":"InvalidApiKey",
    "message":"Invalid API-key provided.",
    "request_id":"fb53c4ec-1c12-4fc4-a580-xxxxxx"
}

    output object

    タスクの出力情報。

    プロパティ

    task_id string

    タスク ID。クエリは 24 時間有効です。

    task_status string

    タスクのステータス。

    列挙

    • PENDING

    • RUNNING

    • SUCCEEDED

    • FAILED

    • CANCELED

    • UNKNOWN

    request_id string

    一意のリクエスト ID。この ID を使用して、問題を追跡およびトラブルシューティングできます。

    code string

    失敗したリクエストのエラーコード。リクエストが成功した場合、このパラメーターは返されません。詳細については、「エラーメッセージ」をご参照ください。

    message string

    失敗したリクエストの詳細情報。リクエストが成功した場合、このパラメーターは返されません。詳細については、「エラーメッセージ」をご参照ください。

    ステップ 2: タスク ID で結果をクエリする

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

    説明

    • ポーリングの提案: 動画の生成には数分かかります。ポーリングメカニズムを使用し、15 秒などの妥当なクエリ間隔を設定して結果を取得してください。

    • タスクのステータスの推移: PENDING (キュー内) → RUNNING (処理中) → SUCCEEDED (成功) または FAILED (失敗)。

    • 結果のリンク: タスクが成功すると、動画リンクが返されます。リンクは 24 時間有効です。リンクを取得したら、すぐに動画をダウンロードして、Alibaba Cloud OSS などの永続的なストレージサービスに保存してください。

    • task_id の有効期間: 24 時間。この期間を過ぎると、結果をクエリできなくなり、API は UNKNOWN のタスクステータスを返します。

    リクエストパラメーター

    タスク結果のクエリ

    86ecf553-d340-4e21-xxxxxxxxx を実際のタスク ID に置き換えます。

    シンガポールリージョンと北京リージョンの API キーは異なります。「API キーを取得」してください。
    次のコードは、シンガポールリージョンの base_url を提供します。北京リージョンのモデルを使用する場合は、base_url を https://dashscope.aliyuncs.com/api/v1/tasks/{task_id} に置き換えてください
    curl -X GET https://dashscope-intl.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
    ヘッダー

    Authorization string (必須)

    リクエストの身分認証情報。この API は、身分認証に Model Studio API キーを使用します。例: Bearer sk-xxxx。

    URL パスパラメーター

    task_id string (必須)

    タスク ID。

    応答パラメーター

    タスク成功

    動画 URL は 24 時間のみ保持され、この期間が過ぎると自動的にパージされます。生成された動画は速やかに保存する必要があります。

    {
    "request_id": "ad225054-6c94-47e5-9356-xxxxxxx",
    "output": {
        "task_id": "b56f509a-3ea9-4cfe-848d-xxxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-10-14 11:28:04.372",
        "scheduled_time": "2025-10-14 11:28:04.400",
        "end_time": "2025-10-14 11:29:03.924",
        "video_url": "http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/xx.mp4?Expires=xxx"
    },
    "usage": {
        "video_duration": 2,
        "video_ratio": "standard"
    }
}

    タスク失敗

    タスクが失敗した場合、task_status は FAILED に設定され、エラーコードとメッセージが提供されます。詳細については、「エラーメッセージ」をご参照ください。

    {
    "request_id": "e5d70b02-ebd3-98ce-9fe8-759d7d7b107d",
    "output": {
        "task_id": "86ecf553-d340-4e21-af6e-a0c6a421c010",
        "task_status": "FAILED",
        "code": "InvalidParameter",
        "message": "The size is not match xxxxxx"
    }
}

    タスククエリの期限切れ

    task_id は 24 時間有効です。この期間を過ぎると、クエリは失敗し、次のエラーメッセージが返されます。

    {
    "request_id": "a4de7c32-7057-9f82-8581-xxxxxx",
    "output": {
        "task_id": "502a00b1-19d9-4839-a82f-xxxxxx",
        "task_status": "UNKNOWN"
    }
}

    output object

    タスクの出力情報。

    プロパティ

    task_id string

    タスク ID。クエリは 24 時間有効です。

    task_status string

    タスクのステータス。

    列挙

    • PENDING

    • RUNNING

    • SUCCEEDED

    • FAILED

    • CANCELED

    • UNKNOWN

    ポーリング中のステータスの推移:

    • PENDING (キュー内) → RUNNING (処理中) → SUCCEEDED (成功) または FAILED (失敗)。

    • 最初のクエリのステータスは通常 PENDING (キュー内) または RUNNING (処理中) です。

    • ステータスが SUCCEEDED に変わると、応答には生成された動画の URL が含まれます。

    • ステータスが FAILED の場合は、エラーメッセージを確認してリトライしてください。

    submit_time string

    タスクが送信された時刻。フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。

    scheduled_time string

    タスクの実行が開始された時刻。フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。

    end_time string

    タスクが完了した時刻。フォーマットは YYYY-MM-DD HH:mm:ss.SSS です。

    video_url string

    動画 URL。このパラメーターは、task_status が SUCCEEDED の場合にのみ返されます。

    リンクは 24 時間有効です。この URL を使用して動画をダウンロードできます。動画は H.264 エンコーディングの MP4 フォーマットです。

    code string

    失敗したリクエストのエラーコード。リクエストが成功した場合、このパラメーターは返されません。詳細については、「エラーメッセージ」をご参照ください。

    message string

    失敗したリクエストの詳細情報。リクエストが成功した場合、このパラメーターは返されません。詳細については、「エラーメッセージ」をご参照ください。

    usage object

    出力の使用状況統計。成功したタスクのみがカウントされます。

    プロパティ

    video_duration integer

    生成された動画の長さ (秒単位)。

    課金数式: コスト = 動画の長さ (秒) × 単価。

    video_ratio string

    生成された動画の縦横比。`standard` に固定されており、1:1 の縦横比を示します。

    request_id string

    一意のリクエスト ID。この ID を使用して、問題を追跡およびトラブルシューティングできます。

    課金とレート制限

    • 無料クォータと単価については、「モデルと価格」をご参照ください。

    • レート制限については、「レート制限」をご参照ください。

    エラーコード

    モデルの呼び出しが失敗し、エラーメッセージが返された場合、問題の解決方法については、「エラーメッセージ」をご参照ください。

    付録: テンプレート ID のリスト

    パラメーター設定の例: { "input": { "driven_id": "mengwa_kaixin" } }。

    説明

    • 以下の効果は、絵文字モデルを統合した Tongyi アプリによって生成されます。

    • 絵文字モデルは、ステッカーやテキストを含まない縦向きの動画を生成します。

    テンプレート ID (driven_id)

    効果プレビュー

    テンプレート ID (driven_id)

    効果プレビュー

    mengwa_kaixin

    1_mengwa_kaixin

    dagong_zhuakuang

    10_dagong_zhuakuang

    mengwa_dengyan

    7_mengwa_dengyan

    dagong_wunai

    15_dagong_wunai

    mengwa_gandong

    16_mengwan_gandong

    dagong_weixiao

    17_dagong_weixiao

    mengwa_renzhen_1

    18_mengwa_renzhen_1

    dagong_ganji

    20_dagong_ganji

    mengwa_jidong

    8_mengwa_jidong

    jingdian_tiaopi

    4_jingdian_tiaopi

    mengwa_kun_1

    11_mengwa_kun_1

    jingdian_deyi_1

    5_jingdian_deyi_1

    mengwa_jiaoxie

    19_mengwa_renzhen_1

    jingdian_qidai

    6_jingdian_qidai

    dagong_kaixin

    2_dagong_kaixin

    jingdian_landuo_1

    12_jingdian_landuo_1

    dagong_yangwang

    3_dagong_yangwang

    jingdian_xianqi

    13_jingdian_xianqi

    dagong_kunhuo

    9_dagong_kunhuo

    jingdian_lei

    14_jingdian_lei