Câu hỏi về API

Lỗi 401, không tìm thấy mô hình, quá thời gian chờ, lỗi 429, phản hồi bị cắt — triệu chứng và cách xử lý.

Các câu hỏi thường gặp về việc gọi API. Hãy đối chiếu với triệu chứng của bạn, rồi theo liên kết để xem chi tiết.

Gặp lỗi 401 Unauthorized?

  • Sai khóa: kiểm tra rằng bạn đang dùng khóa đầy đủ đã lưu lúc tạo (mục trong danh sách đã bị che bớt không phải là khóa đầy đủ);
  • Khóa đã xóa hoặc hết hạn: xác nhận trạng thái của nó ở trang "Khóa API" và tạo lại nếu cần;
  • Header sai định dạng: giao thức tương thích OpenAI cần Authorization: Bearer <key> — đừng bỏ tiền tố Bearer ;
  • Xem thêm tại Xác thực.

"Không tìm thấy mô hình"?

  • Model ID viết sai — hãy sao chép đúng ID từ chợ mô hình thay vì gõ tay;
  • Mô hình không tồn tại trên nền tảng hoặc hiện không khả dụng — kiểm tra xem thẻ mô hình có tồn tại và khả dụng trong chợ mô hình không.

Quá thời gian chờ hoặc phản hồi chậm?

  • Các yêu cầu ngữ cảnh dài / đầu ra dài vốn chậm hơn; hãy xem max_tokens có bị đặt cao không cần thiết không;
  • Đặt thời gian chờ và số lần thử lại hợp lý ở phía ứng dụng khách, với khoảng cách tăng dần theo cấp số nhân;
  • Với giao diện tương tác, dùng "stream": true — byte đầu tiên đến sớm hơn và độ trễ cảm nhận được giảm xuống.

Gặp nhiều lỗi 429?

Bạn đang chạm giới hạn tốc độ. Hãy giảm số luồng đồng thời, thêm khoảng nghỉ giữa các lần thử lại; nếu tải cao kéo dài, liên hệ nền tảng để trao đổi về hạn mức. Xem Mã lỗi.

Phản hồi trống hoặc bị cắt?

  • finish_reason là length: phản hồi đã chạm giới hạn max_tokens — hãy tăng lên;
  • Kiểm tra xem có mục nào trong messages mang content rỗng không;
  • Một số mô hình ràng buộc định dạng đầu vào (ví dụ yêu cầu về phương thức hình ảnh) — xem ghi chú trên thẻ mô hình.

Làm sao xác nhận một lệnh gọi thực sự thành công?

Có hai điểm kiểm tra: HTTP 200 với choices / usage trong phản hồi; và bản ghi tương ứng (kèm lượng token và chi phí) trên trang nhật ký trong bảng điều khiển. Khi cả hai khớp nhau, đường ống đang khỏe mạnh.