すべてのプロダクト
Search

このプロダクト

    Alibaba Cloud Model Studio:絵文字画像検出 API リファレンス

    ドキュメントセンター

    Alibaba Cloud Model Studio:絵文字画像検出 API リファレンス

    最終更新日:Oct 25, 2025

    emoji-detect-v1 は、画像の適合性検出に使用されます。入力画像内の人物が Emoji モデルの要件を満たしているかどうかをチェックします。画像が検出に合格した場合、モデルは顔領域と拡張された動的領域の座標を出力します。

    重要

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

    モデルの概要

    モデル

    説明

    emoji-detect-v1

    絵文字動画生成に必要な仕様を入力画像が満たしているかを検出します。
    検出に合格した場合、モデルは動画生成で使用するために、顔領域 (bbox_face) と拡張された動的表情領域 (ext_bbox_face) の座標を出力します。

    入力画像の要件

    適合画像の例 (検出合格)

    画像の要件

    適合例

    • 正面を向いた単一の人物画像

    • 顔が隠れていない (手、髪、アクセサリーなどで)

    • 自然な表情、誇張された表情ではない

    • 頭がまっすぐ、大きく傾いていない

    image.png

    不適合画像の例 (検出失敗)

    顔の近くに手が見える

    顔が隠れている

    誇張された表情

    頭の過度な傾き

    image.png

    image.png

    image.png

    image.png

    前提条件

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

    HTTP

    POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect

    リクエストパラメーター

    人物画像の適合性検出

    curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "emoji-detect-v1",
    "input": {
        "image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250912/uopnly/emoji-image-detection.png"
    },
    "parameters": {
        "ratio":"1:1"
    }
  }'
    リクエストヘッダー

    Content-Type string (必須)

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

    Authorization string (必須)

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

    リクエストボディ

    model string (必須)

    モデル名。このパラメーターを emoji-detect-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。

    parameters object (必須)

    画像編集パラメーター。

    プロパティ

    ratio string (必須)

    検出する領域の縦横比。絵文字動画生成の場合、このパラメーターを 1:1 に設定します。

    例: 1:1。

    応答パラメーター

    検出合格

    リクエストが成功し、検出に合格した場合、リクエストは課金されます。API は応答で usage.image_count を返します。

    返された bbox_face と ext_bbox_face の値を保存します。これらの値は、後続の 絵文字動画生成の input.face_bbox および input.ext_bbox パラメーターに使用されます。

    {
    "output": {
        "bbox_face": [212,194,460,441],
        "ext_bbox_face": [63,30,609,575]   
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "78becbc4-f7f7-41ea-9e38-xxxxxx"
}

    検出失敗

    リクエストは成功したが顔検出に失敗した場合、リクエストは課金され、API は応答で usage.image_count を返します。問題をトラブルシューティングするには、「エラーメッセージ」をご参照ください。

    {
    "output": {
        "code": "InvalidFile.FacePose",
        "message": "The pose of the detected face is invalid, please upload other image with the expected oriention."
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "ed0d0d8f-e55a-4144-b855-xxxxxx"
}

    リクエスト失敗

    API リクエストが失敗した場合、課金は発生せず、API は usage.image_count を返しません。エラーを解決するには、「エラーメッセージ」をご参照ください。

    {
    "request_id": "5e1fefbd-fa7a-4e59-82a0-xxxxxx",
    "code": "InvalidParameter",
    "message": "Required body invalid, please check the request body format."
}

    output object

    タスクの出力情報。

    プロパティ

    bbox_face array of integer

    検出された顔領域の座標。フォーマットはピクセル単位の [x1, y1, x2, y2] で、左上と右下の点に対応します。このパラメーターは、検出に合格した場合にのみ返されます。

    この値は、絵文字動画生成 API の input.face_bbox パラメーターに使用します。

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

    ext_bbox_face array of integer

    拡張された動的表情領域の座標。フォーマットはピクセル単位の [x1, y1, x2, y2] で、左上と右下の点に対応します。このパラメーターは、検出に合格した場合にのみ返されます。

    この値は、絵文字動画生成 API の input.ext_bbox パラメーターに使用します。

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

    code string

    チェックが失敗した場合に返されるエラーコード。詳細については、「エラーメッセージ」をご参照ください。

    message string

    チェックが失敗した場合に返されるエラーメッセージ。詳細については、「エラーメッセージ」をご参照ください。

    request_id string

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

    usage object

    出力統計。

    プロパティ

    image_count integer

    リクエストで検出された画像の数。値は 1 で、課金に使用されます。
    リクエストが成功した場合、検出が合格したかどうかに関係なく、リクエストは課金されます。リクエストが失敗した場合は課金されません。課金の詳細については、「モデルの価格」をご参照ください。

    説明

    画像が不適合のために検出に失敗した場合でも、モデルは完全な検出プロセスを完了したため、API 呼び出しは課金されます。

    message string

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

    request_id string

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

    課金とレート制限

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

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

    エラーコード

    モデルの呼び出しが失敗し、エラーメッセージが返された場合のトラブルシューティングソリューションについては、「エラーメッセージ」をご参照ください。