Buat Gambar

Tujuan

Membuat gambar AI berdasarkan prompt teks. Anda dapat mengunggah gambar referensi secara opsional untuk mereferensikan gaya atau komposisi hasil pembuatan.

Metode dan Path

POST /public/v1/generate/image

Autentikasi

Lihat halaman Autentikasi. Token Bearer diperlukan.

Header yang Diperlukan:

Authorization: Bearer {your_api_key}

Field Permintaan

Nama Field	Tipe	Wajib	Deskripsi
prompt	string	Ya	Prompt teks untuk pembuatan gambar
ai_model	string	Ya	Model AI yang digunakan. Nilai yang mungkin: GPT Image 1.5, GPT Image 2, Grok Imagine, Grok Imagine Pro, Nano Banana, Nano Banana 2, Nano Banana Pro
ref_images	file[]	Tidak	File gambar referensi (multipart/form-data). Jumlah unggahan maksimum berbeda tergantung pada model AI

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	Pesan Kesalahan
Invalid image file	400	"Invalid image file"
ref_images melebihi 5 untuk model Grok Imagine	400	"The Grok Imagine model supports up to 5 ref_images."
ref_images melebihi 1 untuk model Grok Imagine Pro	400	"The Grok Imagine Pro model supports up to 1 ref_images."
ref_images melebihi 10 untuk model lain	400	"ref_images supports up to 10 images only"
Gagal autentikasi	401	Kunci API tidak valid

Batas Gambar Referensi:

• GPT Image 1.5: Maksimum 10
• Grok Imagine: Maksimum 5
• Grok Imagine Pro: Maksimum 1
• Seri Nano Banana: Maksimum 10

Perilaku Pekerjaan Asinkron

Endpoint ini membuat pekerjaan asinkron. Ini segera mengembalikan job_id setelah permintaan, dan pembuatan gambar 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 (tanpa gambar referensi):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "prompt=a beautiful sunset over mountains" \
-F "ai_model=GPT Image 1.5"

cURL (dengan gambar referensi):

curl -X POST "https://api.aetherforgeai.com/public/v1/generate/image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "prompt=a cat in the style of the reference" \
-F "ai_model=Grok Imagine" \
-F "ref_images=@/path/to/ref1.jpg" \
-F "ref_images=@/path/to/ref2.jpg"