Hướng Dẫn Di Chuyển

TokenLab hỗ trợ nhiều định dạng: bạn có thể giữ lại các khách hàng tương thích với OpenAI, các cuộc gọi Messages gốc của Anthropic, các cuộc gọi REST gốc của Gemini và các điểm cuối truyền thông ở dạng tự nhiên của chúng. Việc di chuyển an toàn nhất là không dịch mọi khối lượng công việc thành một định dạng chung. Chọn lộ trình phù hợp với hành vi mà ứng dụng của bạn cần.

Bản Đồ Lộ Trình

Khối lượng công việc hiện tại	URL cơ sở TokenLab	Điểm cuối chính	Ghi chú di chuyển
OpenAI Chat Completions	`https://api.tokenlab.sh/v1`	`/chat/completions`	Thay đổi nhỏ nhất cho cuộc trò chuyện tương thích với OpenAI và gọi hàm
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 xử lý đầu ra cụ thể cho 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 lộ trình Gemini
Tạo phương tiện	`https://api.tokenlab.sh/v1`	`/images`, `/videos`, `/music`, `/3d`	Khám phá các mô hình với `recommended_for` và mong đợi việc kiểm tra bất đồng bộ nơi có tài liệu
Quản lý và thanh toán	`https://api.tokenlab.sh/v1`	`/management/...`	Sử dụng mã thông báo quản lý cho việc sử dụng phía máy chủ và đối chiếu thanh toán

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.4",
    messages=[{"role": "user", "content": "Hello from TokenLab"}],
)

Giữ lại mã retry, timeout và streaming hiện tại của bạn, nhưng xác thực ID mô hình với GET /v1/models trước khi có lưu lượng sản xuất. Đối với việc tạo hình ảnh, gửi model một cách rõ ràng và đọc hướng dẫn hình ảnh vì các mô hình hình ảnh khác nhau nhiều hơn so với các mô hình trò chuyện.

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-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Explain TokenLab in one sentence."}],
)

Sử dụng /v1/messages cho việc sử dụng công cụ gốc của Claude, các luồng suy nghĩ và ngữ nghĩa tin nhắn của Anthropic. Không dịch các trường chỉ có của Anthropic thông qua Chat Completions trừ khi bạn cố ý muốn thay đổi hành vi tương thích với OpenAI.

Di Chuyển Gemini

curl "https://api.tokenlab.sh/v1beta/models/gemini-3.5-flash:generateContent" \
  -H "Authorization: Bearer sk-your-tokenlab-key" \
  -H "Content-Type: application/json" \
  -d '{"contents":[{"parts":[{"text":"Hello"}]}]}'

Giữ lại các công cụ tích hợp sẵn của Gemini, các tham chiếu API File, nội dung đã lưu, 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 Phương Tiện

Truy vấn GET /v1/models?recommended_for=image|video|music|3d.
Đọc tokenlab.public_contract_summary trong các phản hồi danh sách và toàn bộ tokenlab.public_contract nơi có sẵn.
Gửi một model rõ ràng, đặc biệt cho các điểm cuối hình ảnh.
Lưu trữ task_id, poll_url, điểm cuối, mô hình và ID công việc của riêng bạn cho các công việc bất đồng bộ.
Đối chiếu chi phí thông qua các bản ghi sử dụng và billing_transaction_id, không phải ID công việc của nhà cung cấp.

Các khối lượng công việc truyền thông cần có kế hoạch triển khai riêng vì độ trễ, các lần thử lại và tài sản cuối cùng hoạt động khác với các cuộc trò chuyện hoàn thành.

Kế Hoạch Triển Khai Sản Xuất

Giai đoạn	Mục tiêu	Kiểm tra
1. Kiểm kê	Liệt kê các điểm cuối, mô hình, trường yêu cầu, hành vi streaming/bất đồng bộ và chủ sở hữu thanh toán	Không có trường chỉ có của nhà cung cấp nào được giả định là công khai
2. Thí điểm một lộ trình	Di chuyển một điểm cuối và một gia đình mô hình	Hình dạng phản hồi, chi phí và nhật ký khớp với mong đợi
3. Bóng hoặc mẫu	So sánh các đầu ra đã chọn với nhà cung cấp trước đó	Chất lượng và độ trễ có thể nhìn thấy bởi người dùng là chấp nhận được
4. Triển khai dần dần	Tăng lưu lượng theo khóa, tổ chức hoặc cờ tính năng	Theo dõi `4xx`, `5xx`, độ trễ, cân bằng và các công việc bất đồng bộ trùng lặp
5. Dọn dẹp	Xóa đường dẫn của nhà cung cấp cũ chỉ sau khi sử dụng ổn định	Đường dẫn quay lại và sách hướng dẫn hỗ trợ được tài liệu hóa

Cạm Bẫy Di Chuyển

Không đặt mọi mô hình 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.
Không giả định các mặc định hình ảnh cũ. Gửi model một cách rõ ràng.
Không thử lại các yêu cầu tạo bất đồng bộ mà không kiểm tra xem một nhiệm vụ đã được tạo hay chưa.
Không tiết lộ siêu dữ liệu định tuyến của nhà cung cấp trong nhật ký hoặc giao diện người dùng của bạn.
Không so sánh thanh toán với ID công việc của nhà cung cấp. Sử dụng các bản ghi sử dụng của TokenLab.

Tài Liệu API

Chủ đề	Tài liệu tham khảo
API Đa Định Dạng	API Đa Định Dạng
OpenAI SDK	OpenAI SDK
Anthropic SDK	Anthropic SDK
Gemini Native	Gemini Native API
Tạo Hình Ảnh	Tạo Hình Ảnh
Công Việc Bất Đồng Bộ & Kiểm Tra	Công Việc Bất Đồng Bộ & Kiểm Tra

​Bản Đồ Lộ Trình

​Di Chuyển Tương Thích Với OpenAI

​Di Chuyển Anthropic

​Di Chuyển Gemini

​Di Chuyển Phương Tiện

​Kế Hoạch Triển Khai Sản Xuất

​Cạm Bẫy Di Chuyển

​Tài Liệu API