Saltar al contenido principal
POST
/
v1
/
images
/
generations
curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.apimart.ai/llms.txt

Use this file to discover all available pages before exploring further.

curl --request POST \
  --url https://api.apimart.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-1-official",
    "prompt": "An ancient castle under a starry sky",
    "size": "1:1",
    "quality": "auto",
    "n": 1
  }'

{
  "code": 200,
  "data": [
    {
      "status": "submitted",
      "task_id": "task_01KXXXXXXXXXXXXXXX"
    }
  ]
}

​
Modelos compatibles

ModeloDescripciónModosImagen a imagenImágenes máx.Facturación
gpt-image-1-officialEstabilidad prioritaria, adecuado para generación de imágenes en generalTexto a imagen / Imagen a imagenCompatible4Size x Quality
gpt-image-1.5-officialVersión nueva, adecuada para mayor calidad y edición complejaTexto a imagen / Imagen a imagenCompatible4Size x Quality

​
Autorizaciones

​
Authorization
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:
Authorization: Bearer YOUR_API_KEY

​
Body

​
model
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
​
prompt
string
requerido
Descripción textual para la generación de la imagen, admite chino e inglés
​
size
string
predeterminado:"1:1"
Proporción de la imagenProporciones compatibles:
  • 1:1 - Cuadrada (predeterminado)
  • 3:2 - Horizontal
  • 2:3 - Vertical
​
n
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
​
quality
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
​
background
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
​
moderation
string
predeterminado:"auto"
Nivel de moderación
  • auto - Nivel de moderación predeterminado
  • low - Moderación más permisiva
​
output_format
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
​
output_compression
integer
Nivel de compresión de salida, rango 0-100
  • Recomendado solo para jpeg
  • No recomendado para png
​
image_urls
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
​
mask_url
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.
ProporciónTamaño realDescripción
1:11024x1024Cuadrada
2:31024x1536Vertical
3:21536x1024Horizontal

​
Ejemplos de uso

Texto a imagen (mínimo) 
{
  "model": "gpt-image-1-official",
  "prompt": "An ancient castle under a starry sky"
}
Texto a imagen (parámetros completos) 
{
  "model": "gpt-image-1-official",
  "prompt": "A flat icon of a glass bottle with no background",
  "size": "2:3",
  "quality": "high",
  "background": "transparent",
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Imagen a imagen (referencia única) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Convert the reference image to illustration style, preserving the main outline",
  "size": "1:1",
  "quality": "auto",
  "image_urls": [
    "https://your-cdn.com/input.png"
  ],
  "n": 1
}
Imagen a imagen (fusión multireferencia) 
{
  "model": "gpt-image-1.5-official",
  "prompt": "Merge two reference images into an illustration poster, preserving the main outlines",
  "size": "1:1",
  "quality": "auto",
  "background": "transparent",
  "image_urls": [
    "https://your-cdn.com/input-a.png",
    "https://your-cdn.com/input-b.png"
  ],
  "moderation": "low",
  "output_format": "png",
  "n": 1
}
Múltiples imágenes (n > 1) 
{
  "model": "gpt-image-1-official",
  "prompt": "Four minimalist poster variations of a red fox",
  "size": "1:1",
  "quality": "low",
  "output_format": "png",
  "n": 4
}

​
Response

​
code
integer
Código de estado de la respuesta
​
data
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