API de GPT Image 2 a través de Flatkey: precios, modelos y comprobaciones de solicitudes

Acceso a GPT Image 2 API a través de Flatkey debe comenzar con una verificación de la fila del modelo, no con un bloque de código copiado. OpenAI documenta gpt-image-2 como un modelo actual de generación de imágenes, y el resumen de precios de Flatkey del 17 de junio de 2026 enumera filas de la familia GPT image. La pregunta útil para un equipo de producción es más concreta: qué fila llamará tu app, qué forma de endpoint expone esa fila, qué unidad de precios debe revisar finanzas y qué comprobaciones de solicitud deben pasar antes de que el tráfico avance a través del router?

Esta guía recorre esas comprobaciones para equipos que quieren una sola clave de Flatkey, la URL base compatible con OpenAI https://router.flatkey.ai/v1, registros de uso y revisión de precios en un solo lugar. Trata cada ejemplo de código a continuación como una plantilla. El artículo utiliza documentación oficial de OpenAI, una captura de catálogo de Flatkey fechada y comprobaciones de CMS/ruta pública, pero no afirma que se haya ejecutado una prueba de inferencia en vivo de GPT Image 2 API en Flatkey.

Respuesta rápida: Qué verificar antes de usar la API GPT Image 2 a través de Flatkey

Si está evaluando la API GPT Image 2 a través de Flatkey, verifique estos elementos en este orden:

1. Abra los precios de Flatkey y busque la fila exacta del modelo, como gpt-image-2 o openai/gpt-image-2.
2. Confirme el tipo de endpoint compatible para esa fila. En la instantánea del 17 de junio de 2026, las filas principales de gpt-image-2 exponían openai, mientras que las filas más antiguas de GPT image también exponían image-generation.
3. Compruebe el estado de disponibilidad. Las filas de GPT Image 2 en la instantánea mostraban unknown_failure, por lo que el uso en producción necesita una verificación actual del panel y una pequeña prueba de humo.
4. Compare las unidades de precios antes del lanzamiento. Flatkey mostró campos de estilo relación de tokens para una fila y un campo model_price con aspecto de precio por solicitud para otra fila, así que no asuma una única unidad en cada ruta de la API GPT Image 2.
5. Adapte el cuerpo de su solicitud a la ruta confirmada: estilo Images API, estilo Responses API o un wrapper compatible con OpenAI admitido por Flatkey.
6. Registre el ID del modelo, la ruta del endpoint, la calidad, el tamaño de salida, el formato de salida, el recuento de imágenes de entrada, el recuento de reintentos, el uso y el coste final por activo aceptado.

Esa secuencia importa porque la API GPT Image 2 no es solo un nombre de modelo. Es una combinación de ID del modelo, endpoint, parámetros de solicitud, permiso de la cuenta, estado de enrutamiento y unidad de facturación.

Qué documenta OpenAI para GPT Image 2 API

La guía de imágenes de OpenAI dice que los modelos GPT Image pueden usar entradas de texto e imagen para crear imágenes nuevas o editar las existentes, y describe gpt-image-2 como un modelo de generación de imágenes de última generación con gran capacidad de seguir instrucciones y de comprensión contextual. La guía también dice que los equipos pueden generar o editar imágenes con la Images API o la Responses API.

Para la ruta de Images API, la referencia de create-image documenta POST /images/generations. Incluye parámetros importantes para las comprobaciones de solicitudes en producción: prompt, background, moderation, output_format, quality, size, stream y n. También indica que los modelos de imagen GPT devuelven imágenes codificadas en base64 en lugar de URL temporales de imágenes.

Comprobación de OpenAI	Por qué importa para Flatkey	Acción en producción
model	El ID del modelo directo de OpenAI puede no ser la misma cadena que una fila del catálogo enrutado.	Anota la fila exacta de Flatkey y la cadena del modelo en tu solicitud.
POST /images/generations	Esta es la ruta oficial de generación de Images API, pero el soporte de endpoints de Flatkey depende de la fila.	Usa esta ruta a través de Flatkey solo después de que el panel muestre soporte de Images API para la fila seleccionada.
background y output_format	La salida transparente requiere un formato compatible como PNG o WebP.	Valida el formato de salida antes de crear flujos de trabajo de diseño que dependan de alpha.
quality y size	Son palancas importantes de coste y latencia para cargas de trabajo de GPT Image 2 API.	Separa en la lógica del producto los ajustes de borrador, vista previa y render final.
Manejo de respuestas base64	Los modelos de imagen GPT devuelven bytes de imagen, no URL alojadas de larga duración.	Guarda la imagen tú mismo, adjunta metadatos y evita depender de una URL del proveedor.

Instantánea del catálogo de Flatkey para GPT Image 2

El 17 de junio de 2026, la API pública de precios de Flatkey devolvió la versión de precios a42d372ccf0b5dd13ecf71203521f9d2 y 638 filas de modelos. El resumen de la familia de imágenes GPT incluyó gpt-image-2, openai/gpt-image-2, gpt-image-2-all, gpt-image-1.5, gpt-image-1-mini y gpt-image-1.

Fila de Flatkey	Grupos	Tipos de endpoint en la instantánea	Campos de precios vistos	Estado en la instantánea	Cómo usar esta evidencia
gpt-image-2	Economy, Standard	openai	model_ratio: 3.325, completion_ratio: 6, cache_ratio: 0.251127819549	unknown_failure	Úsalo solo como prueba del catálogo con fecha; verifica el estado actual de la fila antes del tráfico de producción de la API de GPT Image 2.
openai/gpt-image-2	Standard	openai	quota_type: 1, model_price: 0.063	unknown_failure	No copies el número sin confirmar la unidad actual y la etiqueta del panel.
gpt-image-2-all	Standard	openai	model_ratio: 37.5, completion_ratio: 2	unknown_failure	Comprueba si se trata de un paquete, alias o fila de enrutamiento interno antes de usarlo en código.
gpt-image-1.5 and gpt-image-1-mini	Standard	image-generation, openai	Campos de precios de tipo ratio	unknown_failure	Filas útiles de comparación, pero no sustituyen a la fila seleccionada de la API de GPT Image 2.

La página pública de precios también expone familias de endpoints como image-generation con la ruta /v1/images/generations, openai con la ruta /v1/chat/completions y openai-response con la ruta /v1/responses. El detalle importante es que las familias de endpoints existen a nivel de plataforma, mientras que la compatibilidad sigue siendo específica de cada fila. Para la API de GPT Image 2, confirma la fila antes de escribir la solicitud.

Solicitar verificaciones para GPT Image 2 API

Use esta lista de verificación antes de cualquier despliegue enrutado de GPT Image 2 API. Es deliberadamente operativa porque los errores de precios suelen venir de la forma de la solicitud, no de malinterpretar una sola tarifa destacada.

Verificación	Condición de aprobación	Modo de fallo	Dónde verificar
Fila del modelo	La fila del panel de Flatkey coincide con la cadena del modelo en el código.	La app llama por accidente a una fila heredada, de alias o de paquete.	Precios y catálogo de modelos de Flatkey.
Ruta del endpoint	La ruta coincide con el tipo de endpoint compatible de la fila.	El cuerpo de la API de imágenes se envía a una fila compatible con chat, o viceversa.	Compatibilidad de la fila de Flatkey y referencia de la API de OpenAI.
Disponibilidad	El estado del panel está limpio y una solicitud pequeña tiene éxito.	La fila del catálogo existe, pero falla el acceso upstream o de la cuenta.	Panel de Flatkey, estado de la respuesta y registros.
Unidad de precios	Finanzas sabe si la fila usa proporción de tokens, precio por solicitud u otra unidad.	El presupuesto usa suposiciones por token para una fila con precio por solicitud.	Precios de Flatkey y panel de uso.
Entradas de prompt e imagen	La longitud del prompt, las referencias de imagen, las máscaras y los reintentos se registran.	Las imágenes de entrada y los reintentos generan costes ocultos.	Telemetría de la aplicación y campos de uso del proveedor.
Ajustes de salida	La calidad, el tamaño, el fondo, el formato y la compresión están controlados.	Cada vista previa se genera como un activo final.	Cuerpo de la solicitud y valores predeterminados del producto.

Plantilla: solicitud directa a la API de imágenes de OpenAI

La plantilla del proveedor directo es útil como línea base al comparar el comportamiento de la ruta de Flatkey. Confirma el acceso actual a la cuenta de OpenAI y la disponibilidad del modelo antes de ejecutarla.

# Template only: direct OpenAI Images API baseline
curl https://api.openai.com/v1/images/generations \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Create a clean product concept image for a usage dashboard.",
    "size": "1536x1024",
    "quality": "medium",
    "output_format": "png"
  }'

Para una prueba básica de GPT Image 2 API, mantén el primer prompt simple, evita imágenes de referencia, usa una sola salida y registra el estado de la respuesta, la latencia, el tamaño de la salida y cualquier campo de uso devuelto por el endpoint.

Plantilla: comprobación de ruta de Flatkey

El posicionamiento público de Flatkey se centra en una clave y una URL base compatible con OpenAI. Para rutas de texto, la página de inicio pública muestra https://router.flatkey.ai/v1/chat/completions. Para el enrutamiento de la API GPT Image 2, no asumas que la ruta de imágenes está habilitada para la fila seleccionada. Primero comprueba si la fila expone image-generation, openai, openai-response u otra ruta en tu panel.

# Solo plantilla: usa esta estructura solo si tu fila de Flatkey confirma compatibilidad con image-generation
curl https://router.flatkey.ai/v1/images/generations \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "Create a clean product concept image for a usage dashboard.",
    "size": "1536x1024",
    "quality": "medium",
    "output_format": "png"
  }'

// Solo plantilla: centraliza la URL base y luego inyecta la ruta confirmada.
const FLATKEY_BASE_URL = "https://router.flatkey.ai/v1";

async function createImageThroughConfirmedRoute({ path, apiKey, body }) {
  const response = await fetch(`${FLATKEY_BASE_URL}${path}`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${apiKey}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify(body)
  });

  if (!response.ok) {
    throw new Error(`La comprobación de ruta de Flatkey falló: ${response.status}`);
  }

  return response.json();
}

// Ejemplo solo después de la confirmación en el panel:
await createImageThroughConfirmedRoute({
  path: "/images/generations",
  apiKey: process.env.FLATKEY_API_KEY,
  body: {
    model: "gpt-image-2",
    prompt: "Create a clean product concept image for a usage dashboard.",
    size: "1536x1024",
    quality: "medium",
    output_format: "png"
  }
});

Si la fila actual de Flatkey sigue exponiendo solo openai, pregunta al equipo de producto o soporte qué formato de solicitud es compatible para esa fila de la API GPT Image 2 antes de ponerla en producción. Se requieren tanto una fila de catálogo como una ruta de endpoint; una sin la otra no es una integración de producción.

Comprobaciones de precios para ejecutar en Flatkey

Para este artículo, la guía de precios más segura es procedimental: verifica la fila actual en precios de Flatkey, compárala con la página actual de precios de imágenes de OpenAI y luego confirma el uso real enroutado en los registros. La instantánea de Flatkey del 17 de junio demuestra que el catálogo tenía filas de imágenes de GPT, pero los campos de esas filas usaban representaciones de precios diferentes. Eso es suficiente para construir un flujo de trabajo de revisión de precios, pero no para publicar una afirmación permanente sobre el precio.

Pregunta sobre precios	Qué registrar	Por qué importa
¿Qué fila está seleccionada?	Nombre exacto del modelo, grupo, tipo de cuota y tipo de endpoint.	Pueden aparecer varias filas de la familia de imágenes de GPT en el mismo catálogo.
¿Qué unidad se muestra?	Proporción de tokens, precio por solicitud, unidad por salida o etiqueta específica del panel.	Mezclar unidades causa errores de presupuesto incluso cuando el nombre del modelo es correcto.
¿Qué ajustes cambian el coste?	Calidad, tamaño, longitud del prompt, entradas de imagen, formato de salida, reintentos y comportamiento por lotes.	La misma función de API de GPT Image 2 puede tener niveles de coste de vista previa y de renderizado final.
¿Qué registra Flatkey?	Recuento de solicitudes, estado, uso, coste, fila del modelo y motivo del fallo.	Los registros demuestran si el uso enroutado coincide con la estimación.

Los equipos que comparan presupuestos de imágenes también deberían leer Precios de la API de imágenes de OpenAI y Comparación de precios de modelos de IA. Esos contenidos cubren mecanismos más amplios de coste de tokens, imágenes y vídeo; esta página se centra en las comprobaciones de ruta específicas de Flatkey de la API de GPT Image 2.

Plan de prueba de humo antes del tráfico de producción

Ejecute una pequeña secuencia de validación después de que se confirmen la fila del panel, el endpoint y la unidad de precios:

1. Envíe una solicitud base directa a OpenAI si su equipo tiene acceso directo a OpenAI.
2. Envíe una solicitud a Flatkey a través del endpoint y la fila de modelo confirmados.
3. Compare la forma de la respuesta, el formato de salida, los bytes de salida, los mensajes de error y la latencia.
4. Revise los registros de uso de Flatkey para la fila del modelo, el recuento de solicitudes, el uso y el costo.
5. Repita con la configuración exacta de producción: calidad, tamaño, fondo, formato de salida y cualquier imagen de entrada.
6. Establezca límites de reintento y condiciones de detención antes de exponer la función a los usuarios.
7. Mantenga una ruta de reversión al flujo de trabajo de imágenes anterior o a la ruta directa del proveedor.

Esta es la misma disciplina operativa descrita en la guía migración de API compatible con OpenAI: cambie la ruta de forma deliberada, asigne el ID del modelo, ejecute una pequeña prueba de humo y use los registros antes de escalar.

Cuándo Flatkey es la ruta correcta de la API GPT Image 2

Flatkey encaja bien cuando tu función de imágenes forma parte de una pila multimodal más amplia. Un producto puede usar modelos de texto para reescritura de prompts, modelos GPT de imagen para la creación de activos, modelos con capacidad de visión para revisión y otros proveedores para fallback o control de costes. Una sola clave, una sola superficie de precios y un único panel de uso facilitan auditar ese flujo de trabajo frente a cuentas de proveedores separadas.

Flatkey no es una razón para omitir las comprobaciones a nivel de proveedor. Para la API GPT Image 2, el estado de la fila, la compatibilidad del endpoint y el cuerpo de la solicitud deben coincidir antes del tráfico de producción. La instantánea del 17 de junio mostraba presencia en el catálogo, no un resultado claro de disponibilidad.

Lista de verificación final de la API de GPT Image 2

• Fila del modelo principal seleccionada en los precios de Flatkey.
• Compatibilidad del endpoint confirmada para la fila seleccionada.
• Unidad de precios y etiqueta actual del panel revisadas.
• Prueba de pequeña ruta de Flatkey completada con la forma de solicitud de producción.
• Registros de uso revisados para la fila, el estado, los tokens o unidades de solicitud, y el costo.
• Límites de reintentos, límites de cuota y barreras de control de despliegue configurados.
• Ruta de reversión documentada.

La forma más segura de adoptar la API de GPT Image 2 a través de Flatkey es tratar el acceso al modelo, la compatibilidad del endpoint y los precios como un único ciclo de validación. Ver precios para comprobar las filas actuales de Flatkey GPT image antes de mover tráfico real de imágenes.