> ## 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.

# Guías de Migración

> Mueva OpenAI, Anthropic, Gemini y cargas de trabajo de medios a TokenLab con cambios pequeños y seguros para producció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

```python theme={null}
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

```python theme={null}
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

```bash theme={null}
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

1. Consulte `GET /v1/models?recommended_for=image|video|music|3d`.
2. Lea `tokenlab.public_contract_summary` en las respuestas de lista y el `tokenlab.public_contract` completo donde esté disponible.
3. Envíe un `model` explícito, especialmente para puntos finales de imágenes.
4. Almacene `task_id`, `poll_url`, punto final, modelo y su propio ID de trabajo para trabajos asíncronos.
5. 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](/es/guides/api-formats)                       |
| SDK de OpenAI                 | [SDK de OpenAI](/es/integrations/openai-sdk)                      |
| SDK de Anthropic              | [SDK de Anthropic](/es/integrations/anthropic-sdk)                |
| Nativo de Gemini              | [API Nativa de Gemini](/es/api-reference/gemini/generate-content) |
| Generación de Imágenes        | [Generación de Imágenes](/es/guides/image-generation)             |
| Trabajos Asíncronos y Sondeos | [Trabajos Asíncronos y Sondeos](/es/guides/async-jobs-polling)    |