Buat Sprite V1

Tujuan

Menghasilkan animasi sprite berdasarkan gambar yang diunggah. Anda dapat membuat sprite sheet dengan gaya pixel art atau gaya umum.

Metode dan Path

POST /public/v1/sprite/make-sprite/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 yang akan menjadi dasar untuk pembuatan sprite
text	string	Ya	Prompt teks untuk pembuatan sprite
frame	integer	Ya	Jumlah frame yang akan dibuat. Harus salah satu dari: 25, 36, 49, 64, 81, 100, 121, 144, 169
is_pixel	boolean	Ya	Apakah gambar bergaya pixel art. true atau false

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
Invalid image file	400	"Invalid image file"
Nilai frame tidak diizinkan	400	"frame should be one of 25, 36, 49, 64, 81, 100, 121, 144, 169"
Autentikasi gagal	401	API key tidak valid

Nilai Frame yang Diizinkan:

• 25, 36, 49, 64, 81, 100, 121, 144, 169

Perilaku Job Async

Endpoint ini membuat job asynchronous. Endpoint akan segera mengembalikan job_id, dan pembuatan sprite sebenarnya terjadi 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 (GIF dan gambar frame individual)

Alur Status: Pending → Succeed atau Failed

Contoh Permintaan

cURL (gaya pixel art):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/character.png" \
-F "text=walking animation" \
-F "frame=64" \
-F "is_pixel=true"

cURL (gaya umum):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/make-sprite/v1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "image=@/path/to/character.png" \
-F "text=running animation cycle" \
-F "frame=36" \
-F "is_pixel=false"