# API Z Image Referensi API lengkap untuk generasi text-to-image Z Image. ## Varian Model API ini mendukung satu varian model: | Model | ID | Deskripsi | |-------|-----|-------------| | **Z Image** | `z-image` | Generasi text-to-image cepat | ## Perbandingan Cepat | Fitur | Z Image | |---------|---------| | Masukan | Prompt teks | | Keluaran | Satu gambar yang dihasilkan | | Rasio Aspek | Mendukung beberapa rasio | | Resolusi | Diturunkan dari nilai rasio lebar/tinggi | | `seed` | Opsional | ### Rasio Aspek yang Didukung Pasangan `width:height` harus berupa salah satu dari: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (Text-to-Image) ### Titik Akhir ``` POST /api/v1/image/task ``` ### Parameter Permintaan #### Wajib | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `model_name` | string | Harus berupa `"z-image"` | | `prompt` | string | Prompt generasi gambar | | `width` | number | Nilai rasio lebar (misalnya, `16` untuk `16:9`) | | `height` | number | Nilai rasio tinggi (misalnya, `9` untuk `16:9`) | #### Opsional | Parameter | Tipe | Deskripsi | |-----------|------|-------------| | `seed` | number | Seed acak dalam rentang `[0, 2147483647]`. Gunakan `null` atau `0` untuk generasi acak. | ### Contoh Permintaan ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Format Respons Respons submit: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` Polling dengan `GET /api/v1/image/{task_id}`. Status tugas: `submitted`, `processing`, `succeed`, `failed`. Respons polling yang berhasil menampilkan URL gambar yang dihasilkan di bawah `data.task_result.images[].url`. ## Praktik Terbaik - Gunakan nilai rasio, bukan dimensi piksel, untuk `width` dan `height`. - Jaga prompt tetap deskriptif tetapi fokus pada subjek, pencahayaan, dan komposisi. - Gunakan `seed` tetap saat Anda ingin generasi yang dapat direproduksi selama pengujian.