TokenLab

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ạiURL cơ sở TokenLabEndpointLưu ý
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completionsThay đổi nhỏ nhất cho chat và gọi hàm tương thích với OpenAI
OpenAI Responseshttps://api.tokenlab.sh/v1/responsesSử 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 SDKhttps://api.tokenlab.sh/v1/messagesKhông thêm /v1 vào URL cơ sở của SDK
Gemini RESThttps://api.tokenlab.sh/v1beta/models/:model:generateContentGiữ các trường gốc của Gemini trên route Gemini
Tạo mediahttps://api.tokenlab.sh/v1/images/generations, /videos/generations, /music/generations, /3d/generationsKhá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ánhttps://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

  1. Truy vấn GET /v1/models?recommended_for=image|video|music|3d.
  2. Đọc danh sách model từ GET /v1/models và chi tiết đầy đủ từ GET /v1/models/{model}.
  3. Gửi một model cụ thể, đặc biệt là đối với các endpoint hình ảnh.
  4. 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ằng GET /v1/tasks/{id}.
  5. Đố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 model mộ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ạngMulti-Format API
OpenAI SDKOpenAI SDK
Anthropic SDKAnthropic SDK
Gemini NativeGemini Native API
Tạo hình ảnhImage Generation
Công việc bất đồng bộ & PollingAsync Jobs & Polling

Trên trang này