Tài liệu chính thức
Hướng dẫn khắc phục sự cốMã trạng thái HTTPHướng dẫn vận hành và bảo trì
更新于 2026-11-18 · 约 5 分钟读完
Hướng dẫn khắc phục sự cố nhanh API mô hình lớn Mã trạng thái HTTP phổ biến (401/402/403/429/529)
Tóm tắt toàn diện về ý nghĩa mã trạng thái HTTP phổ biến, phương pháp định vị và cách thực hành tốt nhất của khách hàng khi gọi các giao diện OpenAI, Anthropic Claude và Gemini.
Danh sách kiểm tra nhanh mã trạng thái
| Mã trạng thái HTTP | Phân loại lỗi | Lý do cốt lõi | Giải pháp đề xuất |
|---|---|---|---|
400 Bad Request | Lỗi định dạng yêu cầu | Trường JSON là bất hợp pháp, max_tokens vượt quá giới hạn trên hoặc giao thức được chọn sai | Kiểm tra giao thức điểm cuối (ví dụ: tham số gốc của Claude được gửi tới /v1/messages) |
401 Unauthorized | Xác thực danh tính không thành công | sk-... Key viết sai chính tả, đã bị tắt hoặc thiếu tiêu đề yêu cầu | Đi tới [Kiểm tra khả năng tồn tại của khóa không cần đăng nhập] (/check) Xác minh tính hợp lệ của khóa bằng một cú nhấp chuột |
402 / 403 Forbidden | Hạn ngạch hoặc quyền hạn chế | Số dư tài khoản không đủ, hạn ngạch khóa con đã hết, IP không có trong danh sách trắng hoặc nhóm không chứa mô hình | Kiểm tra số dư bảng điều khiển, thanh tiến trình hạn ngạch khóa con và nhóm liên kết |
429 Too Many Requests | Tỷ lệ hoặc giới hạn dòng điện đồng thời | Vượt quá số lượng kênh đồng thời tối đa trong tài khoản hoặc kích hoạt giới hạn luân phiên 5h/ngày của khóa con | Cho phép thử lại thời gian chờ lũy thừa trên máy khách hoặc tăng chính sách giới hạn tốc độ trong bảng điều khiển |
502 / 503 / 529 | Tắc nghẽn tức thời ngược dòng | Rung giật tức thời trong thời kỳ đỉnh cao của sức mạnh tính toán ngược dòng chính thức | Cổng có tính năng chuyển đổi khắc phục thảm họa tự động ở cấp độ mili giây được tích hợp sẵn và khách hàng có thể khôi phục bằng cách thử lại |
Làm cách nào để xem chi tiết lỗi cụ thể trên bảng điều khiển?
Sau khi đăng nhập vào Bảng điều khiển dành cho nhà phát triển, hãy nhấp vào menu bên trái "📜 Hóa đơn gọi → Khắc phục sự cố yêu cầu bất thường" để xem trực tiếp dấu thời gian, mô hình mục tiêu, mã trạng thái HTTP và tóm tắt lỗi cụ thể của các yêu cầu không phải 200 gần đây mà không cần đoán mò.
Ví dụ về mã thử lại thời gian chờ lũy thừa của SDK môi trường sản xuất
python
from openai import OpenAI
# 官方 SDK 默认自带 max_retries=2 指数退避,生产环境建议设为 3
client = OpenAI(
base_url="https://suptoken.ai/v1",
api_key="sk-your-key",
max_retries=3,
timeout=120.0,
)
🚀 准备好在项目中极速接入了吗?
注册即可创建专属 API Key,原生直连 Claude 4.5、GPT-5 Codex 与 Gemini 2.5 Pro。