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

​
Tổng quan

TokenLab dễ tích hợp nhất khi khớp SDK với hành vi bạn cần:
  • các SDK Anthropic chính thức cho hành vi gốc của Claude /v1/messages
  • công cụ Gemini / Google AI chính thức cho các định dạng yêu cầu gốc của Gemini
  • các SDK OpenAI chính thức cho các route /v1 tương thích với OpenAI và cách sử dụng kiểu Responses
Hãy dùng các trang tích hợp để hiểu ranh giới hỗ trợ. Trong bộ tài liệu này, “recommended” hoặc “supported” nghĩa là có đường dẫn thiết lập được tài liệu hóa; không tự động bao phủ mọi helper framework hoặc tính năng riêng của provider.

​
Các SDK được khuyến nghị

OpenAI Python

pip install openai

OpenAI Node

npm install openai

OpenAI Go

go get github.com/openai/openai-go/v3

Anthropic SDK

Hỗ trợ API Claude Messages gốc

​
Ví dụ OpenAI SDK

Hãy dùng điều này khi bạn đang chuyển đổi một client tương thích OpenAI hiện có hoặc muốn dùng đường dẫn tương thích /v1. Với các tính năng native của Claude hoặc Gemini, hãy dùng SDK native tương ứng thay thế. 
from openai import OpenAI

client = OpenAI(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh/v1"
)

response = client.responses.create(
    model="gpt-5.4",
    input="Explain TokenLab in one sentence."
)

print(response.output_text)

​
Ví dụ OpenAI Go

package main

import (
    openai "github.com/openai/openai-go/v3"
    "github.com/openai/openai-go/v3/option"
)

func main() {
    client := openai.NewClient(
        option.WithAPIKey("sk-your-api-key"),
        option.WithBaseURL("https://api.tokenlab.sh/v1"),
    )

    _ = client
}

​
Ví dụ Anthropic SDK

from anthropic import Anthropic

client = Anthropic(
    api_key="sk-your-api-key",
    base_url="https://api.tokenlab.sh"
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello!"}]
)

​
Bạn nên sử dụng SDK nào?

Mục tiêuĐường dẫn được khuyến nghị
Hành vi gốc của nhà cung cấpSDK hoặc tuyến của nhà cung cấp gốc
Máy khách tương thích với OpenAI hiện cóOpenAI SDK trên TokenLab /v1
Chat di động / embeddingsCác route tương thích với OpenAI /v1
Tính năng gốc của ClaudeAnthropic SDK
Cấu trúc yêu cầu gốc của GeminiAPI / SDK gốc của Gemini
LangChain / LlamaIndex / Vercel AI SDKSử dụng các trang tích hợp dành riêng

​
Các thực hành tốt nhất

Hãy dùng các tuyến gốc của Anthropic hoặc Gemini cho các trường đặc thù của nhà cung cấp, công cụ, chi tiết streaming, và các hành vi khác không nên được chuyển qua một định dạng khác.
Các SDK tương thích OpenAI là lựa chọn tốt nhất cho các client kiểu OpenAI hiện có, chat di động và embeddings. Hãy xem chúng như một tuyến tương thích, không phải là bề mặt API duy nhất của TokenLab.
Hãy truyền trực tiếp các URL gốc của TokenLab trong cấu hình client của bạn thay vì dựa vào các bí danh biến môi trường cũ.