Referensi API Parsing Gambar OutfitAnyone - Alibaba Cloud Model Studio

OutfitAnyone-Parsing memisahkan area pakaian—seperti atasan, bawahan, gaun, atau jumpsuit—dari gambar model atau gambar yang dihasilkan oleh OutfitAnyone. Gunakan bersama OutfitAnyone untuk partial try-on atau untuk mendapatkan koordinat pakaian .

PentingDokumen ini hanya berlaku untuk wilayah China (Beijing). Untuk menggunakan model ini, Anda harus menggunakan API key dari wilayah China (Beijing).

Ikhtisar

Model	Harga	Batas laju (dibagi oleh akun dan Pengguna RAM)
Model	Harga	RPS untuk API pengiriman tugas	Tugas konkuren
aitryon-parsing-v1	$0,000574/gambar	10	Tanpa Batas (API sinkron)

Output inti

Pemanggilan API ini menghasilkan tiga output inti. Contoh penguraian top berikut menjelaskan makna dan penggunaan setiap parameter.

Input	Output
Input	Parameter output	Contoh	Makna dan penggunaan
Input gambar model Tetapkan jenis pakaian ke atasan "clothes_type": ["upper"]	crop_img_url		Gambar pakaian yang dipotong (RGB): Gambar atasan dari model. Digunakan untuk partial try-on dengan OutfitAnyone. URL kedaluwarsa dalam 24 jam. Unduh segera.
	parsing_img_url		Gambar pakaian hasil parsing (RGBA): Hasil parsing visual dari atasan. Digunakan untuk pratinjau dan verifikasi akurasi parsing. URL kedaluwarsa dalam 24 jam. Unduh segera.
	bbox	nilai bbox: [[331, 239,641,637]] Gambar ini menunjukkan pemetaan antara nilai bbox dan koordinat gambar asli. Ini bukan output model.	Bounding box: Koordinat area persegi panjang pakaian hasil parsing pada gambar input. Format: [x1, y1, x2, y2] (sudut kiri atas dan kanan bawah). Origin: (0,0) di sudut kiri atas gambar input. Digunakan untuk fitur antarmuka depan seperti hotspot produk.

Skenario

Skenario 1: Partial try-on

Tujuan: Mengganti sebagian pakaian model (atasan atau bawahan) sambil mempertahankan bagian lainnya tetap tidak berubah. Parsing gambar model diperlukan terlebih dahulu.

Contoh: Pertahankan atasan model dan ganti bawahannya

Uraikan gambar model untuk mengekstrak bagian teratas
- Panggil API ini dengan gambar model dan atur clothes_type ke ["upper"] untuk mengekstrak atasan.
- API mengembalikan gambar teratas (crop_img_url).
Input: Gambar model
Output: Gambar pakaian hasil parsing (crop_img_url)
Hasilkan gambar try-on
- Panggil Referensi API OutfitAnyone-Plus.
- Masukkan gambar model, gambar atasan hasil parsing, dan gambar bawahan untuk menghasilkan hasil try-on.
Input
Output: Gambar try-on
Gambar model
Gambar Atas
Gambar bawahan

Sama dengan input API parsing.

Dari crop_img_url API parsing.

Gambar pakaian pengganti.

Input	Output: Gambar try-on
Sama dengan input API parsing.	Dari crop_img_url API parsing.	Gambar pakaian pengganti.

Skenario 2: Mendapatkan koordinat pakaian tertentu

Tujuan: Mendapatkan koordinat bbox pakaian tertentu pada gambar model atau gambar try-on. Gunakan koordinat tersebut untuk label produk atau hotspot interaktif.

Contoh: Mendapatkan koordinat sebuah puncak

Siapkan input: Gunakan gambar model atau gambar yang dihasilkan oleh OutfitAnyone. Lihat Referensi API OutfitAnyone-Plus.

Parsing untuk mendapatkan koordinat: Tetapkan jenis parsing (misalnya, ["upper"] untuk atasan) untuk mendapatkan bbox.

Input: Gambar model atau gambar try-on	Output: Gambar pakaian hasil parsing dan rentang koordinat
Parameter permintaan "clothes_type": ["upper"]	parsing_img_url: URL hasil visualisasi. bbox: Koordinat bounding box (misalnya, [[331, 239, 641, 637]]).

Input: Gambar model atau gambar try-on

Output: Gambar pakaian hasil parsing dan rentang koordinat

Parameter permintaan "clothes_type": ["upper"]

parsing_img_url: URL hasil visualisasi.
bbox: Koordinat bounding box (misalnya, [[331, 239, 641, 637]]).

Prasyarat

API OutfitAnyone-Parsing hanya mendukung panggilan HTTP.

Dapatkan API key dan tetapkan API key sebagai variabel lingkungan.

HTTP

Titik akhir permintaan

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/vision/image-process/process

Ganti {WorkspaceId} dengan ID ruang kerja Anda yang sebenarnya.

Parameter permintaan

Field	Tipe	Lokasi	Wajib	Deskripsi	Contoh
Content-Type	String	Header	Ya	Jenis permintaan. Atur ke application/json.	application/json
Authorization	String	Header	Ya	Kunci API. Format: Bearer sk-xxxx	Bearer sk-xxxx
model	String	Body	Ya	Model yang dipanggil. Atur ke aitryon-parsing-v1.	aitryon-parsing-v1
input.image_url	String	Body	Ya	URL publik gambar model yang akan diparsing. Dapatkan URL sementara di sini. Ukuran file: 5 KB hingga 5 MB. Dimensi: 150 hingga 4.096 piksel per sisi. Format yang didukung: JPG, PNG, JPEG, BMP, dan HEIC. Gambar harus berisi tepat satu orang utuh. Hanya tautan HTTP dan HTTPS yang didukung. Jalur lokal tidak didukung. Untuk contoh gambar model, lihat Referensi API OutfitAnyone-Plus.	http://a/a.jpg
parameters.clothes_type	List[String]	Body	Tidak	Jenis pakaian yang akan diparsing. Default: ["upper"] (atasan). Panjang dan urutan daftar menentukan daftar URL output. Nilai yang valid: ["upper"]: Pakaian atas. ["lower"]: Pakaian bawahan. ["dress"]: Gaun, jumpsuit, atau pakaian lengkap. ["upper", "lower"]: Atasan dan bawahan.	["upper"]

Parameter respons

Field	Tipe	Deskripsi	Contoh
output.parsing_img_url	List[String]	Daftar URL untuk area hasil parsing yang divisualisasikan. Daftar sesuai dengan panjang dan urutan clothes_type. Mengembalikan None/null pada posisi jika pakaian terkait tidak terdeteksi. Gambar RGBA dalam format PNG.	["http://a/a.png"] [null] atau [None]
output.crop_img_url	List[String]	Daftar URL untuk gambar pakaian yang dipotong. Daftar sesuai dengan panjang dan urutan clothes_type. Mengembalikan None/null pada posisi jika pakaian terkait tidak ditemukan. Format RGB.	["http://a/a.png"] [null] atau [None]
output.bbox	List[List[Integer]]	Daftar koordinat untuk area hasil parsing pada gambar asli. Diurutkan berdasarkan urutan clothes_type. Setiap bbox: [x1, y1, x2, y2] (sudut kiri atas dan kanan bawah). Origin: sudut kiri atas gambar input.	[[10,20,30,40], [50,60,70,80]]
usage.image_count	Integer	Jumlah gambar yang diproses per permintaan.	1
request_id	String	ID unik permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

Uraikan atasan dari gambar model

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"]
  }
}'

Contoh respons

Respons berhasil (jenis pakaian terkait ada)

URL dalam parsing_img_url dan crop_img_url kedaluwarsa dalam 24 jam. Unduh dalam periode tersebut.

{
    "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"
}

Respons berhasil (jenis pakaian terkait tidak ada)

{
    "output":{
        "bbox":[null],
        "parsing_img_url":[null],
        "crop_img_url":[null]
    },
    "usage":{
        "image_count":1
    },
    "request_id":"c56f62df-724e-9c19-96bd-308627cf5262"
}

Respons gagal

{
    "request_id": "1d075a37-3768-9bc9-b781-xxxx",
    "code": "InvalidParameter.ClothesType",
    "message": "Parameter permintaan tidak valid, harap periksa parameter permintaan."
}

Kode error

Untuk kode status umum, lihat Kode error.