Mã lỗi của API
Mọi lỗi API trả về, kèm mã HTTP, mã lỗi và cách xử lý. Lỗi dùng định dạng của OpenAI.
Mã lỗi
Lỗi theo định dạng OpenAI: {"error": {"message", "type", "code"}}.
| HTTP | code | |
|---|---|---|
| 400 | invalid_request | Body không phải JSON hợp lệ, hoặc thiếu/sai trường. Thông báo nêu rõ trường nào. |
| 400 | wrong_endpoint | Model thuộc loại khác: model chat dùng /chat/completions, model ảnh dùng /images/generations, model video dùng /videos. |
| 400 | size_not_available / format_not_available / too_many_images | Model ảnh không tạo kích thước hoặc định dạng file này, hoặc nhận nhiều ảnh đầu vào hơn mức cho phép. Thông báo nêu rõ những gì được chấp nhận. |
| 400 | resolution_not_available | Model video không bán ở độ phân giải này. |
| 400 | video_not_ready | Video chưa hoàn tất; tiếp tục gọi GET /videos/{id}. |
| 400 | not_a_draft / draft_not_ready / draft_wrong_model / draft_expired | draft_id phải là bản nháp đã hoàn tất của cùng model, tạo trong vòng 7 ngày. |
| 400 | user_required | Chỉ với tài khoản relay: mọi request chat phải có trường user. |
| 401 | invalid_api_key | Thiếu, sai hoặc đã thu hồi API key. |
| 402 | insufficient_balance / key_spend_cap | Nạp thêm tiền, hoặc tăng trần chi theo ngày của key. |
| 403 | account_inactive | Tài khoản đang bị tạm ngưng. |
| 403 | ip_not_allowed | Key có danh sách IP được phép và request đến từ địa chỉ khác. |
| 404 | model_not_found | Không có model này. Xem GET /models. |
| 404 | video_not_found / draft_not_found | Tài khoản của bạn không có video hoặc bản nháp này. |
| 404 | video_expired / last_frame_expired / image_expired / no_last_frame | File không còn được lưu, hoặc request không yêu cầu khung cuối. Link ảnh dùng được 1 giờ. Link video dùng được một tuần; video chưa sao chép được về kho của chúng tôi chỉ được phát từ nhà cung cấp model trong 24 giờ. |
| 404 | not_found | Không có đường dẫn này. Xem mục Endpoints. |
| 405 | method_not_allowed | Sai phương thức HTTP cho đường dẫn này, ví dụ GET tới /chat/completions. |
| 413 | request_too_large | Body của request quá lớn. |
| 429 | rate_limit_exceeded / concurrency_limit / model_at_capacity | Giảm tốc và thử lại sau thời gian trong header Retry-After. |
| 429 | model_rate_limit_exceeded / model_concurrency_limit | Tài khoản đã chạm giới hạn của riêng model này. Các model khác vẫn dùng được; thử lại sau thời gian trong header Retry-After. |
| 429 | upstream_rate_limited | Bản thân model đang chạm giới hạn tốc độ. Thử lại sau vài giây; bạn không bị tính tiền. |
| 429 | too_many_failed_requests | Key gửi quá nhiều request lỗi liên tiếp và bị tạm dừng trong thời gian ghi ở Retry-After. Sửa lỗi bạn đang gặp rồi thử lại. |
| 500 | internal_error | Có lỗi phía chúng tôi. Thử lại, và gửi request_id cho hỗ trợ nếu lỗi lặp lại. |
| 502 | upstream_error | Nhà cung cấp model lỗi. Có thể thử lại; bạn không bị tính tiền. |
| 503 | upstream_unavailable / billing_unavailable / config_unavailable / model_not_priced / gateway_draining | Tạm thời. Thử lại với thời gian chờ tăng dần. |
| 504 | upstream_error | Model không trả lời kịp. Có thể thử lại; bạn không bị tính tiền. |
