Asynchronous image generation

Reve Image API

Kirim prompt, terima job ID, lalu polling hingga gambar WebP siap. Worker, retry, pemeriksaan kuota, dan rotasi pool akun dikelola server.

● Operational

Endpoint

POST/v1/images/generations

Membuat job baru. Mengembalikan HTTP 202.

GET/v1/jobs/{id}

Status: queued, running, succeeded, atau failed.

GET/v1/jobs/{id}/image

Mengunduh hasil WebP setelah job sukses.

GET/health

Health check publik tanpa autentikasi.

Autentikasi

Semua endpoint /v1 menerima salah satu header berikut:

X-API-Key: YOUR_API_KEY

# atau
Authorization: Bearer YOUR_API_KEY

Buat gambar

curl -X POST https://api-reve.estimasion.my.id/v1/images/generations \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "prompt": "Cinematic rice terraces at sunrise",
    "aspect_ratio": "16:9",
    "n": 1
  }'

Contoh respons:

{
  "id": "JOB_UUID",
  "status": "queued",
  "error": null,
  "created_at": "...",
  "updated_at": "..."
}

Polling dan download

curl -H 'X-API-Key: YOUR_API_KEY' \
  https://api-reve.estimasion.my.id/v1/jobs/JOB_UUID

curl -H 'X-API-Key: YOUR_API_KEY' \
  https://api-reve.estimasion.my.id/v1/jobs/JOB_UUID/image \
  -o result.webp

Endpoint image mengembalikan HTTP 409 selama gambar belum siap. Gunakan interval polling sekitar 2–5 detik.

Aspect ratio

4:1, 3:1, 21:9, 2:1, 17:9, 16:9, 3:2, 4:3, 5:4, 1:1, 4:5, 3:4, 2:3, 9:16, 1:2, 1:3, 1:4, dan auto. Saat ini n harus 1.