Cara memanggil API OutfitAnyone-Plus - Alibaba Cloud Model Studio

Dibandingkan dengan Edisi Dasar OutfitAnyone, aitryon-plus menawarkan performa unggul dalam definisi citra, tekstur kain, dan pemulihan logo. Namun, waktu generasinya lebih lama, sehingga lebih cocok untuk skenario yang mengutamakan hasil berkualitas tinggi daripada performa real-time.

Penting

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

Kemampuan model

Try-on pakaian ganda

Try-on atasan tunggal: Model secara acak menghasilkan bawahan atau mempertahankan bawahan asli model.
Try-on bawahan tunggal: Model secara acak menghasilkan atasan atau mempertahankan atasan asli model.
Coba pakai kombinasi atasan dan bawahan: Mengganti seluruh pakaian.
Try-on gaun atau jumpsuit

Kontrol granular halus

Kebijakan wajah: Anda dapat memilih untuk mempertahankan wajah asli model atau menghasilkan wajah baru secara acak.
Tentukan resolusi: Anda dapat menentukan dimensi citra output atau mempertahankannya sama seperti citra asli.

Ikhtisar model

Pengenalan model

Model	Harga penagihan	Pembatasan laju (dibagi oleh Akun Alibaba Cloud dan Pengguna RAM)
		Batas RPS API pengiriman tugas	Jumlah tugas konkuren
aitryon-plus	$0,071677/citra	10	5

Peragaan performa

Masukkan foto model full-body menghadap depan

Masukkan citra flat-lay pakaian

Citra try-on yang dihasilkan

test_client_tryon

Citra flat-lay atasan

test_client_tryon

Citra flat-lay bawahan

Persyaratan citra input

Input berkualitas tinggi menjamin output berkualitas tinggi. Sebelum memanggil API, pastikan citra Anda memenuhi spesifikasi berikut.

Persyaratan citra model

Kategori persyaratan	Detail
Persyaratan citra	Ukuran file: Antara 5 KB dan 5 MB Resolusi: Lebar dan tinggi citra harus antara 150px dan 4096px. Format citra: JPG, JPEG, PNG, BMP, dan HEIC didukung. Persyaratan tautan: Citra yang diunggah harus berupa alamat HTTP atau HTTPS yang dapat diakses publik. Jalur lokal tidak didukung.
Persyaratan model	Persyaratan orang: Mendukung citra orang dengan jenis kelamin, warna kulit, dan usia berbeda (6 tahun ke atas). Persyaratan pose: Foto full-body menghadap depan dengan pencahayaan baik. Tangan orang tersebut harus sepenuhnya terlihat. Hindari pose dengan lengan disilangkan atau terhalang. Persyaratan orang: Citra harus berisi hanya satu orang lengkap.

Contoh citra orang yang valid

Contoh citra orang yang tidak valid

❌ Banyak orang

❌ Bukan foto full-body menghadap depan

(Hindari foto samping, duduk, berbaring, atau setengah badan)

❌ Orang atau pakaian terhalang

(Hindari memegang benda, tas, dll.)

❌ Pencahayaan buruk atau citra buram

Persyaratan citra pakaian

Kategori persyaratan	Rincian
Persyaratan citra	Ukuran file: Antara 5 KB dan 5 MB Resolusi: Lebar dan tinggi citra harus antara 150px dan 4096px. Format citra: JPG, JPEG, PNG, BMP, dan HEIC didukung. Persyaratan tautan: Citra yang diunggah harus berupa alamat HTTP atau HTTPS yang dapat diakses publik. Jalur lokal tidak didukung.
Persyaratan pakaian	Jenis pakaian: Mendukung atasan tunggal, bawahan tunggal, dan gaun. Mendukung setelan dan kombinasi atasan-bawahan. Kategori pakaian: Mendukung kategori pakaian umum. Tidak mendukung pakaian dalam, gaun pengantin, atau kostum etnis khusus. Persyaratan pakaian: Pakaian tunggal: Citra harus berupa foto flat-lay yang hanya berisi satu potong pakaian. Tanpa lipatan atau halangan: Pakaian harus direntangkan, rata, dan bebas dari kerutan atau lipatan. Latar belakang sederhana dan bersih: Latar belakang citra harus sederhana, bersih, dan berwarna seragam. Pakaian utama harus jelas, tanpa pencahayaan atau bayangan kompleks. Rasio pakaian terhadap citra besar: Pakaian harus mengisi sebanyak mungkin bingkai. Hindari ruang putih berlebih di sekitar pakaian karena dapat mengurangi kualitas efek try-on.

Contoh citra pakaian yang valid

Atas
Bawah
Gaun/Jumpsuit

Contoh citra pakaian yang tidak valid

❌ Banyak pakaian	❌ Bukan foto menghadap depan	❌ Terlipat atau terhalang	❌ Pakaian kusut

Prasyarat

API OutfitAnyone-Plus hanya mendukung panggilan melalui HTTP.

Buat API key dan atur API key sebagai variabel lingkungan.

HTTP

API menyediakan operasi asinkron yang melibatkan dua langkah:

Buat tugas: Buat tugas generasi citra untuk mendapatkan `task_id` unik.
Kueri hasil: Gunakan `task_id` untuk memeriksa status tugas hingga tugas selesai dan ambil hasilnya.

Langkah 1: Buat tugas

Kirim permintaan `POST` untuk membuat tugas try-on.

POST https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis

Catatan

Karena model ini memiliki waktu pemanggilan yang lama, tugas dibuat menggunakan pemanggilan asinkron.
Setelah tugas dibuat, sistem langsung mengembalikan task_id. Anda harus menggunakan `task_id` ini untuk mengkueri hasil tugas dalam waktu 24 jam.

Parameter permintaan

Bidang	Tipe	Melewatkan Parameter	Wajib	Deskripsi	Contoh
Content-Type	String	Header	Ya	Jenis permintaan: application/json.	application/json
Authorization	String	Header	Ya	Kunci API. Contoh: Bearer sk-xxxx.	Bearer sk-xxxx
X-DashScope-Async	String	Header	Ya	Bidang statis dengan nilai `enable`, yang menunjukkan panggilan asinkron.	enable
model	String	Body	Ya	Menentukan model yang akan dipanggil.	aitryon-plus
input.person_image_url	String	Body	Ya	URL publik citra model. Anda juga dapat mendapatkan URL publik sementara. 5 KB ≤ Ukuran file citra ≤ 5 MB 150 ≤ Panjang sisi citra ≤ 4096 Format yang didukung: jpg, png, jpeg, bmp, heic Citra harus berisi hanya satu orang lengkap. Hanya tautan HTTP/HTTPS yang didukung. Jalur lokal tidak didukung. Untuk contoh citra model, lihat Persyaratan Citra Model. Catatan Silakan klik di sini untuk mengunduh citra model yang disediakan.	http://aaa/1.jpg
input.top_garment_url	String	Body	Tidak	URL Internet citra pakaian atasan/gaun. Anda juga dapat mendapatkan URL Internet sementara. 5 KB ≤ Ukuran file citra ≤ 5 MB 150 ≤ Panjang sisi citra ≤ 4096 Format yang didukung: jpg, png, jpeg, bmp, heic Unggah citra flat-lay pakaian. Pastikan pakaian adalah satu-satunya subjek, sepenuhnya terlihat, memiliki latar belakang bersih, dan tidak memiliki ruang putih berlebih di sekitarnya. Hanya tautan HTTP/HTTPS yang didukung. Jalur lokal tidak didukung. Untuk contoh grafik pakaian, lihat Persyaratan grafik pakaian. Catatan Anda harus memberikan setidaknya salah satu dari `top_garment_url` dan `bottom_garment_url`. Jika Anda tidak mengisi bidang ini, model akan menghasilkan top secara acak. Untuk gaun atau jumpsuit, masukkan URL citra di bidang ini dan biarkan `bottom_garment_url` kosong.	http://aaa/2.jpg
input.bottom_garment_url	String	Body	Tidak	URL Internet citra pakaian bawahan. Anda juga dapat mendapatkan URL Internet sementara. 5 KB ≤ Ukuran file citra ≤ 5 MB 150 ≤ Panjang sisi citra ≤ 4096 Format yang didukung: jpg, png, jpeg, bmp, heic Unggah citra flat-lay pakaian. Pastikan pakaian adalah satu-satunya subjek, sepenuhnya terlihat, memiliki latar belakang bersih, dan tidak memiliki ruang putih berlebih di sekitarnya. Hanya tautan HTTP/HTTPS yang didukung. Jalur lokal tidak didukung. Untuk contoh citra pakaian, lihat Persyaratan Citra Pakaian. Catatan Anda harus memberikan setidaknya salah satu dari `top_garment_url` dan `bottom_garment_url`. Jika bidang ini tidak diisi, model akan menghasilkan bawahan secara acak.	http://aaa/3.jpg
parameters.resolution	Int	Body	Tidak	Resolusi citra output. Nilai yang direkomendasikan: -1: Nilai default. Resolusi sama dengan citra asli. 1024: 576×1024 1280: 720×1280 Catatan API mungkin menerima nilai lain. Namun, nilai yang direkomendasikan ini memberikan performa terbaik.	-1
parameters.restore_face	Bool	Body	Tidak	Menentukan apakah akan memulihkan wajah dari citra model. true: Nilai default. Mempertahankan wajah asli. false: Menghasilkan wajah baru secara acak.	true

Parameter respons

Bidang	Jenis	Deskripsi	Contoh
output.task_id	String	ID unik tugas asinkron.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas setelah dikirim.	PENDING
request_id	String	ID unik permintaan ini.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

Try-on atasan

Try-on atasan: Masukkan `top_garment_url` untuk atasan yang akan dicoba. Model akan menghasilkan bawahan secara acak.

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/epousa/short_sleeve.jpeg"    
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
 }'

Pertahankan bawahan asli model: Ini melibatkan dua langkah:
1. Panggil API OutfitAnyone - Image Segmentation untuk mendapatkan URL citra bawahan model.
2. Panggil API try-on dalam topik ini, masukkan `top_garment_url` untuk atasan yang akan dicoba dan `bottom_garment_url` yang diperoleh dari segmentasi.

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/epousa/short_sleeve.jpeg",
        "bottom_garment_url": "Image URL from the Image Segmentation API output"    
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
 }'

Try-on bawahan

Try-on bawahan: Masukkan `bottom_garment_url` untuk bawahan yang akan dicoba. Model akan menghasilkan atasan secara acak.

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "bottom_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/rchumi/pants.jpeg" 
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
}'

Pertahankan atasan asli model: Ini melibatkan dua langkah:
1. Panggil API OutfitAnyone - Image Segmentation untuk mendapatkan URL citra atasan model.
2. Panggil API try-on dalam topik ini, masukkan `top_garment_url` yang diperoleh dari segmentasi dan `bottom_garment_url` untuk bawahan yang akan dicoba.

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "Image URL from the Image Segmentation API output",
        "bottom_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/rchumi/pants.jpeg"     
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
 }'

Try-on atasan dan bawahan

Masukkan `top_garment_url` untuk atasan yang akan dicoba dan `bottom_garment_url` untuk bawahan yang akan dicoba.

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/epousa/short_sleeve.jpeg",
        "bottom_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/rchumi/pants.jpeg" 
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
}'

Try-on gaun atau jumpsuit

Untuk gaun atau jumpsuit, masukkan hanya `top_garment_url`.

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis/' \
--header 'X-DashScope-Async: enable' \
--header "Authorization: Bearer $DASHSCOPE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
    "model": "aitryon-plus",
    "input": {
        "person_image_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/ubznva/model_person.png",
        "top_garment_url": "https://help-static-aliyun-doc.aliyuncs.com/file-manage-files/zh-CN/20250626/odngby/dress.jpg"
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
}'

Contoh respons

Respons berhasil

Simpan task_id untuk mengkueri status dan hasil tugas.

{
    "output": {
        "task_status": "PENDING",
        "task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
    },
    "request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}

Respons kesalahan

Pembuatan tugas gagal. Untuk informasi selengkapnya, lihat Pesan kesalahan untuk menyelesaikan masalah.

{
    "code": "InvalidApiKey",
    "message": "No API-key provided.",
    "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

Langkah 2: Kueri hasil berdasarkan ID tugas

Gunakan task_id dari langkah sebelumnya untuk mengirim permintaan GET guna mengkueri status dan hasil tugas. Ganti {task_id} dalam URL dengan ID tugas aktual Anda.

GET https://dashscope.aliyuncs.com/api/v1/tasks/{task_id}

Parameter permintaan

Bidang	Type	Melewatkan Parameter	Wajib	Deskripsi	Contoh
Authorization	String	Header	Ya	Kunci API. Contoh: Bearer sk-xxx.	Bearer sk-xxx
task_id	String	URL Path	Ya	ID tugas yang akan dikueri.	a8532587-fa8c-4ef8-82be-0c46b17950d1

Parameter respons

Bidang	Type	Deskripsi	Contoh
output.task_id	String	ID tugas yang dikueri.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas. Nilai yang mungkin meliputi: PENDING PRE-PROCESSING RUNNING POST-PROCESSING SUCCEEDED FAILED UNKNOWN: Tugas tidak ada atau statusnya tidak diketahui. CANCELED	SUCCEEDED
output.image_url	String	URL citra try-on yang dihasilkan. image_url berlaku selama 24 jam. Unduh segera.	https://.../result.jpg?Expires=xxx
output.submit_time	String	Waktu pengiriman tugas.	2024-07-30 15:39:39.918
output.scheduled_time	String	Waktu eksekusi tugas.	2024-07-30 15:39:39.941
output.end_time	String	Waktu penyelesaian tugas.	2024-07-30 15:39:55.080
output.code	String	Kode kesalahan. Parameter ini dikembalikan saat tugas gagal.	InvalidParameter
output.message	String	Detail kesalahan. Parameter ini dikembalikan saat tugas gagal.	The request is missing required parameters or in a wrong format
usage.image_count	Int	Jumlah citra yang dihasilkan dalam permintaan ini.	1
request_id	String	ID unik permintaan ini.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

Ganti 86ecf553-d340-4e21-xxxxxxxxx dengan ID tugas aktual Anda.

curl -X GET https://dashscope.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"

Catatan

Anda hanya dapat mengkueri hasil tugas menggunakan `task_id` selama 24 jam setelah tugas dibuat. Setelah periode ini, tugas akan secara otomatis dipurge oleh sistem.

Contoh respons

Respons berhasil

Data tugas, seperti status tugas dan URL citra, hanya disimpan selama 24 jam lalu secara otomatis dipurge. Anda harus segera menyimpan citra yang dihasilkan.

{
    "request_id": "98d46cd0-1f90-9231-9a6c-xxxxxx",
    "output": {
        "task_id": "15991992-1487-40d4-ae66-xxxxxx",
        "task_status": "SUCCEEDED",
        "submit_time": "2025-06-30 14:37:53.838",
        "scheduled_time": "2025-06-30 14:37:53.858",
        "end_time": "2025-06-30 14:38:11.472",
        "image_url": "http://dashscope-result-hz.oss-cn-hangzhou.aliyuncs.com/tryon.jpg?Expires=xxx"
    },
    "usage": {
        "image_count": 1
    }
}

Respons gagal

{
    "request_id": "6bf4693b-c6d0-933a-b7b7-xxxxxx",
    "output": {
        "task_id": "e32bd911-5a3d-4687-bf53-xxxxxx",
        "task_status": "FAILED",
        "code": "InvalidParameter",
        "message": "The request is missing required parameters xxxxx"
  }
}

Kode kesalahan

Untuk kode status umum layanan model, lihat Pesan kesalahan.

Kode kesalahan berikut khusus untuk model OutfitAnyone:

Kode respons HTTP	Kode kesalahan (code)	Pesan kesalahan (message)	Deskripsi
400	InvalidParameter	Permintaan kehilangan parameter yang diperlukan atau memiliki format yang salah. Periksa parameter dalam permintaan Anda.	Parameter yang diperlukan hilang atau formatnya salah. Pastikan badan permintaan Anda sesuai dengan spesifikasi API.
400	InvalidParameter	Unduhan resource media timeout selama proses inspeksi data.	Unduhan citra timeout. Kemungkinan penyebab dan solusi: Masalah jaringan: Koneksi jaringan antara server Anda dan layanan Alibaba Cloud Model Studio tidak tersedia. Periksa koneksi jaringan Anda. URL internal OSS: Layanan Alibaba Cloud Model Studio tidak dapat mengakses URL internal. Gunakan URL Internet OSS sebagai gantinya. Resource di luar Daratan Tiongkok: Akses jaringan lintas batas tidak stabil. Gunakan layanan penyimpanan di Daratan Tiongkok.
400	InvalidURL	URL permintaan tidak valid. Pastikan URL tersedia dan format citra merupakan salah satu dari berikut: JPEG, JPG, PNG, BMP, atau WEBP.	URL citra tidak valid. Pastikan URL dapat diakses melalui Internet dan format citra memenuhi persyaratan.
400	InvalidPerson	Citra input tidak berisi orang atau berisi banyak orang. Unggah citra yang hanya berisi satu orang.	Citra model tidak sesuai. Pastikan citra input berisi satu dan hanya satu orang lengkap.
400	InvalidGarment	Citra pakaian hilang. Berikan citra untuk setidaknya atasan atau bawahan.	Citra pakaian hilang. Berikan setidaknya satu citra untuk atasan (top_garment_url) atau bawahan (bottom_garment_url).
400	InvalidInputLength	Resolusi citra tidak valid. Pastikan sisi terpanjang citra kurang dari 4096 piksel, sisi terpendek lebih dari 150 piksel, dan ukuran file antara 5 KB dan 5 MB.	Dimensi atau ukuran file citra tidak memenuhi persyaratan. Untuk informasi selengkapnya, lihat Persyaratan citra input.

FAQ

Cara menyiapkan foto model dan citra pakaian

Mengapa diperlukan citra flat-lay pakaian?
Citra flat-lay memberikan tampilan paling jelas mengenai potongan, pola, dan siluet pakaian. Hal ini membantu AI memahami struktur pakaian secara akurat dan menghasilkan hasil try-on yang lebih pas dan realistis.
Apa yang harus dilakukan jika saya tidak memiliki citra flat-lay pakaian?
Letakkan pakaian secara rata di latar belakang bersih, seperti lantai atau dinding, lalu ambil foto dari atas. Atau, ambil foto menghadap depan model atau manekin yang mengenakan pakaian tersebut. Pastikan pakaian sepenuhnya terlihat, rata, dan tidak terhalang.
Bagaimana cara memilih foto model yang sesuai?
Pilih foto yang jelas, menghadap depan, dan full-body. Model sebaiknya mengenakan pakaian sederhana yang ketat, seperti kaos dan celana pendek. Hindari gaun panjang, jubah dengan lengan lebar, atau banyak lapisan. Pastikan tangan dan kaki model terlihat jelas dan tidak terhalang aksesori seperti tas atau payung.
Apa yang harus dilakukan jika saya tidak memiliki foto model yang sesuai?
Kami menyediakan serangkaian foto referensi model yang memenuhi persyaratan. Anda dapat mengklik di sini untuk mengunduh dan menggunakannya.

Hasil model tidak memuaskan

Mengapa kualitas citra yang dihasilkan buruk dan kurang detail?
Penyebab paling mungkin adalah citra pakaian input berkualitas rendah. Pastikan citra pakaian berdefinisi tinggi dan lengkap. Detail tidak boleh hilang karena lipatan atau sudut kamera yang buruk. Input berkualitas tinggi menjamin output berkualitas tinggi.

Penggunaan fitur

Bagaimana cara menghasilkan citra try-on untuk gaun atau jumpsuit?
Masukkan URL citra gaun atau jumpsuit ke dalam bidang input.top_garment_url. Biarkan bidang input.bottom_garment_url kosong atau jangan sertakan dalam permintaan.