Lỗi 401: cần làm gì khi gọi hy3 thất bại

Mã 401 nghĩa là xác thực thất bại: yêu cầu không có API Key, hoặc khóa không hợp lệ, đã bị xóa hay hết hạn.

401 Unauthorized nghĩa là request không có thông tin xác thực hợp lệ. Gateway không nhận diện được người gọi nên request không bao giờ tới model upstream. Kiểm tra header Authorization và trạng thái key là cách duy nhất.

hy3 được Tencent cung cấp. Mọi nội dung trên trang này — nguyên nhân, cách xử lý và dữ liệu đo được — đều tổng hợp từ hoạt động thực tế của mô hình này tại lớp gateway.

Tại gateway này, nguyên nhân thường gặp nhất là: Thiếu tiêu đề Authorization. Hành động đầu tiên nên làm là: Gửi tiêu đề theo dạng Authorization: Bearer kèm khóa của bạn.

Nguyên nhân thường gặp

  • Thiếu tiêu đề Authorization
  • Khóa viết sai hoặc có khoảng trắng thừa
  • Khóa đã bị xóa hoặc vô hiệu ở trang Token
  • Dùng nhầm khóa của nền tảng khác

Cách khắc phục

  • Gửi tiêu đề theo dạng Authorization: Bearer kèm khóa của bạn
  • Tạo khóa mới ở trang Token
  • Kiểm tra xem có đang dùng khóa của dịch vụ khác không
  • Xác minh khóa bằng một yêu cầu curl tối thiểu

Ví dụ thử lại với backoff luỹ thừa

Đoạn mã dưới sẽ thử lại khi hy3 trả về 401, tối đa 5 lần, thời gian chờ tăng dần kèm jitter ngẫu nhiên để các request đồng thời không retry cùng lúc. Hãy đọc base URL và API key từ biến môi trường, đừng hardcode vào code.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'hy3'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

Dữ liệu chính của mô hình này

Điểm cuối APIhttps://api.airai.cc/v1
Tương thích OpenAIOpenAI-compatible
Nhà cung cấpTencent
Ngữ cảnh256K
Khả năngReasoning, Tools, Open Weights
Định dạng APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Công thức tính phíp * 0 + cr * 0 + cc * 0 + c * 0

Câu hỏi thường gặp

Vì sao hy3 chỉ trả 401 vào một số khung giờ?

Gom lỗi theo thời gian và theo node trước; quy luật thường rất rõ. Nếu chỉ xảy ra ở môi trường production, thường là khác biệt môi trường chứ không phải mô hình. Mô hình này do Tencent cung cấp, vì vậy trạng thái upstream theo thông báo của nhà cung cấp. Ghi lại request ID mỗi lần thất bại — hữu dụng hơn status code. Tái hiện trước trong môi trường thử nghiệm với cùng request body.

Request đồng thời nên xếp hàng hay giới hạn trực tiếp?

Biến số thực sự ở đây là độ đồng thời và timeout, không phải bản thân mô hình. Hãy giảm độ đồng thời trước — hầu hết vấn đề về thông lượng sẽ biến mất. Model này có context window 256K và thuộc Tencent. Với đầu ra dài, hãy nâng timeout lên 60 giây hoặc hơn. Làm phẳng đỉnh tải bằng batch hoặc hàng đợi — ổn định hơn là tăng độ đồng thời tức thời.

401 có liên quan cách tính phí của hy3 không?

Không bị tính phí, chỉ output thực sự được tạo mới tính vào sử dụng. Cách tính phí theo p * 0 + cr * 0 + cc * 0 + c * 0, không có output thì không tính phí. Với cách tính phí p * 0 + cr * 0 + cc * 0 + c * 0, chi phí output dài chủ yếu từ output token. Kiểm tra số dư và giới hạn tốc độ trong console trước, rồi mới xem code. Khi ước tính chi phí từ p * 0 + cr * 0 + cc * 0 + c * 0, hãy tính cả ngân sách thử lại.

Đổi model khác có tránh được 401 trên hy3 không?

Nên chuẩn bị sẵn một model dự phòng. Model này của Tencent có nhiều node upstream để gateway chuyển đổi. Chuẩn bị sẵn một mô hình dự phòng nhẹ hơn để luồng chính không bị gián đoạn. Đưa tên mô hình vào config, đổi upstream sẽ không cần sửa code.

Lỗi khác của mô hình này

Các mô hình khác gặp cùng lỗi

Quay lại trang mô hình

Dữ liệu cập nhật: 2026-10-11 19:15

Hỗ trợ kỹ thuậtHỗ trợ trực tuyến
Về đầu trang