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	ヘッダー	はい	リクエストタイプ: application/json。	application/json
Authorization	String	ヘッダー	はい	API キー。例: Bearer d1**2a。	Bearer d1**2a
model	String	本文	はい	呼び出すモデルを指定します。ここでは liveportrait-detect を使用します。	liveportrait-detect
input.image_url	String	本文	はい	確認する画像の URL。画像ファイル < 10M、縦横比 ≤ 2、最大辺の長さ ≤ 4096。サポートされている形式: jpeg、jpg、png、bmp、webp。説明ファイルのアップロードは HTTP リンクのみサポートしています。ローカルファイルパスはサポートされていません。	"image_url": "http://a/a.jpg"

レスポンスパラメーター

パラメーター	タイプ	説明	例
output.pass	Bool	送信された画像の確認結果	"pass":true/false
output.message	String	送信された画像の確認結果情報	"message":人間の顔が検出されませんでした。
request_id	String	このリクエストの一意のシステムコード	7574ee8f-38a3-4b1e-9280-11c33ab46e51

失敗の理由

output.message	説明
人間の顔が検出されませんでした	顔が検出されませんでした (顔が小さすぎる、横顔、顔が隠れているなどの場合を含む)

リクエスト例

curl --location --request POST 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2video/face-detect' \
--header 'Authorization: Bearer <YOUR_API_KEY>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "model": "liveportrait-detect",
  "input": {
      "image_url":"http://xxx/1.jpg"
  }
}'

レスポンス例 (成功)

{
  "output":{
    "pass": true
    "message": 'success' // 成功
  },
  "usage":{
    "image_count":1
  },
  "request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}

レスポンス例 (失敗)

{
  "output":{
    "pass": false
    "message": "No human face detected." // 人間の顔が検出されませんでした。
  },
  "usage":{
    "image_count":1
  },
  "request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}

レスポンス例 (エラー)

{
  "code": "InvalidParameter.UnsupportedFileFormat", // 無効なパラメーター。サポートされていないファイル形式
  "message": "Input files format not supported.", // 入力ファイル形式はサポートされていません。
  "request_id": "788b30fe-05f6-999f-a0b1-8a37a4504499"
}

状態コード

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