Hướng dẫn cốt lõi
Hướng dẫn di chuyển
Chuyển đổi các client OpenAI, Anthropic, Gemini và media hiện có sang TokenLab
Giữ nguyên định dạng yêu cầu mà ứng dụng của bạn đang sử dụng. Các client tương thích với OpenAI, Anthropic Messages, Gemini REST và các endpoint media đều có địa chỉ API TokenLab tương ứng.
Ánh xạ API
| API hiện tại | URL cơ sở TokenLab | Endpoint | Lưu ý |
|---|---|---|---|
| OpenAI Chat Completions | https://api.tokenlab.sh/v1 | /chat/completions | Thay đổi nhỏ nhất cho chat và gọi hàm tương thích với OpenAI |
| OpenAI Responses | https://api.tokenlab.sh/v1 | /responses | Sử dụng khi ứng dụng của bạn phụ thuộc vào đầu vào, công cụ hoặc cách xử lý đầu ra đặc thù của Responses |
| Anthropic SDK | https://api.tokenlab.sh | /v1/messages | Không thêm /v1 vào URL cơ sở của SDK |
| Gemini REST | https://api.tokenlab.sh | /v1beta/models/:model:generateContent | Giữ các trường gốc của Gemini trên route Gemini |
| Tạo media | https://api.tokenlab.sh/v1 | /images/generations, /videos/generations, /music/generations, /3d/generations | Khám phá các model với recommended_for và dự kiến việc polling bất đồng bộ ở nơi có tài liệu hướng dẫn |
| Quản lý và thanh toán | https://api.tokenlab.sh/v1 | /management/... | Các lệnh gọi phía máy chủ sử dụng token quản lý, không phải API key của model |
Các công thức di chuyển nhanh
Từ OpenAI sang TokenLab
Thay đổi base_url / baseURL của SDK thành https://api.tokenlab.sh/v1, thay thế API key và chọn một ID model từ GET /v1/models.
Từ OpenRouter sang TokenLab
Thay thế URL cơ sở của OpenRouter bằng https://api.tokenlab.sh/v1. Các ID model của TokenLab không bao gồm tiền tố nhà cung cấp OpenRouter. Chỉ sử dụng Anthropic Messages hoặc Gemini khi ứng dụng của bạn cần các trường từ các định dạng đó.
Từ LiteLLM sang TokenLab
Sử dụng cấu hình custom_openai/<model> của LiteLLM với api_base: https://api.tokenlab.sh/v1. Giữ bí danh LiteLLM của bạn tách biệt với ID model của TokenLab để có thể thay đổi một trong hai mà không cần chỉnh sửa các prompt của ứng dụng.
Claude Messages qua TokenLab
Trỏ các client Anthropic SDK vào https://api.tokenlab.sh và gọi messages.create. Không thêm /v1 vào URL cơ sở của SDK; SDK đã sở hữu đường dẫn /v1/messages.
Gemini Native qua TokenLab
Giữ các payload Gemini trên https://api.tokenlab.sh/v1beta/models/{model}:generateContent. Các thành phần contents, parts, file, nội dung được lưu cache, khai báo hàm và các công cụ tích hợp sẵn của Gemini nên được giữ trên route này khi ứng dụng của bạn phụ thuộc vào hành vi của Gemini.
Di chuyển tương thích với OpenAI
from openai import OpenAI
client = OpenAI(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh/v1",
)
response = client.chat.completions.create(
model="gpt-5.6-terra",
messages=[{"role": "user", "content": "Hello from TokenLab"}],
)Mã xử lý thử lại (retry), timeout và streaming hiện tại của bạn thường có thể giữ nguyên. Xác nhận ID model với GET /v1/models. Các yêu cầu hình ảnh phải bao gồm model một cách rõ ràng; xem hướng dẫn về hình ảnh để biết các đầu vào dành riêng cho từng model.
Di chuyển Anthropic
from anthropic import Anthropic
client = Anthropic(
api_key="sk-your-tokenlab-key",
base_url="https://api.tokenlab.sh",
)
message = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
messages=[{"role": "user", "content": "Reply with: Connected to TokenLab."}],
)Sử dụng /v1/messages cho các lệnh gọi công cụ của Claude, các khối suy nghĩ (thinking blocks) và các trường tin nhắn của Anthropic. Chat Completions không đảm bảo các trường đó.
Di chuyển Gemini
curl "https://api.tokenlab.sh/v1beta/models/gemini-3.6-flash:generateContent" \
-H "Authorization: Bearer sk-your-tokenlab-key" \
-H "Content-Type: application/json" \
-d '{"contents":[{"parts":[{"text":"Hello"}]}]}'Giữ các công cụ tích hợp sẵn của Gemini, tham chiếu File API, nội dung được lưu cache, khai báo hàm và các phần nội dung gốc trên /v1beta khi ứng dụng của bạn phụ thuộc vào hành vi gốc của Gemini.
Di chuyển Media
- Truy vấn
GET /v1/models?recommended_for=image|video|music|3d. - Đọc danh sách model từ
GET /v1/modelsvà chi tiết đầy đủ từGET /v1/models/{model}. - Gửi một
modelcụ thể, đặc biệt là đối với các endpoint hình ảnh. - Lưu trữ
task_id,poll_url, endpoint, model và ID công việc của riêng bạn cho các công việc bất đồng bộ. Poll chúng bằngGET /v1/tasks/{id}. - Đối soát chi phí thông qua hồ sơ sử dụng và
billing_transaction_id, không phải ID tác vụ của nhà cung cấp.
Việc tạo media có thể hoàn tất bất đồng bộ, vì vậy hãy lưu task_id và poll_url trước khi thay thế một tích hợp hiện có. Timeout của yêu cầu tạo không được tạo ra một công việc người dùng thứ hai.
Các lưu ý khi di chuyển
- Đừng đặt mọi model đằng sau một đường dẫn OpenAI Chat Completions nếu ứng dụng của bạn cần hành vi gốc của Anthropic, Gemini hoặc Responses.
- Đừng giả định các giá trị mặc định của hình ảnh cũ. Hãy gửi
modelmột cách rõ ràng. - Đừng thử lại các yêu cầu tạo bất đồng bộ mà không kiểm tra xem tác vụ đã được tạo hay chưa.
- Sử dụng ID tác vụ và hồ sơ sử dụng của TokenLab trong sản phẩm của bạn. ID tác vụ của bên thứ ba không phải là định danh thanh toán.
Tài liệu tham khảo API
| Chủ đề | Tham khảo |
|---|---|
| API đa định dạng | Multi-Format API |
| OpenAI SDK | OpenAI SDK |
| Anthropic SDK | Anthropic SDK |
| Gemini Native | Gemini Native API |
| Tạo hình ảnh | Image Generation |
| Công việc bất đồng bộ & Polling | Async Jobs & Polling |