LivePortrait 画像検出 API - Alibaba Cloud Model Studio - Alibaba Cloud ドキュメントセンター

liveportrait-detect モデルは、入力されたポートレート画像が LivePortrait モデルで要求される仕様を満たしているか検証します。このドキュメントでは、このモデルの画像検出機能の API を呼び出す方法について説明します。

重要

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

モデル概要

モデル	説明
liveportrait-detect	liveportrait-detect は、入力画像が liveportrait モデルで要求されるポートレート画像の仕様を満たしているかどうかをチェックするために使用される、特殊な画像検出モデルです。

HTTP

機能説明

このモデルは、入力画像が LivePortrait 動画生成に必要なポートレート画像の仕様を満たしているかどうかを検出します。

前提条件

Alibaba Cloud Model Studio を有効化し、API キーを作成済みであること。詳細は、「API キーの作成」をご参照ください。

入力制限

サポートされている画像フォーマット：JPEG、JPG、PNG、BMP、WebP。
画像ファイルは 10 MB 未満、アスペクト比が 2 以下、最大辺長が 4096 ピクセルである必要があります。
画像は HTTP リンクを使用してアップロードする必要があります。ローカルファイルパスはサポートされていません。

タスクの送信

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

リクエストパラメーター

フィールド	型	パラメーター渡し	必須	説明	例
Content-Type	String	Header	はい	リクエストのタイプ。application/json に設定します。	application/json
Authorization	String	Header	はい	API キー。例：Bearer d1**2a。	Bearer d1**2a
model	String	Body	はい	呼び出すモデル。liveportrait-detect に設定します。	liveportrait-detect
input.image_url	String	Body	はい	チェックする画像の URL。画像ファイルは 10 MB 未満、アスペクト比が 2 以下、最大辺長が 4096 ピクセルである必要があります。サポートされているフォーマット：JPEG、JPG、PNG、BMP、WebP。説明ファイルのアップロードは HTTP または HTTPS リンクのみをサポートしており、ローカルファイルパスはサポートしていません。	"image_url": "http://a/a.jpg"

レスポンスパラメーター

フィールド	型	説明	例
output.pass	Bool	送信された画像のチェック結果。	"pass":true/false
output.message	String	送信された画像のチェック結果を説明するメッセージ。	"message":No human face detected.
request_id	String	リクエストの一意の ID。	7574ee8f-38a3-4b1e-9280-11c33ab46e51

失敗理由

output.message	説明
No human face detected	人間の顔が検出されませんでした。顔が小さすぎる、横顔である、または遮られている場合に発生する可能性があります。

リクエストの例

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-raw '{
  "model": "liveportrait-detect",
  "input": {
      "image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250911/ynhjrg/p874909.png"
  }
}'

レスポンスの例 (成功)

{
    "output": {
        "pass": true,
        "message": ""
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "a92e2ffd-9263-44ba-92c5-xxxxxx"
}

レスポンスの例 (失敗)

{
    "output": {
        "pass": false,
        "message": "No human face detected."
    },
    "usage": {
        "image_count": 1
    },
    "request_id": "c56f62df-724e-9c19-96bd-xxxxxx"
}

レスポンスの例 (エラー)

{
    "code": "InvalidParameter.UnsupportedFileFormat",
    "message": "Input files format not supported.",
    "request_id": "788b30fe-05f6-999f-a0b1-xxxxxx"
}

エラーコード

一般的なエラーコードについては、「エラーメッセージ」をご参照ください。