OutfitAnyone-Parsing は、モデル画像または OutfitAnyone で生成された画像から、トップス、ボトムス、ドレス、ジャンプスーツなどの衣服領域をセグメント化します。OutfitAnyone と組み合わせて、 部分的な試着 や 服の座標の取得 に使用します。
重要このドキュメントは China (Beijing) リージョンにのみ適用されます。モデルを使用するには、China (Beijing) リージョンの API キーを使用する必要があります。
概要
モデル | 価格 | レート制限 (アカウントと RAM ユーザーで共有) | |
|---|---|---|---|
タスク送信 API の RPS | 同時タスク数 | ||
aitryon-parsing-v1 | $0.000574 / 画像 | 10 | 無制限 (同期 API) |
主な出力
この API を呼び出すと、3 つの主な出力が返されます。以下のトップスの解析を例に、各パラメーターの意味と用途を説明します。
| 入力 | 出力 | ||
|---|---|---|---|
| 出力パラメーター | 例 | 意味と用途 | |
![]()
| crop_img_url | ![]() |
|
| parsing_img_url | ![]() |
| |
| bbox | bbox の値: [[331, 239, 641, 637]] ![]()
|
| |
シナリオ
シナリオ 1:部分的な試着
目的:モデルの服の一部 (トップスまたはボトムス) を交換し、他の部分は変更しない。最初にモデル画像を解析する必要があります。
例:モデルのトップスを保持し、ボトムスを交換する
-
モデル画像を解析してトップスを抽出する
- この API にモデル画像を指定して呼び出し、
clothes_typeを["upper"]に設定してトップスを抽出します。 - API はトップスの画像 (
crop_img_url) を返します。
入力:モデル画像
出力:解析済みの服の画像 (crop_img_url)


- この API にモデル画像を指定して呼び出し、
-
試着画像を生成する
- OutfitAnyone-Plus API リファレンス を呼び出します。
- モデル画像、解析済みのトップスの画像、ボトムスの画像を入力して、試着結果を生成します。
入力
出力:試着画像
モデル画像
トップスの画像
ボトムスの画像

解析 API の入力と同じです。

解析 API の
crop_img_urlから取得します。
交換用の服の画像。

シナリオ 2:特定の服の座標の取得
目的:モデル画像または試着画像上の特定の服の bbox 座標を取得します。座標は、製品ラベルやインタラクティブなホットスポットに使用します。
例:トップスの座標を取得する
-
入力の準備:モデル画像または OutfitAnyone で生成された画像を使用します。「OutfitAnyone-Plus API リファレンス」をご参照ください。
-
解析して座標を取得:解析タイプ (例:トップスは
["upper"]) を設定してbboxを取得します。入力:モデル画像または試着画像
出力:解析済みの服の画像と座標範囲

リクエストパラメーター "clothes_type": ["upper"]

parsing_img_url:可視化された結果の URL。bbox:バウンディングボックスの座標 (例:[[331, 239, 641, 637]])。
前提条件
OutfitAnyone-Parsing API は、HTTP 呼び出しのみをサポートしています。
API キーを取得し、API キーを環境変数として設定してください。
HTTP
リクエストエンドポイント
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/vision/image-process/process
{WorkspaceId} を実際の ワークスペース ID に置き換えてください。
リクエストパラメーター
フィールド | タイプ | 場所 | 必須 | 説明 | 例 |
|---|---|---|---|---|---|
Content-Type | String | ヘッダー | はい | リクエストのタイプ。 | application/json |
Authorization | String | ヘッダー | はい | API キー。フォーマット: | Bearer sk-xxxx |
model | String | ボディ | はい | 呼び出すモデル。 | aitryon-parsing-v1 |
input.image_url | String | ボディ | はい | 解析するモデル画像の公開 URL。こちらで一時的な URL を取得してください。
モデル画像の例については、「OutfitAnyone-Plus API リファレンス」をご参照ください。 | http://a/a.jpg |
parameters.clothes_type | List[String] | ボディ | いいえ | 解析する服のタイプ。デフォルト: 出力される URL リストと bbox リストは、このリストの長さと順序に対応します。 有効な値:
| ["upper"] |
レスポンスパラメーター
フィールド | タイプ | 説明 | 例 |
|---|---|---|---|
output.parsing_img_url | List[String] | 解析領域を可視化した画像の URL リスト。 リストは RGBA 形式の PNG 画像です。 | ["http://a/a.png"] [null] または [None] |
output.crop_img_url | List[String] | クロップされた服の画像の URL のリスト。 リストは RGB 形式です。 | ["http://a/a.png"] [null] または [None] |
output.bbox | List[List[Integer]] | 元の画像における解析領域の座標のリスト。
各 bbox: | [[10, 20, 30, 40], [50, 60, 70, 80]] |
usage.image_count | Integer | リクエストごとに処理した画像の数です。 | 1 |
request_id | String | リクエストの一意の ID。 | 7574ee8f-38a3-4b1e-9280-11c33ab46e51 |
サンプルリクエスト
モデル画像からトップスを解析する
curl --location 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/vision/image-process/process' \
--header 'Content-Type: application/json' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--data '{
"model": "aitryon-parsing-v1",
"input": {
"image_url":"https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250630/bakbqz/aitryon_parse_model.png"
},
"parameters": {
"clothes_type": ["upper"]
}
}'
サンプルレスポンス
成功時のレスポンス (対応する服のタイプが存在する場合)
parsing_img_url および crop_img_url 内の URL は 24 時間で有効期限が切れます。この期間内にダウンロードしてください。
{
"output": {
"bbox": [[331, 239, 641, 637]],
"parsing_img_url": ["http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/example_parsing_img.png?Expires=xxxx"],
"crop_img_url": ["http://dashscope-result-sh.oss-cn-shanghai.aliyuncs.com/example_crop_img.jpg?Expires=xxxx"]
},
"usage": {
"image_count": 1
},
"request_id": "b68147d6-e7d0-920f-b889-xxxxxx"
}
成功時のレスポンス (対応する服のタイプが存在しない場合)
{
"output":{
"bbox": [null],
"parsing_img_url": [null],
"crop_img_url": [null]
},
"usage":{
"image_count":1
},
"request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}
失敗時のレスポンス
{
"request_id": "1d075a37-3768-9bc9-b781-xxxx",
"code": "InvalidParameter.ClothesType",
"message": "The request parameter is invalid, please check the request parameter."
}
エラーコード
一般的なステータスコードについては、「エラーコード」をご参照ください。
