Bangun Workflow Try-On Parsial dengan OutfitAnyone-Parsing API-Model Studio-Alibaba Cloud

OutfitAnyone-Parsing adalah model tambahan yang melakukan segmentasi area pakaian—seperti atasan, bawahan, gaun, atau jumpsuit—dari citra model atau citra yang dihasilkan oleh OutfitAnyone. Model ini bersifat opsional dan dapat digunakan bersama model OutfitAnyone untuk mencapai efek tertentu, seperti partial try-on dan memperoleh koordinat pakaian spesifik.

Penting

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

Ikhtisar model

Model	Harga	Batas laju (dibagi bersama oleh Akun Alibaba Cloud dan Pengguna RAM)
		Batas RPS untuk API pengiriman tugas	Jumlah tugas konkuren
aitryon-parsing-v1	$0,000574/citra	10	Tanpa Batas (API sinkron)

Ilustrasi output inti

Pemanggilan API ini mengembalikan tiga parameter keluaran utama. Contoh Penguraian top berikut menjelaskan makna dan penggunaan masing-masing parameter.

Input	Output
Input	Parameter output	Contoh visualisasi	Makna dan penggunaan
Citra model input Tetapkan jenis pakaian ke atasan "clothes_type": ["upper"]	crop_img_url		Citra pakaian yang dipotong (RGB): Contoh ini menunjukkan citra pakaian model yang mengenakan atasan. Digunakan sebagai parameter input untuk model OutfitAnyone dalam skenario partial try-on. URL berlaku selama 24 jam. Harap unduh dan simpan sebelum masa berlaku habis.
	parsing_img_url		Citra pakaian hasil parsing (RGBA): Contoh ini menunjukkan citra atasan yang telah diparsing. Digunakan untuk pratinjau efek dan verifikasi visual akurasi hasil parsing. URL berlaku selama 24 jam. Harap unduh dan simpan file sebelum masa berlaku habis.
	bbox	Nilai bbox: [[331, 239,641,637]] Citra ini menunjukkan pemetaan antara nilai bbox dan koordinat pada citra asli. Ini bukan output model.	Kotak pembatas: Koordinat area persegi panjang dari citra pakaian hasil parsing (parsing_img_url) dalam citra model input. Format array bbox adalah [x1, y1, x2, y2]. Ini merepresentasikan koordinat pojok kiri atas dan kanan bawah kotak pembatas. Titik origin (0,0) berada di pojok kiri atas citra model input. Digunakan untuk mengimplementasikan fitur interaktif 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. Skenario ini mengharuskan Anda melakukan parsing citra model terlebih dahulu.

Contoh: Pertahankan atasan model dan ganti bawahannya

Lakukan parsing citra model untuk mengekstrak atasan
- Panggil API parsing citra yang dijelaskan dalam topik ini, masukkan citra model asli, dan atur parameter clothes_type ke ["upper"] untuk mengekstrak atasan model.
- API mengembalikan citra pakaian (crop_img_url) yang berisi atasan tersebut.
Input: Citra model
Output: Citra pakaian hasil parsing (crop_img_url)

Hasilkan citra try-on

Panggil OutfitAnyone - Edisi Plus.
Masukkan citra model, citra atasan (diperoleh dari parsing), dan citra bawahan untuk menghasilkan citra try-on akhir.

Input

Hasil: Citra coba pakai

Citra model

Citra atasan

Citra bawah

Citra model sama dengan input untuk API parsing citra.

Parameter respons crop_img_url dari API parsing citra.

Citra pakaian yang akan diganti.

Skenario 2: Memperoleh koordinat pakaian spesifik

Tujuan: Memperoleh koordinat kotak pembatas (bbox) pakaian tertentu pada citra model atau citra try-on AI. Anda dapat menggunakan koordinat ini untuk menambahkan label produk atau membuat hotspot interaktif.

Contoh: Memperoleh koordinat atasan

Persiapkan citra input: Citra input dapat berupa citra model atau citra yang dihasilkan oleh OutfitAnyone. Untuk informasi lebih lanjut mengenai persyaratan citra input, lihat Persyaratan citra model.

Lakukan parsing citra untuk memperoleh koordinat: Tetapkan jenis parsing untuk citra input. Misalnya, atur ke ["upper"] untuk melakukan parsing dan menentukan lokasi atasan, lalu peroleh bbox area yang diperlukan.

Input: Citra model atau citra try-on

Output: Citra pakaian hasil parsing dan rentang koordinat

Parameter permintaan "clothes_type": ["upper"]

parsing_img_url: URL hasil parsing yang divisualisasikan.
bbox: Koordinat kotak pembatas area yang diparsing. Contohnya, [[331, 239, 641, 637]].

Prasyarat

API OutfitAnyone-Parsing hanya mendukung panggilan HTTP.

Buat API key, lalu atur API key sebagai variabel lingkungan.

HTTP

Titik akhir permintaan

POST https://dashscope.aliyuncs.com/api/v1/services/vision/image-process/process

Parameter permintaan

Field	Type	Passing parameters	Required	Description	Example
Content-Type	String	Header	Yes	Jenis permintaan: application/json.	application/json
Authorization	String	Header	Yes	API key. Formatnya adalah Bearer sk-xxxx.	Bearer sk-xxxx
model	String	Body	Yes	Model yang dipanggil. Atur nilainya ke aitryon-parsing-v1.	aitryon-parsing-v1
input.image_url	String	Body	Yes	URL publik citra model yang akan diparsing. Anda juga dapat memperoleh URL publik sementara di sini. Ukuran file citra harus antara 5 KB hingga 5 MB. Panjang setiap sisi citra harus antara 150 hingga 4.096 piksel. Format yang didukung: JPG, PNG, JPEG, BMP, dan HEIC. Citra harus berisi satu dan hanya satu orang utuh. Hanya tautan HTTP dan HTTPS yang didukung. Jalur lokal tidak didukung. Untuk contoh citra model, lihat Persyaratan citra model.	http://a/a.jpg
parameters.clothes_type	List[String]	Body	No	Menentukan jenis pakaian yang akan diparsing. Nilai default adalah ["upper"] (atasan). Panjang dan urutan daftar menentukan panjang dan urutan daftar URL pada output. Nilai yang valid: ["upper"]: Melakukan segmentasi pakaian atas. ["lower"]: Melakukan segmentasi pakaian bawahan. ["dress"]: Melakukan parsing gaun, jumpsuit, atau outfit lengkap. ["upper", "lower"]: Melakukan parsing atasan dan bawahan.	["upper"]

Parameter respons

Field	Type	Description	Example
output.parsing_img_url	List[String]	Daftar URL citra hasil parsing yang divisualisasikan. Panjang dan urutan sama dengan parameter permintaan clothes_type. Jika pakaian yang sesuai tidak terdeteksi, nilai pada posisi tersebut adalah None/null. Citra memiliki saluran RGBA dan disimpan dalam format PNG.	["http://a/a.png"] [null] atau [None]
output.crop_img_url	List[String]	Daftar URL citra pakaian yang dipotong. Panjang dan urutan sama dengan parameter permintaan clothes_type. Jika pakaian yang sesuai tidak ditemukan, nilai pada posisi tersebut adalah None/null. Citra dalam format RGB.	["http://a/a.png"] [null] atau [None]
output.bbox	List[Integer]	Daftar koordinat area yang diparsing dalam citra asli. Koordinat diurutkan berdasarkan urutan area yang ditentukan dalam parameter permintaan clothes_type. Setiap bbox didefinisikan sebagai [x1, y1, x2, y2]. Titik origin berada di pojok kiri atas citra input asli. Nilai-nilai tersebut merepresentasikan koordinat pojok kiri atas dan kanan bawah.	[[10,20,30,40], [50,60,70,80]]
usage.image_count	Integer	Jumlah citra yang diproses dalam permintaan.	1
request_id	String	ID unik permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

Lakukan parsing atasan dari citra model

curl --location 'https://dashscope.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 sukses (jenis pakaian yang sesuai ada)

URL dalam parsing_img_url dan crop_img_url berlaku selama 24 jam. Unduh citra tersebut dalam periode ini.

{
    "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 sukses (jenis pakaian yang sesuai 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": "The request parameter is invalid, please check the request parameter."
}

Kode error

Untuk kode status umum, lihat Pesan error.

Input: Citra model	Output: Citra pakaian hasil parsing (crop_img_url)