status_code=500, not implemented
Nếu lỗi có cả status_code=500 và not implemented, trước hết hãy kiểm tra model đã chọn có hỗ trợ giao thức của endpoint hiện tại hay không. Ví dụ, /v1/responses yêu cầu openai-response trong supported_endpoint_types. Nếu loại này không có, đó là không tương thích giao thức, không phải sự cố upstream sẽ tự hết khi chờ.
- Ứng dụng tự xây dựng chọn endpoint theo
supported_endpoint_types; khi cóopenai, dùng/v1/chat/completions. - Với Claude Code, làm theo hướng dẫn Claude Code và xác nhận model hỗ trợ
anthropic. - Chọn endpoint tương thích và thực hiện một kiểm tra ngắn; chờ hoặc đổi mạng không sửa được lỗi này.
400 Bad Request / tham số không tương thích
400 thường nghĩa là định dạng yêu cầu, tham số hoặc trạng thái phiên không đúng với endpoint hiện tại.- Sao chép chính xác model ID từ Chợ mô hình.
- Xác nhận endpoint, model và client khớp trong tổng quan tích hợp.
- Kiểm tra model có hỗ trợ tham số ảnh, tool call, reasoning hoặc tiếp tục phiên hay không.
- Cập nhật client hoặc SDK cũ.
- Tạo phiên mới và gửi một yêu cầu văn bản ngắn.
401 Unauthorized
Nguyên nhân thường là key thiếu, sai, bị vô hiệu hóa/hết hạn hoặc header xác thực sai định dạng.403 Forbidden
403 nghĩa là yêu cầu bị từ chối. Các lý do phổ biến: key không có quyền vào nhóm đã chọn, hạn chế model, IP allowlist không khớp, trạng thái tài khoản không khả dụng hoặc upstream từ chối. Kiểm tra nhóm key, hạn chế model và IP allowlist, rồi thử một yêu cầu văn bản ngắn. Nếu vẫn lỗi, cung cấp Request ID, model, thời gian và nguyên văn lỗi. Retry tần suất cao hoặc tạo thêm key sẽ không gỡ bỏ hạn chế này.404 Not Found / địa chỉ yêu cầu sai
Hãy kiểm tra trước:- Base URL có bị ghép thành
/v1/v1/...không; - client có tự thêm
/v1hoặc đường dẫn endpoint không; - bạn có dùng đúng
/v1/chat/completions,/v1/responses,/v1/messageshoặc/v1/images/generationskhông.
503 / no available channel.
429 Too Many Requests
429 có thể do giới hạn tốc độ của nền tảng hoặc giới hạn ngắn hạn của model.Concurrency limit exceeded for user thường là giới hạn đồng thời của upstream hoặc client; không chỉ dựa vào mã trạng thái để kết luận key có lỗi.
- Giảm đồng thời; ưu tiên tuân theo
Retry-After, nếu không có thì dùng exponential backoff kèm jitter ngẫu nhiên. - Không để nhiều chương trình retry nhanh bằng cùng key.
- Nếu vẫn xuất hiện khi gọi thưa, gửi Request ID để kiểm tra khả dụng dịch vụ.
500, 502, 503, 504 hoặc 524
Ngoài lỗinot implemented nêu trên, các mã này thường là lỗi xử lý, ngắt kết nối, quá tải hoặc timeout, không nhất thiết do key hay prompt sai.
Nếu một tác vụ dài tiếp tục lỗi trên cùng model, hãy rút ngắn tác vụ hoặc thử lại sau trước khi gửi lại.
no available channel / model hiện không có dịch vụ khả dụng
Điều này nghĩa là nhóm của Key hiện tại tạm thời không có dịch vụ khả dụng cho model đó. ID sai, model không có trong nhóm, model tạm thời không khả dụng hoặc đang bảo trì đều có thể gây ra.
Hãy thử lại sau hoặc chọn model khác đang hiển thị cho nhóm trong Chợ mô hình. Nếu lỗi tiếp diễn, gửi tên model, Request ID và thời gian; không cần nạp lại tiền hoặc tạo key mới.
Concurrency limit exceeded for user
Số yêu cầu đang hoạt động của tài khoản đã đạt giới hạn. Chờ yêu cầu đang chạy kết thúc rồi giảm đồng thời. Không cần vô hiệu hóa hay tạo lại API Key vì lỗi này.
Lỗi hội thoại dài hoặc tool call
Invalid signature in thinking block
Nội dung reasoning đã lưu trong phiên hiện tại không còn xác thực được; điều này hay xảy ra khi tiếp tục phiên dài, trạng thái client thay đổi hoặc khả năng tương thích thay đổi. Hãy tạo phiên mới, cập nhật client và tránh tiếp tục cùng một phiên trên nhiều thiết bị.
previous_response_id is only supported on Responses WebSocket v2
Client đang tiếp tục phản hồi cũ qua cách kết nối không được hỗ trợ. Hãy tạo phiên mới, tắt tính năng tiếp tục/tái sử dụng phản hồi thử nghiệm hoặc cập nhật client.
Content block not found
Client không nhận được mảnh nội dung hoàn chỉnh cần thiết, thường trong hội thoại dài, tool call hoặc stream bị ngắt. Hãy tạo phiên mới, rút ngắn đầu vào và thử một yêu cầu đơn giản trước. Nếu vẫn xảy ra, hãy tạm tắt tool call không cần thiết và gửi hỗ trợ Request ID, thời điểm, mô hình cùng lỗi gốc. Chúng tôi sẽ dùng các thông tin này để kiểm tra trạng thái dịch vụ.
Hết thời gian tạo ảnh hoặc không hỗ trợ khả năng
Model ảnh chỉ dùng endpoint ảnh; model văn bản không dùng được endpoint tạo ảnh. Tạo ảnh hiện là yêu cầu đồng bộ và có thể mất thời gian; hãy chờ kết quả hoặc timeout trước khi lặp lại tác vụ.Image generation is not enabled/model not supported: kiểm tra model, endpoint và tham số.504/524/ client timeout: lưu Request ID và thời gian, không tạo lại ngay.