跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

概述

TokenLab 最容易按所需行为选择 SDK:
  • 需要 Claude 原生 /v1/messages 行为时,使用官方 Anthropic SDKs
  • 需要 Gemini 原生请求格式时,使用官方 Gemini / Google AI 工具
  • 迁移 OpenAI 兼容 /v1 路由或 Responses 风格用法时,使用官方 OpenAI SDKs
具体支持边界请以各集成页为准。在这套文档里,“recommended” 或 “supported” 代表存在已文档化的配置路径,并不自动等同于每个框架辅助层或提供商特定功能都做了端到端回归。

推荐的 SDK

OpenAI Python

pip install openai

OpenAI Node

npm install openai

OpenAI Go

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

Anthropic SDK

原生支持 Claude Messages API

OpenAI SDK 示例

当你迁移已有 OpenAI 兼容客户端,或明确想走 /v1 兼容路径时使用这个示例。需要 Claude 原生或 Gemini 原生功能时,请改用对应的原生 SDK。
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)

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
}

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!"}]
)

你应该使用哪个 SDK?

目标推荐路径
提供商原生行为原生提供商 SDK 或路由
已有 OpenAI 兼容客户端OpenAI SDK + TokenLab /v1
可移植聊天 / EmbeddingsOpenAI 兼容 /v1 路由
Claude 原生功能Anthropic SDK
Gemini 原生请求格式Gemini-native API / SDK
LangChain / LlamaIndex / Vercel AI SDK使用专门的集成页面

最佳实践

Anthropic 或 Gemini 原生路由适合提供商特定字段、工具、流式细节,以及不应通过另一种格式翻译的行为。
OpenAI 兼容 SDK 最适合已有 OpenAI 风格客户端、可移植聊天和 embeddings。它是兼容入口,不是 TokenLab 唯一的 API 表面。
在 client 配置中直接传入 TokenLab 的 base URL,而不是依赖较旧的环境变量别名。