Buat Efek V2

Tujuan

Menghasilkan hasil bergaya efek secara asinkron. Anda dapat memberikan deskripsi teks untuk memandu pembuatan efek dan, secara opsional, mengunggah gambar.

Metode dan Jalur

POST /public/v1/generate/effect/v2

Autentikasi

Lihat halaman Autentikasi. Token Bearer wajib.

Header yang Diperlukan:

Authorization: Bearer {your_api_key}

Bidang Permintaan

Nama Bidang	Tipe	Wajib	Deskripsi
description	string	Ya	Deskripsi efek
quality	string	Ya	Kualitas output: standard, pro
frame	number	Ya	Jumlah frame: 4, 9, 16
image	file	Tidak	Gambar referensi opsional

Respons

Respons Sukses (200 OK):

{
  "job_id": "uuid-string"
}

Nama Bidang	Tipe	Deskripsi
job_id	string	ID unik untuk job yang dibuat. Gunakan Dapatkan Status Pekerjaan untuk melihat hasil

Aturan Kesalahan / Validasi

Kondisi	Status HTTP	Pesan Kesalahan
Invalid image file	400	"Invalid image file"
Kunci API tidak valid	401	Invalid API key

Perilaku Pekerjaan Asinkron

Endpoint ini membuat pekerjaan asinkron. job_id segera dikembalikan, sedangkan proses pembuatan efek berjalan 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. Saat status menjadi Succeed, lihat hasil di image_urls

Alur Status: Pending → Succeed atau Failed

Contoh Permintaan

cURL (tanpa gambar):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/effect/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "description=apply a glowing fantasy aura" \
-F "quality=standard" \
-F "frame=4"

cURL (dengan gambar):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/effect/v2" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "description=apply a neon cyberpunk effect" \
-F "quality=pro" \
-F "frame=16" \
-F "image=@/path/to/input.png"