Guías principales

Guías de migración

Traslade sus clientes existentes de OpenAI, Anthropic, Gemini y multimedia a TokenLab

Mantenga el formato de solicitud que ya utiliza su aplicación. Los clientes compatibles con OpenAI, Anthropic Messages, Gemini REST y los endpoints de multimedia tienen cada uno una dirección de API de TokenLab correspondiente.

Mapeo de API

API existenteURL base de TokenLabEndpointA tener en cuenta
OpenAI Chat Completionshttps://api.tokenlab.sh/v1/chat/completionsEl cambio más sencillo para chat y llamadas a funciones compatibles con OpenAI
OpenAI Responseshttps://api.tokenlab.sh/v1/responsesÚselo cuando su aplicación dependa de entradas, herramientas o manejo de salidas específicos de Responses
Anthropic SDKhttps://api.tokenlab.sh/v1/messagesNo añada /v1 a la URL base del SDK
Gemini RESThttps://api.tokenlab.sh/v1beta/models/:model:generateContentMantenga los campos nativos de Gemini en la ruta de Gemini
Generación de multimediahttps://api.tokenlab.sh/v1/images/generations, /videos/generations, /music/generations, /3d/generationsDescubra modelos con recommended_for y espere sondeo asíncrono donde esté documentado
Gestión y facturaciónhttps://api.tokenlab.sh/v1/management/...Las llamadas del lado del servidor usan un token de gestión, no una clave de API de modelo

Recetas de migración rápida

De OpenAI a TokenLab

Cambie la base_url / baseURL del SDK a https://api.tokenlab.sh/v1, reemplace la clave de API y elija un ID de modelo desde GET /v1/models.

De OpenRouter a TokenLab

Reemplace la URL base de OpenRouter con https://api.tokenlab.sh/v1. Los IDs de modelo de TokenLab no incluyen un prefijo de proveedor de OpenRouter. Utilice Anthropic Messages o Gemini solo cuando su aplicación necesite campos de esos formatos.

De LiteLLM a TokenLab

Utilice la configuración custom_openai/<model> de LiteLLM con api_base: https://api.tokenlab.sh/v1. Mantenga su alias de LiteLLM separado del ID de modelo de TokenLab para que cualquiera de los dos pueda cambiar sin editar los prompts de la aplicación.

Claude Messages a través de TokenLab

Apunte los clientes del SDK de Anthropic a https://api.tokenlab.sh y llame a messages.create. No añada /v1 a la URL base del SDK; el SDK posee la ruta /v1/messages.

Gemini Native a través de TokenLab

Mantenga los payloads de Gemini en https://api.tokenlab.sh/v1beta/models/{model}:generateContent. Los contents, parts, archivos, contenidos cacheados, declaraciones de funciones y herramientas integradas nativos de Gemini deben permanecer en esta ruta cuando su aplicación dependa del comportamiento de Gemini.

Migración compatible con 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"}],
)

Su código existente de reintentos, tiempos de espera y streaming generalmente puede permanecer igual. Confirme el ID del modelo con GET /v1/models. Las solicitudes de imágenes deben incluir un modelo explícitamente; consulte la guía de imágenes para conocer las entradas específicas del modelo.

Migración de 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."}],
)

Utilice /v1/messages para llamadas a herramientas de Claude, bloques de pensamiento y campos de mensajes de Anthropic. Chat Completions no garantiza esos campos.

Migración de 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"}]}]}'

Mantenga las herramientas integradas de Gemini, las referencias a File API, los contenidos cacheados, las declaraciones de funciones y las partes de contenido nativas en /v1beta cuando su aplicación dependa del comportamiento nativo de Gemini.

Migración de multimedia

  1. Consulte GET /v1/models?recommended_for=image|video|music|3d.
  2. Lea la lista de modelos desde GET /v1/models y los detalles completos desde GET /v1/models/{model}.
  3. Envíe un model explícito, especialmente para los endpoints de imágenes.
  4. Almacene task_id, poll_url, endpoint, modelo y su propio ID de trabajo para trabajos asíncronos. Sondee los mismos con GET /v1/tasks/{id}.
  5. Concilie los costos a través de registros de uso y billing_transaction_id, no mediante IDs de tarea del proveedor.

La generación de multimedia puede finalizar de forma asíncrona, así que guarde el task_id y la poll_url antes de reemplazar una integración existente. Un tiempo de espera en la solicitud de creación no debe producir un segundo trabajo de usuario.

Errores comunes de migración

  • No coloque todos los modelos detrás de una única ruta de OpenAI Chat Completions si su aplicación necesita el comportamiento nativo de Anthropic, Gemini o Responses.
  • No asuma valores predeterminados antiguos para imágenes. Envíe el model explícitamente.
  • No reintente solicitudes de creación asíncronas sin verificar si una tarea ya fue creada.
  • Utilice los IDs de tarea y registros de uso de TokenLab en su producto. Los IDs de tarea de terceros no son identificadores de facturación.

Referencia de API

TemaReferencia
API multiformatoAPI multiformato
SDK de OpenAISDK de OpenAI
SDK de AnthropicSDK de Anthropic
Gemini NativeGemini Native API
Generación de imágenesGeneración de imágenes
Trabajos asíncronos y sondeoTrabajos asíncronos y sondeo

En esta página