すべてのプロダクト
Search
ドキュメントセンター

Alibaba Cloud Model Studio:OutfitAnyone-Parsing API リファレンス

最終更新日:Sep 09, 2026

OutfitAnyone-Parsing は、モデル画像または OutfitAnyone で生成された画像から、トップス、ボトムス、ドレス、ジャンプスーツなどの衣服領域をセグメント化します。OutfitAnyone と組み合わせて、 部分的な試着 や 服の座標の取得 に使用します。

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

概要

モデル

価格

レート制限 (アカウントと RAM ユーザーで共有)

タスク送信 API の RPS

同時タスク数

aitryon-parsing-v1

$0.000574 / 画像

10

無制限 (同期 API)

主な出力

この API を呼び出すと、3 つの主な出力が返されます。以下のトップスの解析を例に、各パラメーターの意味と用途を説明します。

入力出力
出力パラメーター例意味と用途
1
  • 入力モデル画像
  • 服のタイプをトップスに設定

"clothes_type": ["upper"]

crop_img_url3
  • クロップされた服の画像 (RGB):モデルのトップスの服画像。
  • OutfitAnyone での部分的な試着に使用されます。
  • URL は 24 時間で有効期限が切れます。速やかにダウンロードしてください。
parsing_img_url4
  • 解析済みの服の画像 (RGBA):トップスの可視化された解析結果。
  • 解析精度のプレビューと検証に使用されます。
  • URL は 24 時間で有効期限が切れます。速やかにダウンロードしてください。
bbox

bbox の値: [[331, 239, 641, 637]]

image

この画像は、bbox の値と元の画像の座標とのマッピングを示しています。これはモデルの出力ではありません。

  • バウンディングボックス:入力画像内での、解析済みの服の矩形領域の座標です。

    • フォーマット: [x1, y1, x2, y2] (左上と右下の角)。
    • 原点: 入力画像の左上隅が (0,0)。
  • 製品のホットスポットなどのフロントエンド機能に使用されます。

シナリオ

シナリオ 1:部分的な試着

目的:モデルの服の一部 (トップスまたはボトムス) を交換し、他の部分は変更しない。最初にモデル画像を解析する必要があります。

例:モデルのトップスを保持し、ボトムスを交換する

  1. モデル画像を解析してトップスを抽出する
    • この API にモデル画像を指定して呼び出し、clothes_type を ["upper"] に設定してトップスを抽出します。
    • API はトップスの画像 (crop_img_url) を返します。

    入力:モデル画像

    出力:解析済みの服の画像 (crop_img_url)

    1

    3

  2. 試着画像を生成する

    入力

    出力:試着画像

    モデル画像

    トップスの画像

    ボトムスの画像

    1

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

    3

    解析 API の crop_img_url から取得します。

    2

    交換用の服の画像。

    5

シナリオ 2:特定の服の座標の取得

目的:モデル画像または試着画像上の特定の服の bbox 座標を取得します。座標は、製品ラベルやインタラクティブなホットスポットに使用します。

例:トップスの座標を取得する

  1. 入力の準備:モデル画像または OutfitAnyone で生成された画像を使用します。「OutfitAnyone-Plus API リファレンス」をご参照ください。

  2. 解析して座標を取得:解析タイプ (例:トップスは ["upper"]) を設定して bbox を取得します。

    入力:モデル画像または試着画像

    出力:解析済みの服の画像と座標範囲

    1

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

    4

    • 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 に設定します。

application/json

Authorization

String

ヘッダー

はい

API キー。フォーマット: Bearer sk-xxxx

Bearer sk-xxxx

model

String

ボディ

はい

呼び出すモデル。aitryon-parsing-v1 に設定します。

aitryon-parsing-v1

input.image_url

String

ボディ

はい

解析するモデル画像の公開 URL。こちらで一時的な URL を取得してください。

  • ファイルサイズ: 5 KB~5 MB。

  • 寸法: 各辺 150~4,096 ピクセル。

  • 対応フォーマット: JPG、PNG、JPEG、BMP、HEIC。

  • 画像には、全身が写った人物が 1 人のみ写っている必要があります。

  • HTTP と HTTPS のリンクにのみ対応しています。ローカルパスには対応していません。

モデル画像の例については、「OutfitAnyone-Plus API リファレンス」をご参照ください。

http://a/a.jpg

parameters.clothes_type

List[String]

ボディ

いいえ

解析する服のタイプ。デフォルト: ["upper"] (トップス)。

出力される URL リストと bbox リストは、このリストの長さと順序に対応します。

有効な値:

  • ["upper"]: 上半身の衣服。

  • ["lower"]: 下半身の衣服。

  • ["dress"]: ドレス、ジャンプスーツ、または全身の衣装。

  • ["upper", "lower"]: トップスとボトムス。

["upper"]

レスポンスパラメーター

フィールド

タイプ

説明

例

output.parsing_img_url

List[String]

解析領域を可視化した画像の URL リスト。

リストは clothes_type の長さと順序に対応します。対応する衣服が検出されない場合、リスト内の該当する位置に None / null が返されます。

RGBA 形式の PNG 画像です。

["http://a/a.png"]

[null] または [None]

output.crop_img_url

List[String]

クロップされた服の画像の URL のリスト。

リストは clothes_type の長さと順序に対応します。対応する衣服が見つからない場合、リスト内の該当する位置に None / null が返されます。

RGB 形式です。

["http://a/a.png"]

[null] または [None]

output.bbox

List[List[Integer]]

元の画像における解析領域の座標のリスト。

clothes_type の順序でソートされています。

各 bbox: [x1, y1, x2, y2] (左上と右下の角)。原点: 入力画像の左上隅。

[[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."
}

エラーコード

一般的なステータスコードについては、「エラーコード」をご参照ください。