Guías de Migración

TokenLab es multi-formato: puede mantener clientes compatibles con OpenAI, llamadas nativas de Messages de Anthropic, llamadas REST nativas de Gemini y puntos finales de medios en sus formas naturales. La migración más segura no es traducir cada carga de trabajo a un formato universal. Elija la ruta que posea el comportamiento que su aplicación necesita.

Mapeo de Rutas

Carga de trabajo existente	URL base de TokenLab	Punto final principal	Nota de migración
Completaciones de Chat de OpenAI	`https://api.tokenlab.sh/v1`	`/chat/completions`	Cambio más pequeño para chat y llamadas a funciones compatibles con OpenAI
Respuestas de OpenAI	`https://api.tokenlab.sh/v1`	`/responses`	Utilice cuando su aplicación dependa de entradas, herramientas o manejo de salidas específicas de Respuestas
SDK de Anthropic	`https://api.tokenlab.sh`	`/v1/messages`	No añada `/v1` a la URL base del SDK
REST de Gemini	`https://api.tokenlab.sh`	`/v1beta/models/:model:generateContent`	Mantenga los campos nativos de Gemini en la ruta de Gemini
Generación de medios	`https://api.tokenlab.sh/v1`	`/images`, `/videos`, `/music`, `/3d`	Descubra modelos con `recommended_for` y espere sondeos asíncronos donde esté documentado
Gestión y facturación	`https://api.tokenlab.sh/v1`	`/management/...`	Utilice tokens de gestión para uso del lado del servidor y conciliación de facturación

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

Mantenga su código existente de reintentos, tiempo de espera y transmisión, pero valide los IDs de modelo con GET /v1/models antes del tráfico de producción. Para la generación de imágenes, envíe model explícitamente y lea la guía de imágenes porque los modelos de imagen difieren más que los modelos de chat.

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

Utilice /v1/messages para el uso de herramientas nativas de Claude, flujos de pensamiento y semántica de mensajes de Anthropic. No traduzca campos exclusivos de Anthropic a través de Completaciones de Chat a menos que intencionalmente desee un cambio de comportamiento compatible con OpenAI.

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

Mantenga las herramientas integradas de Gemini, referencias de la API de archivos, contenidos en caché, declaraciones de funciones y partes de contenido nativas en /v1beta cuando su aplicación dependa del comportamiento nativo de Gemini.

Migración de Medios

Consulte GET /v1/models?recommended_for=image|video|music|3d.
Lea tokenlab.public_contract_summary en las respuestas de lista y el tokenlab.public_contract completo donde esté disponible.
Envíe un model explícito, especialmente para puntos finales de imágenes.
Almacene task_id, poll_url, punto final, modelo y su propio ID de trabajo para trabajos asíncronos.
Concilie costos a través de registros de uso y billing_transaction_id, no IDs de tareas del proveedor.

Las cargas de trabajo de medios necesitan su propio plan de implementación porque la latencia, los reintentos y los activos finales se comportan de manera diferente a las completaciones de chat.

Plan de Implementación en Producción

Fase	Objetivo	Comprobaciones
1. Inventario	Listar puntos finales, modelos, campos de solicitud, comportamiento de transmisión/asíncrono y propietario de facturación	No se asumen campos ocultos solo para proveedores como públicos
2. Piloto de ruta única	Mover un punto final y una familia de modelos	La forma de respuesta, el costo y los registros coinciden con las expectativas
3. Sombra o muestra	Comparar salidas seleccionadas con el proveedor anterior	La calidad y latencia visibles para el usuario son aceptables
4. Implementación gradual	Aumentar el tráfico por clave, organización o bandera de función	Vigilar `4xx`, `5xx`, latencia, balance y trabajos asíncronos duplicados
5. Limpieza	Eliminar la ruta del proveedor antiguo solo después de un uso estable	La ruta de reversión y el libro de soporte están documentados

Errores Comunes en la Migración

No ponga cada modelo detrás de una única ruta de Completaciones de Chat de OpenAI si su aplicación necesita comportamiento nativo de Anthropic, Gemini o Respuestas.
No asuma los valores predeterminados antiguos de imagen. Envíe model explícitamente.
No reintente solicitudes de creación asíncronas sin verificar si ya se creó una tarea.
No exponga metadatos de enrutamiento del proveedor en sus registros o UI.
No compare la facturación con IDs de tareas del proveedor. Utilice registros de uso de TokenLab.

Referencia de API

Tema	Referencia
API Multi-Formato	API Multi-Formato
SDK de OpenAI	SDK de OpenAI
SDK de Anthropic	SDK de Anthropic
Nativo de Gemini	API Nativa de Gemini
Generación de Imágenes	Generación de Imágenes
Trabajos Asíncronos y Sondeos	Trabajos Asíncronos y Sondeos

​Mapeo de Rutas

​Migración Compatible con OpenAI

​Migración de Anthropic

​Migración de Gemini

​Migración de Medios

​Plan de Implementación en Producción

​Errores Comunes en la Migración

​Referencia de API