Giới hạn tốc độ & Lỗi

Một 429 có thể đến từ nhiều lớp:

• Giới hạn mô hình miễn phí của chúng tôi: 1 yêu cầu mỗi phút, cho mỗi mô hình miễn phí, cho mỗi người dùng.
• Giới hạn phía trên: nhà cung cấp đứng sau một mô hình miễn phí đã chạm giới hạn của chính họ.
• Ngân sách token hằng ngày trên một số nhóm miễn phí, đặt lại vào nửa đêm UTC.
• Giới hạn token mỗi phút, bị kích hoạt bởi các câu lệnh rất lớn.
• Giới hạn số yêu cầu chạy song song theo từng người dùng.

Các mô hình trả phí không có giới hạn tốc độ do UnoRouter áp đặt.

Khi giới hạn 1 lượt mỗi phút được kích hoạt, bạn nhận các header giới hạn tần suất tiêu chuẩn:

HTTP/1.1 429 Too Many Requests
Retry-After: 38
X-RateLimit-Limit: 1
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1783198478

Retry-After là số giây còn lại trong khung thời gian của bạn, không phải cố định 60. Thông báo nêu tên mô hình trả phí, vốn không có giới hạn này.

Một số mô hình trả phí được cung cấp miễn phí kèm giới hạn kích thước yêu cầu. Câu lệnh quá lớn trả về 413: Request body too large for gpt-4.1 model. Max size: 8000 tokens.

Giới hạn này chỉ áp dụng cho tuyến miễn phí. Mô hình trả phí nhận câu lệnh dài không giới hạn.

Lỗi trả về dạng JSON theo định dạng lỗi của OpenAI. code là một mã định danh ổn định. Mọi thông báo đều được nối thêm một request id:

{
  "error": {
    "message": "Model \"gpt-5.5-typo\" is not offered here. Check the model name for typos, or switch to a model from our supported list. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "model_not_found"
  }
}

Hãy kèm request id khi mở phiếu hỗ trợ. Nó giúp định vị yêu cầu của bạn trong nhật ký.

Nếu bạn vẫn đang thiết lập khóa hoặc URL cơ sở, hãy bắt đầu với Bắt đầu nhanh

Các mã trạng thái bạn thực sự sẽ gặp:

Hai tình huống rất khác nhau cùng chia sẻ trạng thái 503. Cái đầu tiên là tắc nghẽn tạm thời:

HTTP/1.1 503 Service Unavailable

{
  "error": {
    "message": "All providers for model \"kimi-k2.6:free\" are busy right now (they hit their rate limit). This is not a spelling error. Please try again in a little while, or switch to another model. (request id: 20260705...)",
    "type": "new_api_error",
    "code": "get_channel_failed"
  }
}

get_channel_failed nghĩa là mọi nhà cung cấp miễn phí cho mô hình đó đều đang bị giới hạn tần suất. Nó hết sau vài phút: hãy thử lại hoặc đổi mô hình. model_not_found nghĩa là tên đó không tra được; thử lại không bao giờ giúp ích. Hãy kiểm tra lỗi gõ hoặc xem danh mục.

Hãy coi get_channel_failed là lỗi có thể thử lại và model_not_found là lỗi dứt khoát.

Mô hình biến mất do tải sẽ tự quay lại; để được báo ngay khi nó trở lại, hãy theo dõi trong Thông báo

Nếu khóa của bạn ghim nhóm nhà cung cấp, còn một loại 503 thứ ba khi chỉ các nhóm đã ghim ngừng hoạt động, xem Ghim nhóm

Hãy tôn trọng Retry-After khi gặp 429. Thử lại 503 get_channel_failed sau một lát, hoặc đổi mô hình. Đừng thử lại các lỗi thuộc nhóm 400.

Yêu cầu thất bại hoặc bị từ chối không bao giờ bị tính phí; cơ chế tạm giữ và hoàn tiền được mô tả trong Tài khoản & Thanh toán