Generación de imágenes con GPT-Image-2

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-2",
    "prompt": "A ginger cat sitting on a windowsill watching the sunset, watercolor style",
    "n": 1,
    "size": "16:9",
    "resolution": "2k"
  }'

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

​

Autorizaciones

Authorization: Bearer YOUR_API_KEY

​

Body

​

Ejemplos de uso

{
  "model": "gpt-image-2",
  "prompt": "A ginger cat sitting on a windowsill watching the sunset, watercolor style"
}

{
  "model": "gpt-image-2",
  "prompt": "a corgi astronaut on the moon, cinematic, 8k",
  "size": "16:9",
  "resolution": "2k"
}

{
  "model": "gpt-image-2",
  "prompt": "An ancient castle under a starry sky",
  "size": "16:9",
  "resolution": "4k"
}

{
  "model": "gpt-image-2",
  "prompt": "Turn this photo into a watercolor painting",
  "image_urls": [
    "https://example.com/photo.jpg"
  ]
}

{
  "model": "gpt-image-2",
  "prompt": "Turn this photo into a watercolor painting",
  "image_urls": [
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ]
}

{
  "model": "gpt-image-2",
  "prompt": "Fuse these two photos into a single poster",
  "size": "4:3",
  "resolution": "2k",
  "image_urls": [
    "https://example.com/photo-a.jpg",
    "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA..."
  ]
}

​

Response

​

Consulta de resultados de la tarea

​

Ejemplo de respuesta exitosa

{
  "code": 200,
  "data": {
    "id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA",
    "status": "completed",
    "progress": 100,
    "created": 1776748674,
    "completed": 1776748726,
    "actual_time": 52,
    "cost": 0.05279,
    "estimated_time": 100,
    "result": {
      "images": [
        {
          "url": [
            "https://upload.apimart.ai/f/image/xxxxxxxx-gpt_image_2_task_xxx_0.png"
          ],
          "expires_at": 1776835126
        }
      ]
    }
  }
}

​

Estado de la tarea

​

Recomendaciones de polling

• Retraso de la consulta inicial: Espere de 10 a 20 segundos tras el envío antes de la primera consulta
• Intervalo de consulta: Se recomiendan de 3 a 5 segundos, evite polling a nivel de milisegundos
• Referencia de timeout: Una sola imagen suele completarse en 3060 segundos (actual_time observado de 4453s)
• Consulta por lotes: Para consultar varias tareas a la vez, use POST /v1/tasks/batch con el cuerpo {"task_ids": ["task_xxx", "task_yyy"]}

​

Notas

1. Procesamiento asíncrono: El envío devuelve un task_id, haga polling en /v1/tasks/{task_id} para obtener la URL final de la imagen
2. Moderación de contenido: El prompt se revisa primero — las violaciones se rechazan sin cargo
3. URL del resultado: La plataforma replica los enlaces firmados temporales del upstream en su propio almacenamiento de objetos R2, devolviendo un enlace estable al que los clientes pueden acceder directamente
4. Validez de la URL: expires_at = completed + 24h en la respuesta es un campo orientativo; descargue o replique en su propio CDN cuanto antes
5. Conflicto de proporción: Use el campo size para la proporción — evite repetirla en el prompt para evitar ambigüedad en el upstream
6. Facturación: Facturado por nivel de resolución (1K / 2K / 4K), sin cargo en caso de fallo o rechazo por moderación
7. Proporciones admitidas en 4K: Las 15 proporciones anteriores admiten 4K; también puede pasar las dimensiones en píxeles correspondientes directamente mediante size
8. Retención de tareas: El task_id se conserva en la base de datos por defecto durante varios días (configurado por TASK_RETENTION_DAYS) — las consultas expiradas devuelven “la tarea no existe o ha expirado”