Saltar para o conteúdo principal

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.

Visão geral

A forma mais simples de integrar a TokenLab é escolher o SDK conforme o comportamento necessário:
  • Anthropic SDKs oficiais para comportamento Claude-native /v1/messages
  • ferramentas Gemini / Google AI oficiais para formatos Gemini-native
  • OpenAI SDKs oficiais para rotas /v1 compatíveis com OpenAI e uso no estilo Responses
Use as páginas de integração para limites de suporte. Aqui, “recommended” ou “supported” significa que existe um caminho de configuração documentado; não significa que todo helper ou recurso específico do provedor tenha teste end-to-end neste repo.

SDKs recomendados

OpenAI Python

pip install openai

OpenAI Node

npm install openai

OpenAI Go

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

Anthropic SDK

Suporte nativo à API Claude Messages

Exemplo de OpenAI SDK

Use isto ao migrar um cliente compatível com OpenAI existente ou quando quiser o caminho de compatibilidade /v1. Para recursos Claude-native ou Gemini-native, use o SDK nativo correspondente.
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)

Exemplo de 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
}

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

Qual SDK você deve usar?

ObjetivoCaminho recomendado
Comportamento nativo do provedorSDK ou rota nativa do provedor
Cliente compatível com OpenAI existenteOpenAI SDK em TokenLab /v1
Chat portátil / embeddingsRotas /v1 compatíveis com OpenAI
Recursos Claude-nativeAnthropic SDK
Formatos Gemini-nativeGemini-native API / SDK
LangChain / LlamaIndex / Vercel AI SDKUse as páginas de integração dedicadas

Melhores práticas

Use rotas nativas Anthropic ou Gemini para campos, ferramentas, detalhes de streaming e outros comportamentos específicos do provedor que não devem ser traduzidos por outro formato.
SDKs compatíveis com OpenAI são o melhor caminho para clientes existentes no estilo OpenAI, chat portátil e embeddings. Trate-os como rota de compatibilidade, não como a única superfície API da TokenLab.
Passe as base URLs da TokenLab diretamente na configuração do cliente, em vez de depender de aliases antigos de variáveis de ambiente.