Skip to main content
Para una integración nueva, usa Generación de imágenes con el protocolo unificado /ai/v1/images/generations. Las interfaces compatibles de esta página siguen disponibles. Consulta la API Schema del modelo, selecciona el endpoint por path y lee su request.schema sin depender del orden del array.

Inventario actual de modelos

Este inventario indica los modelos disponibles actualmente. No significa que todos acepten los mismos campos. Selecciona el endpoint por path en el Schema del modelo y lee su request.schema.

API

Interfaz de la API

URL de la solicitud

<model_path> es <provider/model_id>, por ejemplo, <openai/gpt-image-1.5>, <qianfan/qwen-image>.

Cabeceras de la solicitud

Parámetros de la solicitud

Parámetros generales

Parámetros para modelos de OpenAI

Parámetros para modelos Flux

Parámetros para modelos Qwen

Parámetros para modelos Doubao

El número real de imágenes que se pueden generar está influenciado no solo por max_images, sino también por el número de imágenes de referencia proporcionadas. El número de imágenes de referencia de entrada + el número final de imágenes generadas ≤ 15.

Ejemplos de uso

OpenAI

gpt-image-2

Este es un modelo de edición de imágenes de OpenAI. Usa el nombre completo gpt-image-2; image2 no es un ID de modelo válido. Cuando el endpoint devuelve b64_json, los siguientes ejemplos guardan el resultado como edited.png.

Google Imagen

Qwen

Doubao

Flux

  • flux-2-flex y flux-2-pro son endpoints asíncronos que requieren una solicitud de dos pasos. Esta serie es extremadamente rápida, casi instantánea.

Dibujo de un paso con FLUX

Dibujo asíncrono con Flux

Paso 1: Enviar la solicitud de dibujo Ejemplo de resultado de salida:
Paso 2: Obtener el enlace de la imagen generada
Get Image

Ideogram V3

  1. Las versiones inferiores a V3 (V_2, V_1, etc.) son interfaces antiguas y no son compatibles.
  2. Los enlaces devueltos requieren una red proxy para acceder.

Respuestas de error y códigos compatibles

Esta sección se aplica a las interfaces Legacy /v1/images/* de esta página. Las interfaces nuevas /ai/v1/images/* usan un contrato de errores independiente. Las dos familias tienen estructuras de respuesta y códigos diferentes. Una respuesta de error habitual de la interfaz Legacy de imágenes tiene esta forma. param es opcional y tid suele añadirse al final de message, no como un campo independiente:

Enviar comentarios sobre errores HTTP 5xx

Si la solicitud devuelve HTTP 5xx, envía comentarios e incluye el tid de message.
Además de estos códigos compatibles estables, la interfaz Legacy puede devolver otros code dinámicos y message depurados procedentes del proveedor de modelos o de la cadena de compatibilidad. El conjunto es abierto y los clientes no deben tratar los códigos no incluidos en la tabla como una enumeración estable. El tid incluido en message es el ID de seguimiento de la solicitud.
Última actualización: 2026-09-01