Dokumentasi

Error / Batas frekuensi

Error

Error HTTP memiliki objek error dengan kode dan pesan. Tugas yang berhasil diterima masih bisa gagal nanti; kueri tugas atau tangani callback kegagalannya.

{
  "error": {
    "code": "invalid_request",
    "message": "input.prompt is required."
  }
}

HTTP	Kolom	Tindakan
400	`invalid_request`	Perbaiki JSON, prompt yang hilang, rentang parameter, atau URL media sebelum mencoba lagi.
401	`invalid_api_key`	Periksa Bearer token dan apakah kunci API aktif.
402	`insufficient_credits`	Tambahkan kredit atau kurangi biaya tugas. Respons mungkin menyertakan jumlah yang diperlukan dan yang tersedia.
403	`forbidden`	Periksa batasan tingkat akun yang dijelaskan dalam pesan kesalahan.
404	`not_found`	Periksa ID tugas dan pastikan kunci tersebut milik pengguna tugas.
429	`rate_limited`	Tunggu interval Retry-After sebelum mencoba lagi.
500	`internal_error`	Periksa pesan error dan log API. Coba lagi dengan hati-hati; mengirim ulang permintaan pembuatan dapat membuat tugas berbayar lainnya.

Batas frekuensi

Membuat tugas: secara default, setiap kunci API mengizinkan hingga 100 permintaan per menit. Batas frekuensi kustom saat ini belum tersedia.

Kueri tugas: secara default, setiap kunci API mengizinkan hingga 120 permintaan per menit. Permintaan kueri dan permintaan pembuatan tugas dihitung secara terpisah.

Permintaan pembuatan gambar dan video berbagi batas tingkat (rate limit) kunci API yang sama.

HTTP 429 menyertakan Retry-After: 60 untuk pembuatan dan Retry-After: 5 untuk kueri. Gunakan backoff dan hindari polling lebih sering dari yang diperlukan.

HTTP/1.1 429 Too Many Requests
Content-Type: application/json
Retry-After: 60

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded."
  }
}