# ¿Qué cambia al migrar solicitudes de OpenRouter a otra API compatible con OpenAI? > Cambiar la URL base y la clave API es solo el primer paso al dejar OpenRouter. Los campos estándar suelen transferirse, pero los ID de modelos, encabezados y extensiones de enrutamiento de OpenRouter, fallbacks, streaming, contabilidad, entradas multimodales, errores y límites deben probarse mediante un adaptador. # ¿Qué cambia al migrar solicitudes de OpenRouter a otra API compatible con OpenAI? En un chat básico, la migración puede empezar con una nueva URL base, clave e ID de modelo. En producción hay más: rutas, encabezados, slugs, fallbacks, metadatos y selección de proveedor de OpenRouter requieren sustitutos, y streaming y herramientas necesitan pruebas de contrato. La compatibilidad con OpenAI es un dialecto de transporte, no una promesa de catálogos, extensiones, facturación u operación idénticos. ## Inventaríe el contrato real Busque en código, configuración y logs cada campo enviado a OpenRouter. Su configuración documentada usa `https://openrouter.ai/api/v1`, bearer auth y encabezados opcionales de atribución, además de posibles extensiones de ruta. Prepare este inventario: | Superficie | Suele ser portable | Requiere revisión | |---|---|---| | Chat | `messages`, temperature, límite de salida | Parámetros y valores predeterminados | | Modelos | Intención de aplicación | Slug específico | | Herramientas | Nombre y esquema JSON | Paralelismo, strict y streaming de argumentos | | Enrutamiento | Ninguno | Preferencias, fallbacks, transforms | | Encabezados | Autorización | Atribución y metadatos de OpenRouter | | Uso | Tokens | Coste, caché y consulta de solicitud | | Operación | Familias HTTP | Límites, reintentos, tiempos y errores | ## Introduzca primero un adaptador No disperse URL y slugs por el código. Encapsule diferencias y exponga alias de aplicación. ```python from openai import OpenAI def make_client(base_url: str, api_key: str) -> OpenAI: return OpenAI(base_url=base_url, api_key=api_key) MODEL_MAP = { "coding_default": { "openrouter": "provider/model-slug", "target": "target-model-id", } } ``` El adaptador también debe traducir campos, normalizar errores y emitir eventos comunes. ## Sustituya semántica de modelos y rutas Los ID no están estandarizados. Mapee cada alias al modelo objetivo y verifique contexto, herramientas, salida estructurada, modalidades y precio en el catálogo actual. OpenRouter puede expresar rutas y fallbacks de otra manera que el destino. Decida si recrearlos en su orquestador, usar el router del destino o retirarlos. Un cambio silencioso altera coste y calidad. ## Retire o traduzca extensiones de OpenRouter Revise encabezados y campos específicos. Los encabezados opcionales de atribución suelen eliminarse; preferencias, arrays de fallback, plugins, transforms y controles de metadatos necesitan mapeo explícito. Durante las pruebas rechace extensiones desconocidas. Ignorarlas silenciosamente oculta cambios de comportamiento. ## Pruebe herramientas y streaming por contrato Pruebe: * aceptación de nombre y JSON schema; * modos de tool choice y paralelismo; * eventos incrementales de argumentos; * motivos de finalización y rechazos; * argumentos inválidos y reintentos. Compare secuencias analizadas, no chunks crudos. Incluya cancelación, errores intermedios, uso final, deltas vacíos y reconexión. ## Reconstruya la contabilidad OpenRouter documenta metadatos con modelo, proveedor, tokens y coste total. El destino puede devolver uso en la respuesta, ofrecer otra consulta o exigir precios del cliente. Normalice en su libro mayor: ```json { "request_id": "internal_123", "provider_request_id": "external_456", "gateway": "target", "model": "resolved-model-id", "input_tokens": 1200, "output_tokens": 340, "cost_usd": 0.0123 } ``` Separe estimaciones y cargos conciliados. Revise los límites presupuestarios antes de mover agentes de producción. ## Verifique solicitudes multimodales Imagen, audio y vídeo dependen de modelo y endpoint. Dos gateways pueden diferir en partes de contenido, subida, URL, trabajos asíncronos y resultados. Cree fixtures para cada modalidad. Un chat de texto exitoso no demuestra compatibilidad multimedia. ## Pruebe el comportamiento operativo Mida encabezados de límite, códigos reintentables, timeouts, cola, región, idempotencia, logs y soporte. Use documentación actual del destino. Un despliegue práctico tiene cuatro puertas: 1. Repetir un conjunto dorado fuera de línea. 2. Ejecutar tráfico seguro en sombra. 3. Hacer canary con poco tráfico de bajo riesgo. 4. Expandir solo si errores, latencia, coste y aserciones cumplen umbrales. Mantenga rollback de un solo interruptor hasta probar carga representativa. ## Decida si consolidar compensa OpenRouter sigue siendo adecuado cuando su catálogo LLM y sus rutas encajan. Atlas Cloud puede interesar si una relación compatible con OpenAI para texto, imagen y vídeo simplifica la pila. Ninguna ventaja sustituye pruebas. Decida por requisitos medidos, no por el diff más pequeño. ## En resumen Cambie la configuración y audite cada supuesto no estándar de modelos, rutas, herramientas, streaming, uso y operaciones. Un adaptador con pruebas doradas mantiene la migración reversible y evita que una solicitud sintácticamente válida oculte una regresión semántica. ## FAQ ### ¿Puedo migrar de OpenRouter cambiando solo base_url y api_key? A veces para un chat simple, pero una integración de producción suele depender de slugs, opciones de ruta, encabezados, streaming, campos de uso o semántica de fallback que también deben cambiar. ### ¿Qué campos de OpenRouter son menos portables? Las preferencias de proveedor, arrays de fallback, encabezados de atribución, transforms, plugins y metadatos específicos son puntos habituales. Manténgalos fuera del modelo de solicitud central. ### ¿Las API compatibles con OpenAI usan los mismos nombres de modelo? No. La compatibilidad suele cubrir la forma de la solicitud, no la identidad del catálogo. Cree un mapa explícito entre alias de aplicación e ID actuales de cada puerta de enlace. ### ¿Cómo se prueba el streaming tras la migración? Registre secuencias de eventos para deltas de texto, argumentos de herramientas, motivos de finalización, uso, cancelación y errores. Compare eventos analizados, no bloques de bytes. ### ¿Cuál es el despliegue de migración más seguro? Use un adaptador, reproduzca un conjunto dorado, ejecute una pequeña muestra en sombra y luego un canary de bajo riesgo con umbrales de reversión para errores, latencia, coste y aserciones. ### ¿Cuándo debería un equipo permanecer en OpenRouter? Cuando su catálogo LLM, controles de enrutamiento y herramientas operativas aporten más valor que la consolidación en otro lugar. La migración debe responder a requisitos medidos, no solo a declaraciones de compatibilidad.