Kode error API
Setiap error yang dikembalikan API, lengkap dengan status HTTP, kode, dan cara menanganinya. Error menggunakan format OpenAI.
Error
Error menggunakan format OpenAI: {"error": {"message", "type", "code"}}.
| HTTP | code | |
|---|---|---|
| 400 | invalid_request | Body bukan JSON yang valid, atau ada field yang hilang atau salah. Pesan menyebutkan field yang mana. |
| 400 | wrong_endpoint | Model tersebut berjenis lain: model chat menggunakan /chat/completions, model gambar /images/generations, model video /videos. |
| 400 | size_not_available / format_not_available / too_many_images | Model gambar tidak membuat ukuran atau format file ini, atau menerima lebih banyak gambar input daripada yang diizinkan. Pesan menyebutkan apa yang diterima. |
| 400 | resolution_not_available | Model video tidak dijual pada resolusi ini. |
| 400 | video_not_ready | Video belum selesai; terus polling GET /videos/{id}. |
| 400 | not_a_draft / draft_not_ready / draft_wrong_model / draft_expired | draft_id harus berupa draf yang sudah selesai dari model yang sama, dibuat dalam 7 hari terakhir. |
| 400 | user_required | Khusus akun relay: setiap request chat harus menyertakan field user. |
| 401 | invalid_api_key | API key tidak ada, salah, atau telah dicabut. |
| 402 | insufficient_balance / key_spend_cap | Isi ulang saldo Anda, atau naikkan batas harian key. |
| 403 | account_inactive | Akun sedang ditangguhkan. |
| 403 | ip_not_allowed | Key memiliki whitelist IP dan request berasal dari alamat lain. |
| 404 | model_not_found | Id model tidak dikenal. Lihat GET /models. |
| 404 | video_not_found / draft_not_found | Tidak ada video atau draf tersebut di akun Anda. |
| 404 | video_expired / last_frame_expired / image_expired / no_last_frame | File sudah tidak disimpan, atau frame terakhir tidak diminta. Tautan gambar berlaku 1 jam. Tautan video berlaku seminggu; video yang tidak dapat kami salin ke penyimpanan kami hanya disajikan dari penyedia model selama 24 jam. |
| 404 | not_found | Path tersebut tidak ada. Lihat Endpoints. |
| 405 | method_not_allowed | Metode HTTP salah untuk path ini, misalnya GET pada /chat/completions. |
| 413 | request_too_large | Body request terlalu besar. |
| 429 | rate_limit_exceeded / concurrency_limit / model_at_capacity | Kurangi laju request dan coba lagi setelah waktu di header Retry-After. |
| 429 | model_rate_limit_exceeded / model_concurrency_limit | Akun Anda mencapai batas untuk model ini saja. Model lain tetap berfungsi; coba lagi setelah waktu di header Retry-After. |
| 429 | upstream_rate_limited | Model itu sendiri sedang mencapai rate limit-nya. Coba lagi dalam beberapa detik; Anda tidak ditagih. |
| 429 | too_many_failed_requests | Key mengirim terlalu banyak request gagal secara berturut-turut dan dijeda selama waktu di Retry-After. Perbaiki error yang Anda terima, lalu coba lagi. |
| 500 | internal_error | Terjadi kegagalan di pihak kami. Coba lagi, dan sampaikan request_id ke tim dukungan jika terulang. |
| 502 | upstream_error | Penyedia model gagal. Aman untuk dicoba lagi; Anda tidak ditagih. |
| 503 | upstream_unavailable / billing_unavailable / config_unavailable / model_not_priced / gateway_draining | Sementara. Coba lagi dengan backoff. |
| 504 | upstream_error | Model tidak menjawab tepat waktu. Aman untuk dicoba lagi; Anda tidak ditagih. |
