Skip to main content
POST
Aviso de compatibilidad de nombres de modelo: Esta interfaz también admite el alias gpt-image-2-ext, equivalente a gpt-image-2; ambos son intercambiables y producen los mismos resultados.

Autorizaciones

string
requerido
Todos los endpoints requieren autenticación con Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyInclúyala en el encabezado de la solicitud:

Body

string
predeterminado:"gpt-image-2"
requerido
Nombre del modelo de generación de imágenesFijo en gpt-image-2 (alias compatible gpt-image-2-ext)
Para mantener la compatibilidad con llamadas anteriores, el alias gpt-image-2-ext (corresponde a gpt-image-2) sigue estando disponible.
boolean
predeterminado:"false"
Indica si se debe moderar el contenido antes de enviar la tarea de imagen.
  • true: revisar los prompts y las imágenes de entrada con omni-moderation-latest
  • false u omitido: no enviar una solicitud de moderación, sin coste ni latencia de moderación adicionales (predeterminado)
string
requerido
Descripción textual para la generación de la imagen
  • Admite inglés y chino, se recomiendan descripciones detalladas
  • Moderación de contenido / revisión de seguridad antes del envío — las violaciones se rechazan inmediatamente
integer
predeterminado:"1"
Número de imágenes a generarValor: 1
Debe ser un número puro (p. ej., 1), no lo envuelva en comillas
string
predeterminado:"1:1"
Proporción de la imagenProporciones admitidas, más auto para dejar que el servidor elija una proporción adecuada automáticamente:También pueden pasarse dimensiones en píxeles directamente, como 1881x836 / 887x1774.
Cuando size se establece en auto, la proporción predeterminada es 1:1.
string
predeterminado:"1k"
Nivel de resolución de salidaOpciones: 1k / 2k / 4kMapeo size × resolution → píxeles reales:
El 4K admite las 15 proporciones listadas arriba; también puede pasar las dimensiones en píxeles de la tabla directamente mediante size.
array
Array de imágenes de referencia (campo estándar de OpenAI). Cambia al modo imagen a imagen cuando se proporciona.
Otros campos estándar de OpenAI (response_format, style) no son compatibles y serán ignorados. Los resultados de las tareas solo devuelven url — descargue y convierta a base64 usted mismo si lo necesita.
boolean
predeterminado:"false"
Si recurrir al canal oficial como fallback
  • false: No usar (predeterminado)
  • true: Usar el canal oficial

Ejemplos de uso

Texto a imagen (solicitud mínima)
Texto a imagen (con proporción + 2K)
Texto a imagen (salida en 4K)
Texto a imagen (múltiples)
Imagen a imagen (referencia = URL)
Imagen a imagen (referencia = base64)
Imagen a imagen (fusión multireferencia, URL + base64 combinados)

Response

integer
Código de estado de la respuesta
array
Array de datos de la respuesta

Consulta de resultados de la tarea

Tras un envío correcto, se devuelve un task_id. Consulte el estado de la tarea mediante GET /v1/tasks/{task_id}, consulte la API de consulta de tareas para más detalles.

Ejemplo de respuesta exitosa

Acceso a la imagen: data.result.images[0].url[0]

Estado de la tarea