Xác thực

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

Đăng nhập vào TokenLab Dashboard của bạn
Mở API Keys
Tạo một key mới
Đặt cho nó một tên mang tính mô tả
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!"
  }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get("TOKENLAB_API_KEY"),
    base_url="https://api.tokenlab.sh/v1"
)

import OpenAI from 'openai';

const client = new OpenAI({
  apiKey: process.env.TOKENLAB_API_KEY,
  baseURL: 'https://api.tokenlab.sh/v1'
});

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ập	Mô tả
No Limit	Key sử dụng số dư tài khoản của bạn mà không có hạn chế
Fixed Limit	Key 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ái	Kiểu	Mã	Mô tả
401	`invalid_api_key`	`invalid_api_key`	Thiếu hoặc API key không hợp lệ
401	`expired_api_key`	`expired_api_key`	API key đã bị thu hồi
402	`insufficient_balance`	`insufficient_balance`	Số dư tài khoản không đủ
402	`quota_exceeded`	`quota_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"
  }
}

Bắt đầu

Hướng dẫn cốt lõi

Hướng dẫn media

API Key

Lấy API Key của bạn

Sử dụng API Key

Tính năng của API Key

Giới hạn sử dụng

Tiền tố của Key

Tương thích Anthropic

Phản hồi lỗi

​API Key

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

​Sử dụng API Key

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

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

​Tiền tố của Key

​Tương thích Anthropic

​Phản hồi lỗi

API Key

Lấy API Key của bạn

Sử dụng API Key

Tính năng của API Key

Giới hạn sử dụng

Tiền tố của Key

Tương thích Anthropic

Phản hồi lỗi