Skip to main content
POST

Modelos compatibles

Autorizaciones

string
requerido
Todas las solicitudes a la API requieren autenticación con Bearer TokenObtenga su API Key:Visite la página de gestión de API Keys para obtener su API KeyAñada lo siguiente a los encabezados de la solicitud:

Body

string
requerido
Nombre del modelo
  • gpt-image-1-official - Estabilidad prioritaria, adecuado para generación de imágenes en general
  • gpt-image-1.5-official - Versión nueva, adecuada para mayor calidad y edición compleja
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 chino e inglés
string
predeterminado:"1:1"
Proporción de la imagenProporciones compatibles:
  • 1:1 - Cuadrada (predeterminado)
  • 3:2 - Horizontal
  • 2:3 - Vertical
integer
predeterminado:"1"
Número de imágenes a generarRango: 1-4
  • Los valores ≤ 0 se tratarán como 1
  • Los valores > 4 se tratarán como 4
Advertencia: Debe ser un número puro (p. ej. 1), no añada comillas o se producirá un error
string
predeterminado:"auto"
Calidad de la imagen
  • auto - Selección automática de la calidad (predeterminado)
  • low - Más rápido y económico
  • medium - Equilibrio entre calidad y coste
  • high - Mayor calidad, mayor coste
string
predeterminado:"auto"
Modo de fondo
  • auto - Fondo automático (predeterminado)
  • opaque - Fondo opaco
  • transparent - Fondo transparente, recomendado junto con el formato de salida png
background: transparent no puede usarse simultáneamente con output_format: jpeg
string
predeterminado:"auto"
Nivel de moderación
  • auto - Nivel de moderación predeterminado
  • low - Moderación más permisiva
string
predeterminado:"png"
Formato de salida
  • png - Formato predeterminado, adecuado para fondos transparentes
  • jpeg - Tamaño de archivo menor, adecuado para salida de imágenes en general
background: transparent no puede usarse simultáneamente con output_format: jpeg
integer
Nivel de compresión de salida, rango 0-100
  • Recomendado solo para jpeg
  • No recomendado para png
array
Array de URLs de imágenes de referencia; activa el modo imagen a imagen cuando se proporcionaLímite: Hasta 15 imágenes de referencia
string
URL de la imagen de máscara para inpainting
  • Debe usarse junto con image_urls
  • Se enviará a través de la API oficial de edición
  1. Antes de cargar la imagen de máscara, confirme que el canal Alpha de la imagen sea “Sí”.
  2. El tamaño de la imagen de máscara debe coincidir con el de la primera imagen de referencia.

Referencia de tamaños

Las proporciones se utilizan externamente; el sistema las mapea automáticamente a las dimensiones oficiales internamente.

Ejemplos de uso

Texto a imagen (mínimo)
Texto a imagen (parámetros completos)
Imagen a imagen (referencia única)
Imagen a imagen (fusión multireferencia)
Múltiples imágenes (n > 1)

Response

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

Notas

  1. Procesamiento asíncrono: Tras el envío se devuelve un task_id. Haga polling en /v1/tasks/{task_id} para obtener los resultados
  2. Selección de modelo: Use gpt-image-1-official para generación de imágenes general; use gpt-image-1.5-official para edición de alta calidad y tareas complejas de imagen a imagen
  3. Requisitos de la URL de la imagen: Para imagen a imagen, use URLs de imagen estables y accesibles públicamente
  4. Facturación: Se cobra por cada imagen generada con éxito; sin cargo en caso de fallo