Reskin Sprite V2

Tujuan

Mengubah tampilan gambar sprite yang ada untuk membuat sprite dengan gaya baru. Digunakan saat mengubah tampilan karakter atau mengubah ke gaya yang berbeda.

Metode dan Path

POST /public/v1/sprite/reskin/v2

Autentikasi

Lihat halaman Autentikasi. Token Bearer diperlukan.

Header yang Diperlukan:

Authorization: Bearer {your_api_key}

Field Permintaan

Nama Field	Tipe	Wajib	Deskripsi
image	file	Ya	File gambar sprite asli untuk di-reskin
description	string	Ya	Penjelasan tentang perubahan yang akan diterapkan pada sprite
quality	string	Ya	Tingkat kualitas. Nilai yang mungkin: standard, pro
style	string	Tidak	Penentuan gaya. Nilai yang mungkin: pixel, cartoon, sd, quater_view

Respons

Respons Sukses (200 OK):

{
  "job_id": "uuid-string"
}

Field	Tipe	Deskripsi
job_id	string	Pengidentifikasi unik pekerjaan yang dibuat. Ambil hasil dengan Get Job Status

Aturan Kesalahan / Validasi

Situasi	Status HTTP	Deskripsi
Invalid image file	400	"Invalid image file"
Nilai quality tidak valid	422	Nilai selain standard, pro akan menghasilkan kesalahan validasi
Nilai style tidak valid	422	Nilai selain pixel, cartoon, sd, quater_view akan menghasilkan kesalahan validasi
Gagal autentikasi	401	Kunci API tidak valid

Perilaku Pekerjaan Asinkron

Endpoint ini membuat pekerjaan asinkron. Ini segera mengembalikan job_id setelah permintaan, dan pekerjaan reskin aktual berlangsung di latar belakang.

Cara Polling:

1. Simpan job_id yang diterima dari respons
2. Lakukan polling ke GET /public/v1/job/{job_id} untuk memeriksa status
3. Ketika status menjadi Succeed, periksa hasil di image_urls

Alur Status: Pending → Succeed atau Failed

Contoh Permintaan

cURL (Gaya Dasar):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/reskin/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/sprite.png" \
-F "description=change the warrior character armor to golden" \
-F "quality=standard"

cURL (Dengan Penentuan Gaya Pixel):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/reskin/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/sprite.png" \
-F "description=convert the character to pixel art style" \
-F "quality=pro" \
-F "style=pixel"