Lỗi

aicentos dùng hoàn toàn định dạng phản hồi lỗi của OpenAI. Khi SDK ném lỗi, chỉ cần catch exception tương ứng.

Cấu trúc phản hồi lỗiSao chép liên kết neo

Mọi phản hồi lỗi đều theo định dạng này:

{
  "error": {
    "message": "API Key của bạn không có quyền truy cập gpt-5",
    "type": "permission_denied",
    "code": "model_not_allowed",
    "param": "model"
  }
}

Bảng tra nhanh mã trạng thái HTTPSao chép liên kết neo

Lỗi thường gặp và cách xử lýSao chép liên kết neo

401 — Invalid API keySao chép liên kết neo

{ "error": { "message": "Incorrect API key provided", "type": "authentication_error" } }

Danh sách cần kiểm tra:

• Header Authorization có đúng định dạng Bearer sk-xxx không (chú ý có dấu cách)
• Key có bị dính dấu cách / xuống dòng khi sao chép từ Console không
• Key đã bị xóa / vô hiệu hóa / hết hạn chưa
• Có lỡ dùng key test trên môi trường production không

402 — Insufficient quotaSao chép liên kết neo

{ "error": { "message": "Insufficient quota", "type": "insufficient_quota" } }

Nạp tiền → Console, mục "Quản lý ví". Bật cảnh báo số dư để tránh tái diễn.

403 — Model not allowedSao chép liên kết neo

{ "error": { "message": "Model gpt-5 not allowed for this key", "code": "model_not_allowed" } }

Khi tạo token đã tick whitelist "Mô hình khả dụng", model yêu cầu không nằm trong đó. Sửa cài đặt token hoặc đổi Key.

404 — Model not foundSao chép liên kết neo

{ "error": { "message": "The model 'gpt-4-turbo-2024-04-09' does not exist", "code": "model_not_found" } }

ID mô hình bị gõ sai hoặc đã ngừng cung cấp. Vào thị trường mô hình để xác nhận ID hiện đang khả dụng.

429 — Rate limit exceededSao chép liên kết neo

Header phản hồi Retry-After cho biết bao nhiêu giây sau nên thử lại. Giảm mức đồng thời và tần suất request là sẽ phục hồi.

500 / 502 / 503 — Lỗi dịch vụSao chép liên kết neo

Thường do upstream chập chờn. Tự động thử lại 2-3 lần thường là thành công. Nếu kéo dài quá 5 phút:

• Xem trang trạng thái (nếu có)
• Liên hệ bộ phận hỗ trợ

408 / 504 — TimeoutSao chép liên kết neo

Request quá 60s không phản hồi. Nguyên nhân thường gặp:

• Prompt quá dài khiến mô hình "suy nghĩ" vượt thời gian
• Chưa bật streaming (phản hồi dài nên thêm stream: true)

Cách xử lý:

• Rút ngắn prompt
• Bật streaming: { "model": "...", "messages": [...], "stream": true }
• Chuyển sang mô hình nhanh hơn (ví dụ từ gpt-4o sang gpt-4o-mini)

Ví dụ xử lý lỗi trong SDKSao chép liên kết neo

export AICENTOS_API_KEY="sk-your-aicentos-api-key"

PythonSao chép liên kết neo

import os
from openai import OpenAI, APIError, RateLimitError, AuthenticationError

client = OpenAI(api_key=os.environ["AICENTOS_API_KEY"], base_url="https://aicentos.com/v1")

try:
    resp = client.chat.completions.create(
        model="gpt-4o-mini",
        messages=[{"role": "user", "content": "hi"}],
    )
except AuthenticationError:
    print("Sai Key")
except RateLimitError as e:
    print(f"Bị rate limit, thử lại sau {e.response.headers.get('Retry-After')}s")
except APIError as e:
    print(f"Lỗi API khác: {e.status_code} {e.message}")

Node.jsSao chép liên kết neo

import OpenAI, { APIError } from 'openai';

const client = new OpenAI({
  apiKey: process.env.AICENTOS_API_KEY,
  baseURL: 'https://aicentos.com/v1',
});

try {
  const resp = await client.chat.completions.create({ ... });
} catch (err) {
  if (err instanceof APIError) {
    console.log(err.status, err.code, err.message);
  }
}

Khuyến nghị retry và giảm cấpSao chép liên kết neo

SDK chính thức của OpenAI mặc định đã có chính sách retry hợp lý, code production hãy dùng thẳng SDK, đừng tự fetch.