Cloudflare AI Gateway y OpenRouter suelen presentarse como alternativas, aunque operan en capas distintas. Para llamar a GPT Image 2 desde un Cloudflare Worker, la decisión práctica no es qué producto gana, sino por qué ruta debe viajar cada tarea de generación.
OpenRouter agrega modelos y gestiona el enrutamiento de inferencia. Cloudflare AI Gateway es una capa de control que puede colocarse delante de un proveedor, incluido OpenRouter. Además, un Worker puede llamar a un modelo de terceros mediante AI binding y Unified Billing. Los tres productos pueden aparecer en una misma aplicación, pero no ocupan la misma capa.
En GPT Image 2, esa diferencia afecta al endpoint, las credenciales, la cuenta de facturación, el esquema de la solicitud, la respuesta, la privacidad y los límites de velocidad. También cambia cómo debe interpretarse que la solicitud se haya procesado en una colo de Hong Kong o Singapur.
La llamada directa a la Images API de OpenRouter es la referencia pública más clara para empezar. AI Gateway cobra sentido cuando los logs o las políticas de Cloudflare justifican otra capa, aunque antes hay que verificar el endpoint de imágenes. El AI binding cubre la ruta gestionada por Cloudflare para modelos de terceros. Un relay solo es necesario cuando una IP o un país de salida fijos son requisitos explícitos.
El punto de partida correcto es el recorrido de la solicitud:
Aplicación
-> Cloudflare Worker
-> OpenRouter Images API -> OpenAI
-> Cloudflare AI Gateway -> OpenRouter -> OpenAI
-> Cloudflare AI binding + AI Gateway -> OpenAI
-> relay con salida fija -> OpenRouter u otro proveedorCada ruta resuelve un problema distinto. Tratarlas como equivalentes puede convertir un cambio de proveedor aparentemente pequeño en tareas de generación fallidas.
Cloudflare AI Gateway y OpenRouter: ¿qué capa encaja con tu API de imágenes?
El Worker llama directamente a OpenRouter
Es el punto de partida más corto y mejor documentado para la Images API de OpenRouter. El Worker envía un token de OpenRouter y OpenRouter enruta la solicitud al proveedor disponible. En los metadatos revisados de GPT Image 2 aparece un solo proveedor: OpenAI.
En esta ruta, OpenRouter gestiona el contrato de la API, el uso, las reglas de enrutamiento y el saldo de créditos. Cloudflare sigue ejecutando el Worker, pero no es el intermediario de facturación de la inferencia.
Es una buena línea base para equipos que necesitan una API de generación de imágenes con varios modelos o que podrían cambiar de modelo más adelante. También hay menos capas adicionales que revisar cuando una solicitud falla.
AI Gateway delante de OpenRouter
Cloudflare documenta un adaptador de OpenRouter mediante una URL de AI Gateway. La solicitud sigue llevando un token de OpenRouter, y OpenRouter sigue controlando el enrutamiento del modelo y la facturación de la inferencia. AI Gateway añade logs, analítica, controles de velocidad, caché y otras funciones de gateway de Cloudflare.
La limitación importante aparece en la generación de imágenes. La actual
guía de integración de OpenRouter de Cloudflare
solo muestra chat/completions, no el endpoint dedicado de OpenRouter
/api/v1/images. La misma página contiene ejemplos de rutas de chat que no son
completamente consistentes. Por eso no basta para afirmar que la Images API sea
compatible de forma directa.
La arquitectura puede ser útil para sumar control y observabilidad de Cloudflare, pero antes de enviar tráfico de producción hay que probar el endpoint de imágenes con credenciales reales y una solicitud representativa. Un gateway solo aporta valor si conserva el contrato que necesita la aplicación.
AI binding de Cloudflare con Unified Billing
Esta ruta no pasa por OpenRouter. El Worker llama a env.AI.run() con el ID de
modelo de terceros de Cloudflare:
openai/gpt-image-2Cloudflare marca el modelo explícitamente como Third-party. No es un modelo
nativo de Workers AI con prefijo @cf/...; por tanto, la asignación gratuita de
Neuron y la tabla de precios de los modelos nativos no sirven para estimar GPT
Image 2.
Las llamadas de terceros mediante binding requieren AI Gateway. Cloudflare puede
gestionar las credenciales del proveedor y descontar créditos de Unified Billing.
La documentación actual indica que una clave BYOK guardada bajo el alias default
tiene prioridad. Otros alias se ignoran en esta ruta y la solicitud vuelve a Unified
Billing. Para usar otro alias hay que emplear un endpoint nativo del proveedor y
cf-aig-byok-alias.
Es una opción razonable si buscas credenciales gestionadas, facturación consolidada y controles de Cloudflare. Sigue siendo una migración de contrato, no un simple cambio de base URL.
Un relay con salida fija
Un relay de salida fija es un pequeño backend con una ubicación de red pública estable. El Worker llama al relay y el relay llama a OpenRouter u otro proveedor. Puede ser necesario si el proveedor exige una IP de origen, un país de origen o un comportamiento de red que el runtime edge no puede garantizar.
El relay no decide dónde ejecuta OpenAI la inferencia. Solo hace más predecible la ubicación de red del cliente que sale hacia el proveedor. A cambio, el equipo debe operar otro servicio: capacidad, secretos, timeouts, colas, monitorización, parches y disponibilidad regional.
Por eso un relay es una herramienta para un requisito de red concreto, no un componente predeterminado de cualquier arquitectura de IA.
| Ruta | Qué cambia | Facturación y credenciales | Adecuada para | No garantiza |
|---|---|---|---|---|
| Worker -> OpenRouter | Modelo y Images API de OpenRouter | Token y créditos de OpenRouter | Acceso directo al catálogo y routing | Egress o región de inferencia fijos |
| Worker -> AI Gateway -> OpenRouter | Capa de control de Cloudflare | Token y créditos de OpenRouter | Logs y políticas centralizados | Compatibilidad de Images API sin probar |
| Worker -> AI binding -> modelo de terceros | Binding y facturación de Cloudflare | Unified Billing o clave BYOK default válida | Credenciales gestionadas | Precios nativos de Workers AI o misma API |
| Worker -> relay -> proveedor | Salto de red propio | Credenciales del proveedor más coste del relay | IP o país de origen estable | Región interna de inferencia |
GPT Image 2 muestra por qué los contratos de API importan
Cloudflare y OpenRouter usan actualmente el mismo ID, openai/gpt-image-2, pero
eso no significa que sus interfaces sean intercambiables. Antes de migrar hay que
revisar los metadatos del endpoint y los parámetros del recorrido concreto.
Los metadatos públicos de GPT Image 2 en OpenRouter indican hasta 16 imágenes de
referencia, controles de calidad, varias relaciones de aspecto, n de 1 a 10,
compresión de salida y streaming. La Images API devuelve imágenes codificadas en
base64 y datos de uso. Estas capacidades pueden cambiar, así que conviene volver a
leer el endpoint record antes de una integración productiva.
El esquema de Cloudflare acepta un prompt y hasta 16 imágenes base64, además de
campos de calidad, tamaño, fondo y formato. La respuesta documentada contiene una
URI de imagen; no es el ReadableStream binario de algunos ejemplos nativos de
Workers AI.
La aplicación debería normalizar las respuestas en un formato interno común:
type GeneratedImage = {
bytes?: Uint8Array;
sourceUrl?: string;
mediaType: string;
providerRequestId?: string;
costUsd?: number;
};Codificación de referencias, streaming, múltiples salidas, transparencia, datos de uso y errores deben probarse por separado. El fondo transparente requiere especial prudencia: la página de producto de Cloudflare y su esquema raw no coinciden. Hasta que se aclare o una prueba de integración lo confirme, trátalo como no compatible.
Precios de OpenRouter y Unified Billing: la comisión no es el coste total
El endpoint público de GPT Image 2 de OpenRouter indica 8 USD por millón de tokens de imagen de entrada, 5 USD por millón de tokens de texto de entrada y 30 USD por millón de tokens de imagen de salida. OpenRouter afirma que traslada el precio de inferencia del proveedor sin recargo. Las recargas con Stripe tienen una comisión del 5,5 %, con un mínimo de 0,80 USD; las recargas con criptomonedas tienen una comisión del 5 %.
Cloudflare también afirma que traslada el precio del proveedor sin recargo. Unified Billing cobra un 5 % al comprar créditos. Sin embargo, la página pública de GPT Image 2 de Cloudflare remite al dashboard autenticado para el precio exacto del modelo. No es responsable inventar un coste público por imagen.
Tampoco se puede convertir el precio por token en un precio fijo por imagen. Las referencias, dimensiones, calidad y resultado afectan al consumo. Mide el coste medio de imágenes entregadas con éxito en un conjunto representativo y separa los fallos y reintentos.
Las solicitudes con credenciales gestionadas por Cloudflare tienen además un límite documentado de 200 solicitudes por 60 segundos y gateway. BYOK no está sujeto a ese límite específico de credenciales gestionadas. Es un límite de tasa, no una garantía de concurrencia ni de tiempo de finalización.
Privacidad de AI Gateway: ZDR no equivale a apagar los logs
“Zero Data Retention” no es un interruptor que cubra todos los saltos de la ruta.
Cloudflare marca GPT Image 2 como compatible con ZDR para tráfico de Unified
Billing elegible y con credenciales gestionadas por Cloudflare. Esta configuración
es independiente de los logs de AI Gateway. Los logs están activados por defecto y
pueden incluir payloads de request y response. cf-aig-collect-log: false desactiva
la entrada completa; cf-aig-collect-log-payload: false conserva metadatos sin los
payloads sin procesar.
OpenRouter dice que registra metadatos básicos, como marca temporal, modelo y conteos de tokens, pero no guarda prompts ni completions por defecto. El contenido se almacena solo si el cliente lo activa. La solicitud aún llega al proveedor upstream, así que sus políticas de retención y entrenamiento siguen siendo parte de la decisión.
En el registro oficial consultado el 25 de agosto de 2026, la política del
proveedor OpenAI en OpenRouter muestra training: false, pero mantiene una marca
de retención de prompts. Hay que volver a consultar esta política antes de publicar
si la fecha cambia.
Los prompts pueden incluir especificaciones de productos no publicados y las referencias pueden contener activos de marca. Una política útil identifica a cada procesador de datos, desactiva los payloads de gateway cuando no son necesarios y registra la política del proveedor aceptada. Activar ZDR no apaga los logs de Gateway.
Un Worker en Hong Kong no implica inferencia en Hong Kong
El enrutamiento edge de Cloudflare puede procesar una solicitud en una colo de Hong Kong. Eso indica dónde entró el Worker, no desde qué país salió la conexión al proveedor ni dónde ejecutó OpenAI la inferencia de la imagen.
Ninguno de los contratos revisados de GPT Image 2 ofrece un parámetro para fijar la región de inferencia. OpenRouter muestra actualmente un único endpoint de OpenAI; por tanto, el routing genérico no crea un proveedor de GPT Image 2 en Singapur. AI Gateway tampoco promete egress fijo de Singapur para solicitudes dirigidas a OpenRouter.
Para diagnosticar una región hay que registrar colo del Worker, ruta exacta, tiempo hasta headers o primer evento, duración completa, request ID del proveedor, estado HTTP, reintentos, referencias, calidad, tamaño y cantidad de salidas. Así se pueden comparar tasa de éxito y p50/p95 por región de usuario.
Si el proveedor exige país o IP de origen estable, un relay en ese país puede
cumplir el requisito de red. No fuerza la región interna de inferencia y no debería
introducirse solo porque un trace haya mostrado HKG.
Cómo elegir entre Cloudflare AI Gateway y OpenRouter según el fallo que quieres evitar
Para el acceso de GPT Image 2 más directo y públicamente descrito en OpenRouter, llama a la Images API directamente desde el Worker y úsalo como línea base.
Si lo principal son la observabilidad, las políticas o el control de gasto de Cloudflare, AI Gateway delante de OpenRouter es la capa adecuada. Para imágenes, la prueba del endpoint sigue siendo obligatoria; un ejemplo de chat no demuestra compatibilidad.
Si buscas credenciales gestionadas y una factura consolidada de Cloudflare, usa el
AI binding con el contrato de terceros openai/gpt-image-2. Presupuéstalo como un
modelo de terceros, no como inferencia nativa gratuita de Workers AI.
Si el requisito rígido es un país o una IP de origen estable, usa un relay y trátalo como un backend de producción. Necesitará límites de concurrencia, colas visibles, idempotencia, health checks y un plan de fallo regional.
Migrar tareas de imágenes sin cambiar todas las variables a la vez
Empieza por una capa propia sobre el proveedor: guarda entradas inmutables, asigna una clave de idempotencia y normaliza todas las respuestas. Así un timeout no se convierte accidentalmente en una segunda generación facturable.
Después ejecuta un pequeño canary con los mismos prompts, referencias, calidad y
cantidad de salidas que usas en producción. Comprueba los bytes de imagen o la URI,
no solo un HTTP 200; registra ID del proveedor, uso, log ID de Gateway, duración
total y categoría del fallo.
Mueve el tráfico de forma gradual y conserva la ruta anterior el tiempo suficiente para separar un error de contrato de un problema regional. Cambiar el modelo, el gateway, el parser, la política de reintentos y el relay en el mismo release deja muchos logs, pero poca evidencia útil.
Para comparar la calidad de salida de los modelos, consulta nuestro análisis de GPT Image 2 frente a Gemini para fotos de producto.
FAQ: Cloudflare AI Gateway y OpenRouter
¿Cloudflare AI Gateway sustituye a OpenRouter?
No por sí solo. OpenRouter ofrece acceso y routing de modelos; AI Gateway añade una capa de control de Cloudflare. Pueden combinarse, pero no son el mismo producto ni la misma ruta de facturación.
¿AI Gateway puede reenviar la Images API de OpenRouter?
La guía actual de Cloudflare documenta chat completions, no el endpoint dedicado
/api/v1/images. Hasta que una solicitud autenticada y cercana a producción tenga
éxito, el reenvío de imágenes debe considerarse no verificado.
¿Qué es más barato: OpenRouter o Unified Billing?
No se puede decidir solo por la comisión de recarga. OpenRouter publica los precios por token de GPT Image 2; el precio exacto de Cloudflare requiere el dashboard. Las referencias, el tamaño, los reintentos, los logs y el mantenimiento del relay también afectan al coste total. Compara el coste medio de imágenes exitosas con la misma prueba representativa.
¿Un Worker en Hong Kong garantiza inferencia en Hong Kong o Singapur?
No. La colo identifica la entrada en el edge, no la conexión al proveedor ni la región de inferencia. Usa un relay solo cuando el país o la IP de origen sean un requisito explícito.
La decisión final está en la ruta de producción
Cloudflare AI Gateway y OpenRouter resuelven tareas distintas. OpenRouter ofrece acceso y enrutamiento de modelos, AI Gateway aporta control desde Cloudflare y el AI binding ofrece la ruta gestionada para modelos de terceros. Un relay es infraestructura aparte para fijar la salida de red.
Prueba exactamente la ruta que piensas llevar a producción. Un diagrama no prueba la compatibilidad del endpoint, una colo no localiza la inferencia y una etiqueta ZDR no describe todos los logs de una arquitectura con varios saltos.
Fuentes oficiales
Los hechos y metadatos de API se comprobaron el 25 de agosto de 2026. Los precios, límites, políticas y el comportamiento del producto pueden cambiar.
- Cloudflare: guía de OpenRouter
- Cloudflare: bindings de AI Gateway
- Cloudflare: GPT Image 2
- Cloudflare: Unified Billing
- Cloudflare: logs de AI Gateway
- Cloudflare: límites de AI Gateway
- OpenRouter: guía de generación de imágenes
- OpenRouter: metadatos del endpoint de GPT Image 2
- OpenRouter: precios y comisiones
- OpenRouter: recopilación de datos
- OpenRouter: políticas de logs de proveedores
