Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
API Key

Tất cả các yêu cầu TokenLab API đều yêu cầu một API key. Đối với các endpoint tương thích OpenAI, gửi nó dưới dạng: 
Authorization: Bearer sk-your-api-key
Đối với các yêu cầu /v1/messages tương thích Anthropic, bạn cũng có thể sử dụng: 
x-api-key: sk-your-api-key

​
Lấy API Key của bạn

  1. Đăng nhập vào TokenLab Dashboard của bạn
  2. Mở API Keys
  3. Tạo một key mới
  4. Đặt cho nó một tên mang tính mô tả
  5. Sao chép ngay lập tức vì nó chỉ được hiển thị một lần
  • Không bao giờ để lộ API key trong mã phía client
  • Không bao giờ commit API key vào hệ thống quản lý phiên bản
  • Sử dụng biến môi trường hoặc trình quản lý secret
  • Luân phiên key định kỳ
  • Xóa các key không sử dụng

​
Sử dụng API Key

curl https://api.tokenlab.sh/v1/responses \
  -H "Authorization: Bearer $TOKENLAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "input": "Hello!"
  }'

​
Tính năng của API Key

​
Giới hạn sử dụng

Bạn có thể đặt giới hạn sử dụng cho từng API key:
Thiết lậpMô tả
No LimitKey sử dụng số dư tài khoản của bạn mà không có hạn chế
Fixed LimitKey ngừng hoạt động sau khi đạt đến số tiền được chỉ định

​
Tiền tố của Key

Tất cả API key của TokenLab đều bắt đầu bằng sk-.

​
Tương thích Anthropic

Đối với endpoint /v1/messages, header theo kiểu Anthropic hoạt động như mong đợi: 
curl https://api.tokenlab.sh/v1/messages \
  -H "x-api-key: sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
Sử dụng Authorization: Bearer ... cho các endpoint tương thích OpenAI như /v1/responses, /v1/chat/completions, /v1/models, và hầu hết các route TokenLab khác.

​
Phản hồi lỗi

Mã trạng tháiKiểuMãMô tả
401invalid_api_keyinvalid_api_keyThiếu hoặc API key không hợp lệ
401expired_api_keyexpired_api_keyAPI key đã bị thu hồi
402insufficient_balanceinsufficient_balanceSố dư tài khoản không đủ
402quota_exceededquota_exceededĐã đạt đến giới hạn sử dụng của API key
Ví dụ: 
{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_api_key",
    "code": "invalid_api_key"
  }
}