Reskin Sprite V1

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/v1

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
resolution	string	Ya	Resolusi output. Nilai yang mungkin: 1K, 2K, 4K
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 resolution tidak valid	422	Nilai selain 1K, 2K, 4K 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

Opsi Gaya:

• pixel: Gaya pixel art
• cartoon: Gaya kartun
• sd: Gaya SD (Standard Definition)
• quater_view: Gaya quater view (isometrik)

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/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/sprite.png" \
-F "description=change the warrior character armor to golden" \
-F "resolution=2K"

cURL (Dengan Penentuan Gaya Pixel):

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