Pasang variasi

Tujuan

Memasang item dari lembar item ke gambar dasar karakter dan menghasilkan variasi yang sudah dipasangi item. Ini adalah fitur yang sama dengan halaman "Pasang variasi" di aplikasi web.

Biaya kredit: 5

Metode dan Path

POST /public/v1/image-tune/equip-variation

Autentikasi

Lihat halaman autentikasi. Token Bearer diperlukan.

Header yang Diperlukan:

Authorization: Bearer {your_api_key}

Field Permintaan

Kirim permintaan sebagai multipart/form-data.

Nama Field	Tipe	Wajib	Deskripsi
character_image	file	Ya	Gambar dasar karakter (PNG atau JPEG)
item_sheet_image	file	Ya	Gambar lembar item (PNG atau JPEG)
prompt	string	Ya	Prompt yang menjelaskan cara memasang item. Spasi dihapus (trim) dan prompt tidak boleh kosong

Respons

Respons Berhasil (200 OK):

{
  "job_id": "uuid-string"
}

Field	Tipe	Deskripsi
job_id	string	Pengidentifikasi unik untuk job yang dibuat. Gunakan Get Job Status untuk melihat hasil

Aturan Error / Validasi

Kondisi	Status HTTP	Pesan Error
Salah satu gambar bukan file PNG atau JPEG yang valid	400	"Invalid image file"
prompt kosong	400	"prompt must not be empty"
API key tidak valid	401	"Invalid API key"
Field hilang	422	Error validasi

Kedua gambar divalidasi sebelum apa pun diunggah, sehingga permintaan yang gagal tidak pernah meninggalkan unggahan parsial.

Perilaku Job Async

Endpoint ini membuat job asynchronous. Endpoint akan segera mengembalikan job_id, dan pembuatan berjalan di latar belakang.

Metode Polling:

1. Simpan job_id yang diterima dari respons
2. Poll GET /public/v1/job/{job_id} untuk memeriksa status
3. Saat status menjadi Succeed, lihat hasil pada image_urls

Alur Status: Pending → Succeed atau Failed

Contoh Permintaan

cURL:

curl -X POST "https://api.aetherforgeai.com/public/v1/image-tune/equip-variation" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "character_image=@/path/to/character.png" \
-F "item_sheet_image=@/path/to/item_sheet.png" \
-F "prompt=equip the iron sword and the leather helmet"