Aitryon-plus menghasilkan kejernihan gambar yang lebih tinggi, tekstur kain yang lebih baik, dan logo yang lebih akurat, tetapi memerlukan waktu pemrosesan lebih lama.
PentingDokumen ini hanya berlaku untuk wilayah Tiongkok (Beijing) — gunakan Kunci API dari wilayah tersebut.
Kemampuan
Multiple garment try-on- Single top try-on: Menghasilkan bagian bawah secara acak atau mempertahankan aslinya.
- Single bottoms try-on: Menghasilkan bagian atas secara acak atau mempertahankan aslinya.
- Top and bottoms combination: Mengganti seluruh pakaian.
- Dress/Jumpsuit try-on
- Face: Pertahankan wajah asli atau hasilkan wajah acak.
- Resolution: Tentukan dimensi output atau gunakan dimensi asli.
Ikhtisar
Model | Harga | Batas laju (dibagi oleh Akun Alibaba Cloud dan Pengguna RAM) | |
|---|---|---|---|
RPS API pengiriman task | Tugas konkuren | ||
aitryon-plus | $0,071677/gambar | 10 | 5 |
Contoh
Input: Gambar orang full-body menghadap depan | Input: Gambar pakaian flat-lay | Output: Gambar try-on yang dihasilkan |
|---|---|---|
| Gambar atasan flat-lay |
|
Gambar bawahan flat-lay |
Persyaratan gambar input
Sebelum memanggil API, pastikan gambar memenuhi persyaratan berikut.
Persyaratan gambar orang
Persyaratan | Detail |
|---|---|
Gambar | - Ukuran file: 5 KB hingga 5 MB - Resolusi: Lebar dan tinggi masing-masing harus antara 150 hingga 4096 piksel. - Format: JPG, JPEG, PNG, BMP, dan HEIC. - Tautan: Gambar harus berada di URL HTTP atau HTTPS yang dapat diakses publik. Jalur lokal tidak didukung. |
Subjek | - Keragaman subjek: Mendukung orang dengan jenis kelamin, warna kulit, dan usia berbeda (usia 6 tahun ke atas). |
Gambar orang yang valid
|
|
|
|
|---|
Gambar orang yang tidak valid
Beberapa 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 gambar buram |
|---|---|---|---|
|
|
|
|
Persyaratan gambar pakaian
Requirement | Details |
|---|---|
Image | - Ukuran file: 5 KB hingga 5 MB |
Garment | - Jenis: Mendukung atasan tunggal, bawahan, dan gaun. Juga mendukung setelan jas serta kombinasi atasan dan bawahan. |
Gambar pakaian yang valid
Top |
|
|
|
|---|---|---|---|
Bottoms |
|
|
|
Dress/Jumpsuit |
|
|
|
Gambar pakaian tidak valid
Multiple garments | Not a front-facing photo | Folded or obstructed | Wrinkled garment |
|---|---|---|---|
|
|
|
|
Prasyarat
Dapatkan Kunci API dan tetapkan Kunci API tersebut sebagai Variabel lingkungan.
HTTP
API ini menggunakan alur kerja asinkron:
- Create task: Kirim permintaan pembuatan gambar dan terima
task_id. - Query result: Periksa status task dengan
task_idhingga selesai, lalu ambil hasilnya.
Langkah 1: Buat task
Kirim permintaan POST untuk membuat task try-on.
POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/image2image/image-synthesis
Ganti {WorkspaceId} dengan workspace ID Anda yang sebenarnya.
Model ini memiliki waktu pemrosesan yang lama, sehingga task menggunakan pengiriman asinkron. Setelah dibuat, sistem mengembalikan
task_id. Kueri hasil dalam waktu 24 jam.
Parameter permintaan
Field | Type | Location | Required | Description | Example |
|---|---|---|---|---|---|
Content-Type | String | Header | Yes | Jenis permintaan: |
|
Authorization | String | Header | Yes | Format Kunci API: |
|
X-DashScope-Async | String | Header | Yes | Nilai tetap: |
|
model | String | Body | Yes | Model yang akan dipanggil. |
|
input.person_image_url | String | Body | Yes | URL gambar orang yang dapat diakses publik (atau dapatkan URL temporary): Unduh gambar referensi orang di sini. |
|
input.top_garment_url | String | Body | No | URL pakaian (atasan atau gaun) yang dapat diakses publik (atau dapatkan URL sementara):
|
|
input.bottom_garment_url | String | Body | No | URL pakaian bawahan yang dapat diakses publik (atau dapatkan URL sementara):
|
|
parameters.resolution | Int | Body | No | Preset resolusi gambar output. Nilai yang direkomendasikan: API mungkin menerima nilai lain, tetapi nilai yang direkomendasikan ini memberikan hasil terbaik. |
|
parameters.restore_face | Bool | Body | No | Apakah wajah dari gambar orang akan dipertahankan. |
|
Parameter respons
Field | Type | Description | Example |
|---|---|---|---|
output.task_id | String | ID unik task asinkron. |
|
output.task_status | String | Status task setelah dikirim. |
|
request_id | String | ID unik permintaan ini. |
|
Contoh permintaan
Try on atasan
- Try on atasan: Berikan
top_garment_urluntuk atasan yang ingin dicoba. Model AI akan menghasilkan bawahan secara acak.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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 orang tersebut: Proses ini melibatkan dua langkah:
- Panggil OutfitAnyone - Image Segmentation API untuk mendapatkan URL gambar bawahan orang tersebut.
- Panggil API try-on pada topik ini, berikan
top_garment_urluntuk atasan yang ingin dicoba danbottom_garment_urlyang diperoleh dari segmentasi.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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: Berikan
bottom_garment_urluntuk bawahan yang ingin dicoba. Model AI akan menghasilkan atasan secara acak.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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 orang tersebut: Proses ini melibatkan dua langkah:
- Panggil OutfitAnyone - Image Segmentation API untuk mendapatkan URL gambar atasan orang tersebut.
- Panggil API try-on pada topik ini, berikan
top_garment_urlyang diperoleh dari segmentasi danbottom_garment_urluntuk bawahan yang ingin dicoba.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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
Berikan top_garment_url untuk atasan dan bottom_garment_url untuk bawahan.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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, cukup berikan top_garment_url saja.
curl --location 'https://{WorkspaceId}.cn-beijing.maas.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 sukses
Simpan task_id untuk mengecek status task dan hasilnya.
{
"output": {
"task_status": "PENDING",
"task_id": "0385dc79-5ff8-4d82-bcb6-xxxxxx"
},
"request_id": "4909100c-7b5a-9f92-bfe5-xxxxxx"
}
Respons error
Pembuatan task gagal. Lihat Kode error untuk mengatasi masalah.
{
"code": "InvalidApiKey",
"message": "No API-key provided.",
"request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}
Langkah 2: Kueri hasil berdasarkan task ID
Gunakan task_id dari Langkah 1 untuk mengirim permintaan GET. Ganti {task_id} dalam URL dengan task ID yang sebenarnya.
GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/{task_id}
Ganti {WorkspaceId} dengan workspace ID Anda yang sebenarnya.
Parameter permintaan
Field | Type | Location | Required | Description | Example |
|---|---|---|---|---|---|
Authorization | String | Header | Yes | Format Kunci API: |
|
task_id | String | URL Path | Yes | ID tugas yang akan dikueri. |
|
Parameter respons
Field | Type | Description | Example |
|---|---|---|---|
output.task_id | String | ID task yang dikueri. |
|
output.task_status | String | Status task. Nilai yang mungkin: |
|
output.image_url | String | URL gambar try-on yang dihasilkan. Berlaku selama 24 jam — segera unduh. | |
output.submit_time | String | Waktu pengiriman task. |
|
output.scheduled_time | String | Waktu mulai eksekusi task. |
|
output.end_time | String | Waktu penyelesaian task. |
|
output.code | String | Kode error (hanya dikembalikan saat gagal). |
|
output.message | String | Rincian error (hanya dikembalikan saat gagal). |
|
usage.image_count | Int | Jumlah gambar yang dihasilkan. |
|
request_id | String | ID unik permintaan ini. |
|
Contoh permintaan
Ganti 86ecf553-d340-4e21-xxxxxxxxx dengan task ID yang sebenarnya.
curl -X GET https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/tasks/86ecf553-d340-4e21-xxxxxxxxx \
--header "Authorization: Bearer $DASHSCOPE_API_KEY"
Hasil task dapat dikueri selama 24 jam setelah dibuat, lalu secara otomatis dihapus.
Contoh respons
Respons sukses
Data task disimpan selama 24 jam, lalu dihapus. Segera unduh gambarnya.
{
"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, lihat Kode kesalahan.
Kode kesalahan berikut khusus untuk model OutfitAnyone-Plus:
HTTP return code | code | message | Description |
|---|---|---|---|
400 | InvalidParameter | Permintaan tidak memiliki parameter yang diperlukan atau formatnya salah. Periksa parameter dalam permintaan Anda. | Parameter yang diperlukan tidak tersedia atau formatnya salah. Pastikan badan permintaan sesuai dengan spesifikasi API. |
400 | InvalidParameter | Pengunduhan resource media mengalami timeout selama proses inspeksi data. | Pengunduhan gambar mengalami timeout. Kemungkinan penyebab dan solusi: |
400 | InvalidURL | URL permintaan tidak valid. Pastikan URL tersebut tersedia dan format gambarnya salah satu dari berikut: JPEG, JPG, PNG, BMP, atau WEBP. | URL gambar tidak valid. Verifikasi bahwa URL tersebut dapat diakses secara publik dan format gambarnya memenuhi persyaratan. |
400 | InvalidPerson | Gambar input tidak berisi orang atau berisi beberapa orang. Unggah gambar yang hanya berisi satu orang. | Gambar orang tidak memenuhi persyaratan. Pastikan gambar input berisi tepat satu orang secara utuh. |
400 | InvalidGarment | Gambar pakaian tidak tersedia. Berikan gambar setidaknya untuk atasan atau bawahan. | Gambar pakaian tidak tersedia. Berikan setidaknya satu gambar: atasan ( |
400 | InvalidInputLength | Resolusi gambar tidak valid. Pastikan sisi terpanjang gambar kurang dari 4096 piksel, sisi terpendek lebih dari 150 piksel, dan ukuran file antara 5 KB hingga 5 MB. | Dimensi atau ukuran file gambar tidak memenuhi persyaratan. Lihat bagian Persyaratan gambar input. |
FAQ
Cara menyiapkan foto orang dan gambar pakaian
- Mengapa diperlukan gambar pakaian flat-lay? Gambar 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 gambar pakaian flat-lay? Letakkan pakaian secara rata di latar belakang bersih, seperti lantai atau dinding, lalu ambil fotonya dari atas. Atau, ambil foto menghadap depan dari orang atau manekin yang mengenakan pakaian tersebut. Pastikan pakaian sepenuhnya terlihat, rata, dan tidak terhalang.
- Bagaimana cara memilih foto orang yang sesuai? Pilih foto yang jelas, full-body, dan menghadap depan. Orang tersebut sebaiknya mengenakan pakaian sederhana yang pas badan, seperti kaos dan celana pendek. Hindari gaun panjang, jubah berlengan lebar, atau pakaian berlapis-lapis. Pastikan tangan dan kaki terlihat jelas serta tidak terhalang oleh aksesori seperti tas atau payung.
- Apa yang harus dilakukan jika saya tidak memiliki foto orang yang sesuai? Foto referensi orang yang memenuhi persyaratan tersedia untuk diunduh. Klik di sini untuk mengunduhnya.
Hasil tidak memuaskan
- Mengapa gambar yang dihasilkan berkualitas rendah atau kurang detail? Penyebab paling umum adalah gambar pakaian input berkualitas rendah. Pastikan gambar pakaian beresolusi tinggi dan lengkap. Detail tidak boleh hilang karena lipatan atau sudut kamera yang buruk. Input berkualitas tinggi menghasilkan output berkualitas tinggi.
Penggunaan fitur
- Bagaimana cara menghasilkan gambar try-on untuk gaun atau jumpsuit? Berikan URL gambar gaun atau jumpsuit dalam bidang
input.top_garment_url. Biarkan bidanginput.bottom_garment_urlkosong atau hilangkan dari permintaan.