Sprite Plus

Tujuan

Menghasilkan animasi sprite dari frame awal dan frame akhir opsional. Ini adalah fitur yang sama dengan tab Plus 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: 9 (49 frame), 13 (81 frame)

Metode dan Path

POST /public/v1/sprite/plus

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
start_image	file	Ya		Frame awal (PNG atau JPEG)
end_image	file	Tidak		Frame akhir (opsional) (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: 49, 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
49	9
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
Salah satu gambar bukan file PNG atau JPEG yang valid	400	"Invalid image file"
Nilai frame tidak diizinkan	400	"frame should be one of 49, 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 (hanya frame awal):

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

cURL (frame awal + akhir):

curl -X POST "https://api.aetherforgeai.com/public/v1/sprite/plus" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "start_image=@/path/to/character_start.png" \
-F "end_image=@/path/to/character_end.png" \
-F "text=running animation cycle" \
-F "frame=81"