Memanggil API AI Try-on Plus - Alibaba Cloud Model Studio

Dibandingkan dengan aitryon, aitryon-plus menawarkan kejernihan gambar, tekstur kain, dan restorasi logo yang lebih unggul. Namun, waktu generasinya yang lebih lama menjadikannya ideal untuk kasus penggunaan yang menuntut hasil berkualitas tinggi tetapi tidak sensitif terhadap waktu.

Penting

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

Kemampuan model

Try-on pakaian ganda

Try-on atasan tunggal: Model akan menghasilkan bawahan acak atau mempertahankan bawahan asli.
Try-on bawahan tunggal: Model akan menghasilkan atasan acak atau mempertahankan atasan asli.
Try-on setelan lengkap: Mengganti seluruh pakaian model.
Try-on gaun/jumpsuit

Kontrol detail

Kebijakan wajah: Memungkinkan Anda mempertahankan wajah asli model atau menghasilkan wajah baru secara acak.
Tentukan resolusi: Memungkinkan Anda menentukan dimensi gambar output atau mempertahankan dimensi asli.

Ikhtisar model

Pendahuluan

Nama model	Harga satuan	Pembatasan laju
		Batas RPS API	Tugas konkuren
aitryon-plus	$0,071677/gambar	10	5

Contoh hasil

Input model

Input pakaian

Hasil yang dihasilkan

test_client_tryon

Gambar Flat-Lay Utama

test_client_tryon

Gambar flat-lay bawahan

Persyaratan gambar input

Input berkualitas tinggi sangat penting untuk menghasilkan output berkualitas tinggi. Sebelum memanggil API, pastikan gambar Anda memenuhi persyaratan berikut.

Persyaratan gambar model

Kategori persyaratan	Deskripsi
Persyaratan gambar	Ukuran file: 5 KB hingga 5 MB Resolusi: Lebar dan tinggi harus antara 150px hingga 4096px. Format gambar: JPG, JPEG, PNG, BMP, dan HEIC URL: Gambar harus dapat diakses melalui URL HTTP atau HTTPS publik. Jalur file lokal tidak didukung.
Persyaratan subjek	Demografi: Mendukung gambar orang dengan jenis kelamin atau warna kulit apa pun, berusia 6 tahun ke atas. Pose: Gunakan foto full-body depan yang cukup terang. Tangan subjek harus sepenuhnya terlihat. Hindari pose dengan lengan menyilang atau menghalangi tubuh. Jumlah: Gambar harus berisi tepat satu orang utuh.

Gambar model yang valid

Gambar model yang tidak valid

❌ Beberapa orang

❌ Pose tidak valid

(Hindari tampilan samping, pose duduk atau berbaring, dan potret sebagian tubuh)

❌ Penghalang

(Hindari barang yang dipegang di tangan, tas, dll.)

❌ Pencahayaan buruk atau buram

Persyaratan gambar pakaian

Kategori persyaratan	Deskripsi
Persyaratan gambar	Ukuran file: 5 KB hingga 5 MB Resolusi: Lebar dan tinggi harus antara 150px hingga 4096px. Format gambar: JPG, JPEG, PNG, BMP, dan HEIC URL: Gambar harus dapat diakses melalui URL HTTP atau HTTPS publik. Jalur file lokal tidak didukung.
Persyaratan pakaian	Jenis: Mendukung atasan, bawahan, dan gaun individual, serta setelan lengkap. Kategori: Kategori pakaian umum didukung. Pakaian dalam, gaun pengantin, gaun formal, dan pakaian etnis tradisional tidak didukung. Pedoman: Pakaian tunggal: Sediakan gambar flat-lay satu pakaian. Tidak ada lipatan atau penghalang: Pakaian harus dibentangkan rata, tanpa kerutan atau lipatan. Latar belakang bersih: Gunakan latar belakang sederhana dan bersih dengan warna seragam. Pastikan pakaian terlihat jelas dan bebas dari pencahayaan atau bayangan kompleks. Rasio pakaian terhadap gambar tinggi: Pakaian harus mengisi sebagian besar bingkai. Ruang putih berlebih di sekitar pakaian dapat menurunkan kualitas hasil try-on.

Gambar pakaian yang valid

Top
Bawahan
Gaun/Jumpsuit

Gambar pakaian yang tidak valid

❌ Beberapa pakaian	❌ Bukan menghadap depan	❌ Dilipat atau terhalang	❌ Berkerut

Prasyarat

API AI Virtual Try-on Plus hanya menerima panggilan HTTP.

Sebelum memanggil API, dapatkan API key dan konfigurasikan sebagai Variabel lingkungan.

Panggilan HTTP

API ini menggunakan konvensi pemanggilan asinkron yang terdiri dari dua langkah:

Buat tugas: Kirim tugas generasi gambar untuk mendapatkan task_id unik.
Kueri hasil: Gunakan task_id untuk memeriksa status tugas hingga tugas selesai dan mengembalikan hasil.

Langkah 1: Buat tugas

Kirim permintaan POST untuk membuat tugas AI Try-on.

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

Catatan

Karena panggilan ke model ini memakan waktu, tugas diproses secara asinkron.
Setelah Anda membuat tugas, sistem segera mengembalikan task_id. Gunakan task_id ini untuk mengkueri hasil tugas dalam waktu 24 jam.

Parameter permintaan

Parameter	Tipe	Lokasi	Wajib	Deskripsi	Nilai contoh
Content-Type	String	Header	Ya	Jenis permintaan: application/json.	application/json
Authorization	String	Header	Ya	Kunci API Anda, diawali dengan Bearer. Contoh: Bearer sk-xxxx.	Bearer sk-xxxx
X-DashScope-Async	String	Header	Ya	Atur ke enable untuk panggilan asinkron.	enable
model	String	Body	Ya	Model yang akan dipanggil.	aitryon-plus
input.person_image_url	String	Body	Ya	URL publik gambar model. Anda juga dapat mendapatkan URL publik sementara. Ukuran file: 5 KB hingga 5 MB Dimensi gambar: Lebar dan tinggi antara 150 hingga 4096 piksel Format yang didukung: jpg, png, jpeg, bmp, heic Gambar harus berisi satu orang utuh. Hanya URL HTTP dan HTTPS yang didukung. Jalur lokal tidak didukung. Untuk contoh gambar model, lihat Persyaratan Gambar Model. Catatan Unduh contoh gambar model kami di sini.	http://aaa/1.jpg
input.top_garment_url	String	Body	Tidak	URL publik gambar pakaian untuk atasan atau gaun. Anda juga dapat mendapatkan URL publik sementara. Ukuran file: 5 KB hingga 5 MB Dimensi gambar: Lebar dan tinggi antara 150 hingga 4096 piksel Format yang didukung: jpg, png, jpeg, bmp, heic Unggah gambar flat lay pakaian. Gambar harus menampilkan satu pakaian utuh dengan latar belakang bersih dan ruang putih sekitarnya minimal. Hanya URL HTTP dan HTTPS yang didukung. Jalur lokal tidak didukung. Untuk contoh gambar pakaian, lihat Persyaratan Gambar Pakaian. Catatan Anda harus menyediakan setidaknya salah satu dari top_garment_url atau bottom_garment_url. Jika parameter ini tidak diberikan, model akan menghasilkan top secara acak. Untuk gaun atau pakaian satu potong, berikan URL gambar pada parameter ini dan biarkan bottom_garment_url kosong.	http://aaa/2.jpg
input.bottom_garment_url	String	Body	Tidak	URL publik gambar pakaian untuk bawahan. Anda juga dapat mendapatkan URL publik sementara. Ukuran file: 5 KB hingga 5 MB Dimensi gambar: Lebar dan tinggi antara 150 hingga 4096 piksel Format yang didukung: jpg, png, jpeg, bmp, heic Unggah gambar flat lay pakaian. Gambar harus menampilkan satu pakaian utuh dengan latar belakang bersih dan ruang putih sekitarnya minimal. Hanya URL HTTP dan HTTPS yang didukung. Jalur lokal tidak didukung. Untuk contoh gambar pakaian, lihat Persyaratan Gambar Pakaian. Catatan Anda harus menyediakan setidaknya salah satu dari top_garment_url atau bottom_garment_url. Jika parameter ini tidak diberikan, model akan menghasilkan bagian bawah secara acak.	http://aaa/3.jpg
parameters.resolution	Int	Body	Tidak	Resolusi gambar output. Nilai yang direkomendasikan adalah sebagai berikut: -1: Nilai default. Mempertahankan dimensi output sama dengan gambar sumber. 1024: Menunjukkan resolusi 576x1024. 1280: Menunjukkan resolusi 720x1280. Catatan API mungkin menerima nilai lain, tetapi menggunakan nilai yang direkomendasikan memastikan hasil terbaik.	-1
parameters.restore_face	Bool	Body	Tidak	Menentukan apakah akan merestorasi wajah dari gambar model. true: Nilai default. Mempertahankan wajah asli. false: Menghasilkan wajah baru secara acak.	true

Parameter respons

Parameter	Tipe	Deskripsi	Nilai contoh
output.task_id	String	ID unik tugas asinkron.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas yang dikirim.	PENDING
request_id	String	ID unik permintaan.	7574ee8f-38a3-4b1e-9280-11c33ab46e51

Contoh permintaan

Coba atasan

Try on atasan: Berikan top_garment_url (atasan yang akan dicoba), dan 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 adalah proses dua langkah:
1. Panggil API AI Try-on - Segmentasi Gambar untuk mendapatkan URL gambar bawahan model.
2. Panggil API AI Try-on, berikan top_garment_url (atasan yang akan dicoba) dan bottom_garment_url (URL bawahan hasil 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 response"    
    },
    "parameters": {
        "resolution": -1,
        "restore_face": true
    }
 }'

Try on bawahan

Try on bawahan: Berikan bottom_garment_url (bawahan yang akan dicoba), dan 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 adalah proses dua langkah:
1. Panggil API AI Try-on - Segmentasi Gambar untuk mendapatkan URL gambar atasan model.
2. Panggil API AI Try-on dalam topik ini, berikan top_garment_url (URL atasan hasil segmentasi) dan bottom_garment_url (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 response",
        "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 kedua top_garment_url (atasan yang akan dicoba) dan bottom_garment_url (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 pakaian satu potong

Untuk gaun atau pakaian satu potong, berikan 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 error

Pembuatan tugas gagal. Lihat Pesan Error.

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

Langkah 2: Kueri hasil 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

Parameter	Tipe	Lokasi	Wajib	Deskripsi	Nilai contoh
Authorization	String	Header	Ya	Kunci API. Contoh: Bearer sk-xxx.	Bearer sk-xxx
task_id	String	Path	Ya	ID tugas yang akan dikueri.	a8532587-fa8c-4ef8-82be-0c46b17950d1

Parameter respons

Parameter	Tipe	Deskripsi	Nilai contoh
output.task_id	String	ID tugas.	a8532587-fa8c-4ef8-82be-0c46b17950d1
output.task_status	String	Status tugas. Nilai yang mungkin meliputi: PENDING: Tugas sedang dalam antrian. PRE-PROCESSING: Tugas sedang diproses awal. RUNNING: Tugas sedang berjalan. POST-PROCESSING: Tugas sedang diproses akhir. SUCCEEDED: Tugas berhasil. FAILED: Tugas gagal. UNKNOWN: Tugas tidak ada atau statusnya tidak diketahui. CANCELED: Tugas telah dibatalkan.	SUCCEEDED
output.image_url	String	URL gambar yang dihasilkan. URL ini kedaluwarsa setelah 24 jam, jadi unduh gambarnya segera.	https://.../result.jpg?Expires=xxx
output.submit_time	String	Waktu saat tugas dikirim.	2024-07-30 15:39:39.918
output.scheduled_time	String	Waktu saat tugas mulai berjalan.	2024-07-30 15:39:39.941
output.end_time	String	Waktu saat tugas selesai.	2024-07-30 15:39:55.080
output.code	String	Kode error. Parameter ini hanya dikembalikan ketika tugas gagal.	InvalidParameter
output.message	String	Pesan error. Parameter ini hanya dikembalikan ketika tugas gagal.	The request is missing required parameters or in a wrong format
usage.image_count	Int	Jumlah gambar yang dihasilkan untuk permintaan tersebut.	1
request_id	String	ID unik permintaan.	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

Tugas hanya dapat dikueri berdasarkan task_id-nya selama 24 jam setelah dibuat. Setelah periode ini, tugas dan hasilnya akan dihapus secara otomatis.

Contoh respons

Respons berhasil

Data tugas, termasuk status tugas dan URL gambar, akan dihapus setelah 24 jam. Simpan gambar yang dihasilkan segera.

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

Lihat Pesan Error untuk kode status umum layanan model besar.

Tabel berikut mencantumkan kode error khusus untuk model AI Try-on.

Kode status HTTP	Kode error (code)	Pesan error (message)	Deskripsi
400	InvalidParameter	Permintaan kehilangan parameter yang diperlukan atau dalam format yang salah. Harap verifikasi parameter permintaan.	Permintaan kehilangan parameter permintaan yang diperlukan atau parameter dalam format yang salah. Verifikasi bahwa badan permintaan Anda memenuhi spesifikasi API.
400	InvalidParameter	Waktu unduh resource media habis selama inspeksi data.	Waktu unduh gambar habis. Kemungkinan penyebab dan solusi: Masalah jaringan: Server Anda tidak dapat terhubung ke layanan Studio Model. Periksa koneksi jaringan Anda. URL internal OSS: Layanan Studio Model tidak dapat mengakses alamat internal. Gunakan URL publik OSS sebagai gantinya. Resource yang di-hosting di luar Tiongkok daratan: Akses lintas batas bisa tidak stabil. Gunakan layanan penyimpanan di Tiongkok daratan.
400	InvalidURL	URL permintaan tidak valid. Verifikasi bahwa URL dapat diakses dan format gambarnya salah satu dari berikut: JPEG, JPG, PNG, BMP, atau WEBP.	URL gambar tidak valid. Verifikasi bahwa URL merupakan alamat jaringan publik dan format gambar memenuhi persyaratan.
400	InvalidPerson	Gambar input tidak berisi orang atau berisi beberapa orang. Harap unggah gambar dengan satu orang saja.	Gambar model tidak valid. Pastikan gambar input berisi satu dan hanya satu orang utuh.
400	InvalidGarment	Gambar pakaian tidak tersedia. Harap berikan gambar untuk atasan atau bawahan.	Gambar pakaian tidak tersedia. Berikan setidaknya satu gambar untuk atasan (`top_garment_url`) atau bawahan (`bottom_garment_url`).
400	InvalidInputLength	Resolusi atau ukuran file 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.	Resolusi atau ukuran file gambar tidak memenuhi persyaratan. Lihat Persyaratan Gambar Input.

FAQ

Cara menyiapkan gambar model dan pakaian

Mengapa menggunakan gambar pakaian flat lay?
Gambar flat lay menunjukkan dengan jelas potongan, pola, dan siluet pakaian. Hal ini memungkinkan AI memahami struktur pakaian secara akurat dan menghasilkan gambar try-on yang lebih realistis dan pas.
Apa yang harus dilakukan jika saya tidak memiliki gambar pakaian flat lay?
Cobalah meletakkan pakaian secara rata di latar belakang bersih, seperti lantai atau dinding, lalu ambil foto dari atas. Atau, ambil foto depan model manusia atau manekin yang mengenakan pakaian tersebut. Pastikan pakaian utuh, rata, dan tidak terhalang.
Bagaimana memilih gambar model yang sesuai?
Pilih foto full-body depan yang jelas dan utuh. Model sebaiknya mengenakan pakaian sederhana yang pas, seperti kaos dan celana pendek, serta hindari gaun panjang, lengan lebar, atau banyak lapisan. Selain itu, pastikan aksesori seperti tas atau payung tidak menghalangi tangan atau kaki model.
Apa yang harus dilakukan jika saya tidak memiliki gambar model yang sesuai?
Kami menyediakan gambar model referensi yang memenuhi persyaratan. Klik di sini untuk mengunduhnya.

Hasil tidak memuaskan

Mengapa gambar yang dihasilkan berkualitas rendah dan kurang detail?
Penyebab paling mungkin adalah gambar pakaian input berkualitas rendah. Pastikan gambar pakaian beresolusi tinggi dan utuh, tanpa kehilangan detail akibat lipatan atau sudut kamera yang buruk. Input berkualitas tinggi sangat penting untuk menghasilkan output berkualitas tinggi.

Menggunakan fitur

Bagaimana cara menghasilkan gambar try-on untuk gaun atau jumpsuit?
Masukkan URL gambar gaun atau jumpsuit ke dalam bidang input.top_garment_url, dan biarkan bidang input.bottom_garment_url kosong atau hilangkan.