Dokumentasi

Ralat / Had kadar

Ralat

Ralat HTTP mengandungi objek ralat dengan kod dan mesej. Tugasan yang berjaya diterima masih boleh gagal kemudian; tanya status tugasan atau kendalikan panggilan semula kegagalannya.

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

HTTP	Medan	Tindakan yang perlu diambil
400	`invalid_request`	Betulkan fail JSON, prom yang hilang, julat parameter atau URL media sebelum mencuba semula.
401	`invalid_api_key`	Semak token Bearer dan pastikan kunci API adalah aktif.
402	`insufficient_credits`	Tambah kredit atau kurangkan kos tugasan. Respons mungkin menyertakan amaun yang diperlukan dan amaun yang tersedia.
403	`forbidden`	Sila semak sekatan peringkat akaun yang dinyatakan dalam mesej ralat.
404	`not_found`	Semak ID tugasan dan pastikan kunci tersebut milik pengguna tugasan berkenaan.
429	`rate_limited`	Tunggu selang masa Retry-After sebelum mencuba semula.
500	`internal_error`	Periksa mesej ralat dan log API. Cuba semula dengan berhati-hati; menghantar semula permintaan cipta boleh mencipta satu lagi tugasan yang boleh dicaj.

Had kadar

Cipta tugasan: setiap kunci API membenarkan sehingga 100 permintaan seminit secara lalai. Had kadar tersuai tidak ditawarkan buat masa ini.

Kueri tugasan: setiap kunci API membenarkan sehingga 120 permintaan seminit secara lalai. Permintaan kueri dan permintaan penciptaan tugasan dikira secara berasingan.

Permintaan penciptaan imej dan video berkongsi had kadar kunci API yang sama.

HTTP 429 menyertakan Retry-After: 60 untuk penciptaan dan Retry-After: 5 untuk pertanyaan. Gunakan fungsi undur masa (backoff) dan elakkan daripada melakukan pengundian lebih kerap daripada yang diperlukan.

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

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