Recursos para Desarrolladores

Documentación de la API de GPT Image 1.5

Integra el modelo GPT Image 1.5 de OpenAI en tus aplicaciones. Soporte para generación de texto a imagen e imagen a imagen con una API REST sencilla.

Autenticación

La API de GPT Image 1.5 utiliza autenticación mediante Bearer Token. Envía tu clave de API en el encabezado de la solicitud.

Autenticación

Authorization: Bearer sk-your-api-key-here

Mantén tu clave de API segura. No la compartas en código del lado del cliente.

Precios

Tipo	Costo	Descripción
Texto a Imagen	10 Créditos	Genera imágenes a partir de prompts de texto.
Imagen a Imagen	10 Créditos	Edita imágenes existentes mediante prompts de texto.

Crear Tarea

POSThttps://gptimage15.ai/api/generate

Generación Asíncrona

Precios

Cada solicitud de generación cuesta 10 Credits, independientemente de si es texto a imagen o imagen a imagen.

Inicia una tarea de generación. La API devuelve un task_id de inmediato, que puedes usar para consultar el resultado.

Parámetros del Cuerpo

Parámetro	Tipo	Requerido	Descripción
prompt	string	Requerido	La descripción de texto para la generación de la imagen. Máximo 2000 caracteres.
size	string	Opcional	Tamaño de la imagen: 10241024, 10241536, o 15361024. Por defecto: 10241024
quality	string	Opcional	Calidad de la imagen: low, medium, o high. Por defecto: medium
images	array	Opcional	Para el modo Imagen a Imagen. Matriz de URLs de imágenes para editar.
input_fidelity	string	Opcional	Fidelidad a la imagen de entrada: low o high. Por defecto: high. Solo para imagen a imagen.
callback_url	string	Opcional	URL de Webhook para notificaciones de finalización de tarea.

Ejemplos de Solicitud

Text-to-Image (cURL)

curl -X POST https://gptimage15.ai/api/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A serene mountain landscape...",
    "size": "1536*1024",
    "quality": "high"
  }'

Image-to-Image (Edit Mode)

{
  "prompt": "Add a rainbow in the sky",
  "images": [
    "https://example.com/landscape.jpg"
  ],
  "input_fidelity": "high",
  "quality": "medium"
}

Respuesta Exitosa

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS"
  }
}

Respuesta de Error

{
  "code": 400,
  "message": "Bad Request: 'prompt' is required.",
  "data": null
}

Consultar Estado

GEThttps://gptimage15.ai/api/status

Consulta este endpoint para verificar el progreso de tu tarea. Recomendamos consultar cada 5-10 segundos.

Parámetros de Consulta

Parámetro	Tipo	Descripción
task_id	string	El ID de tarea recibido desde el endpoint de generación. Requerido

Valores de Estado

PENDINGTarea en cola

IN_PROGRESSEn progreso

SUCCESSCompletada

FAILEDOcurrió un error

cURL

curl -X GET "https://gptimage15.ai/api/status?task_id=n36abc123def456gptimg" \
  -H "Authorization: Bearer YOUR_API_KEY"

Respuesta (En progreso)

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "IN_PROGRESS",
    "consumed_credits": 10,
    "created_at": "2024-12-19T10:00:00Z"
  }
}

Respuesta (Completada)

{
  "code": 200,
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "SUCCESS",
    "response": [
      "https://cdn.example.com/image.png"
    ]
  }
}

Respuesta (Fallida)

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n36abc123def456gptimg",
    "status": "FAILED",
    "consumed_credits": 0,
    "error_message": "Content policy violation detected",
    "created_at": "2024-12-19T10:00:00Z",
    "request": { ... },
    "response": null
  }
}

Códigos de Error

Código	Descripción
200	Éxito
400	Bad Request - Parámetros inválidos (falta el prompt, tamaño/calidad inválidos, etc.)
401	Unauthorized - Clave de API faltante o inválida
404	Not Found - El ID de tarea no existe
500	Internal Server Error - Por favor, reintenta o contacta al soporte

¿Necesitas ayuda?

Visita nuestro canal de soporte o envíanos un correo electrónico.

Contactar a Soporte