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 HTTPPhân loại lỗiLý do cốt lõiGiải pháp đề xuất
400 Bad RequestLỗi định dạng yêu cầuTrườ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 saiKiể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 UnauthorizedXác thực danh tính không thành côngsk-... 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 ForbiddenHạ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ìnhKiể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 RequestsTỷ lệ hoặc giới hạn dòng điện đồng thờiVượ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 conCho 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 / 529Tắc nghẽn tức thời ngược dòngRung 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ứcCổ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。

在线流式测试 免费获取 API Key →

相关推荐阅读