Sprite Lite

Tujuan

Menghasilkan animasi sprite dari satu gambar yang diunggah. Ini adalah fitur yang sama dengan tab Lite pada halaman "Buat sprite" di aplikasi web (Sprite Lite & Plus). Pilih jumlah frame dengan frame, persis seperti yang ditampilkan pada slider halaman web.

Biaya kredit: 5 (25 frame), 7 (36), 9 (49), 11 (64), 13 (81)

Metode dan Path

POST /public/v1/sprite/lite

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	Default	Deskripsi
image	file	Ya		Gambar dasar untuk sprite (PNG atau JPEG)
text	string	Ya		Prompt yang menjelaskan gerakan. Spasi dihapus (trim) dan teks tidak boleh kosong
frame	integer	Ya		Frame. Nilai yang diizinkan: 25, 36, 49, 64, 81
is_pixel	boolean	Tidak	false	Pixel art. Aktifkan ini jika gambar yang dilampirkan berbasis pixel art
is_prompt_enhancement	boolean	Tidak	true	Penyempurnaan prompt. Menyempurnakan input Anda agar lebih sesuai untuk pembuatan sprite

Kredit berdasarkan frame

frame	Kredit
25	5
36	7
49	9
64	11
81	13

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
Gambar bukan file PNG atau JPEG yang valid	400	"Invalid image file"
Nilai frame tidak diizinkan	400	"frame should be one of 25, 36, 49, 64, 81"
text kosong	400	"text must not be empty"
API key tidak valid	401	"Invalid API key"
Field hilang	422	Error validasi

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 (sprite sheet dan GIF)

Alur Status: Pending → Succeed atau Failed

Contoh Permintaan

cURL (pixel art):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/lite" \
-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, penyempurnaan prompt nonaktif):

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