TokiLabsDocs
Tham khảo

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

Gặp sự cố hãy xem ở đây trước. Nếu vẫn chưa giải quyết được, vui lòng gửi email tới team@support.tokilabs.xyz, kèm thông báo lỗi và thời điểm gửi yêu cầu.

Lỗi

Trả về 401 / token không hợp lệ
  • Kiểm tra key đã được sao chép đầy đủ chưa (bắt đầu bằng sk-, không có khoảng trắng ở đầu và cuối).
  • Token có thể đã hết hạn, bị vô hiệu hóa hoặc hết hạn mức, xem trạng thái tại Bảng điều khiển → Token.
  • Số dư tài khoản không đủ cũng khiến yêu cầu thất bại, kiểm tra trong “Ví”.
Báo mô hình không tồn tại hoặc không có kênh khả dụng

Hãy đảm bảo tên mô hình khớp hoàn toàn với Danh sách mô hình.

Trả về 404 Not Found

Thường do đặt /v1 sai vị trí:

  • Claude Code, Anthropic SDK: https://api.tokilabs.xyz (không có /v1)
  • OpenAI SDK, Codex, Cursor và tương tự: https://api.tokilabs.xyz/v1 (có /v1)
Trả về 429 quá nhiều yêu cầu

Gửi yêu cầu quá dày trong thời gian ngắn. Đợi một lát rồi thử lại; với tác vụ hàng loạt hãy giảm số luồng đồng thời.

Cấu hình

Đã đặt biến môi trường nhưng không có hiệu lực
  • Windows: biến môi trường chỉ có hiệu lực với chương trình mở sau đó, hãy đóng tất cả terminal và VS Code rồi mở lại, nếu cần thì đăng xuất và đăng nhập lại.
  • macOS / Linux: chạy source ~/.zshrc (hoặc ~/.bashrc), hoặc mở một cửa sổ terminal mới.
  • Dùng echo $ANTHROPIC_BASE_URL (PowerShell: $env:ANTHROPIC_BASE_URL) để xác nhận biến thực sự tồn tại.
Claude Code yêu cầu đăng nhập tài khoản chính thức sau khi khởi động

Thêm "hasCompletedOnboarding": true vào ~/.claude.json, và xác nhận đã đặt ANTHROPIC_AUTH_TOKEN. Nếu trước đây đã đăng nhập tài khoản chính thức, hãy chạy /logout trong Claude Code trước. Xem chi tiết tại Claude Code.

PowerShell báo “running scripts is disabled”

Chạy một lần:

PowerShell
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
Lệnh curl trong PowerShell báo lỗi

Trong Windows PowerShell 5.1, curl là bí danh của Invoke-WebRequest, tham số hoàn toàn khác. Hãy dùng curl.exe.

npm install -g báo không đủ quyền (EACCES)

Xảy ra khi dùng Node đi kèm hệ thống trên macOS / Linux. Khuyến nghị chuyển sang cài Node bằng nvm (xem Hướng dẫn Linux), không dùng sudo npm.

Mạng

Yêu cầu quá thời gian hoặc kết nối thất bại
  • Trước tiên mở api.tokilabs.xyz trong trình duyệt để xác nhận truy cập bình thường.
  • Nếu đang bật proxy, kiểm tra biến môi trường HTTPS_PROXY / HTTP_PROXY có trỏ tới địa chỉ đã hỏng không. Có thể thêm api.tokilabs.xyz vào NO_PROXY để kết nối trực tiếp.
  • Mạng công ty có thể chặn yêu cầu HTTPS, hãy thử đổi mạng khác.
Kết nối bị ngắt khi tạo nội dung lâu

Nên bật đầu ra dạng luồng (stream: true), và đặt thời gian chờ của client từ 10 phút trở lên.

Tính phí

Tính phí như thế nào?

Tính phí theo số Token thực tế sử dụng, đầu vào, đầu ra, đọc/ghi bộ nhớ đệm được tính giá riêng. Giá cụ thể xem tại trang Bảng giá, chi tiết từng lần gọi có thể tra cứu trong Nhật ký sử dụng.

Key bị lộ thì phải làm sao?

Xóa ngay token đó tại Bảng điều khiển → Token, sau đó tạo token mới và cập nhật vào các công cụ của bạn.