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"}}.

HTTPcode
400invalid_requestBody 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.
400wrong_endpointModel thuộc loại khác: model chat dùng /chat/completions, model ảnh dùng /images/generations, model video dùng /videos.
400size_not_available / format_not_available / too_many_imagesModel ả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.
400resolution_not_availableModel video không bán ở độ phân giải này.
400video_not_readyVideo chưa hoàn tất; tiếp tục gọi GET /videos/{id}.
400not_a_draft / draft_not_ready / draft_wrong_model / draft_expireddraft_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.
400user_requiredChỉ với tài khoản relay: mọi request chat phải có trường user.
401invalid_api_keyThiếu, sai hoặc đã thu hồi API key.
402insufficient_balance / key_spend_capNạp thêm tiền, hoặc tăng trần chi theo ngày của key.
403account_inactiveTài khoản đang bị tạm ngưng.
403ip_not_allowedKey có danh sách IP được phép và request đến từ địa chỉ khác.
404model_not_foundKhông có model này. Xem GET /models.
404video_not_found / draft_not_foundTài khoản của bạn không có video hoặc bản nháp này.
404video_expired / last_frame_expired / image_expired / no_last_frameFile 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ờ.
404not_foundKhông có đường dẫn này. Xem mục Endpoints.
405method_not_allowedSai phương thức HTTP cho đường dẫn này, ví dụ GET tới /chat/completions.
413request_too_largeBody của request quá lớn.
429rate_limit_exceeded / concurrency_limit / model_at_capacityGiảm tốc và thử lại sau thời gian trong header Retry-After.
429model_rate_limit_exceeded / model_concurrency_limitTà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.
429upstream_rate_limitedBả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.
429too_many_failed_requestsKey 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.
500internal_errorCó 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.
502upstream_errorNhà cung cấp model lỗi. Có thể thử lại; bạn không bị tính tiền.
503upstream_unavailable / billing_unavailable / config_unavailable / model_not_priced / gateway_drainingTạm thời. Thử lại với thời gian chờ tăng dần.
504upstream_errorModel không trả lời kịp. Có thể thử lại; bạn không bị tính tiền.