StarMagicStarMagic
Español
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
Guía de integración
GPT Image 1.5 Image Generation
StarMagicStarMagic
Español
简体中文简繁體中文繁EnglishEN日本語日EspañolES한국어KO
ImagenGPT ImageGPT-Image.1.5

Generación de imágenes GPT Image 1.5 Lite

  • El modelo GPT Image 1.5 (gpt-image-1.5) soporta modos de texto a imagen, imagen a imagen y edición de imagen
  • Modo de procesamiento asíncrono, usa el ID de tarea devuelto para consultar el estado
  • Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente

Autorización

AuthorizationstringheaderObligatorio

## Todas las APIs requieren autenticación Bearer Token ## **Obtener API Key:** Visita la [Página de gestión de API Key](https://starmagic.ai/app/api-keys) para obtener tu API Key **Agregar al encabezado de la solicitud:** ``` Authorization: Bearer YOUR_API_KEY ```

Authorization: Bearer YOUR_API_KEY

Cuerpo de solicitud

application/json
modelenum<gpt-image-1.5>Obligatorio

Nombre del modelo de generación de imágenes

"gpt-image-1.5"
promptstringObligatorio

Prompt que describe la imagen que desea generar, o que describe cómo editar la imagen de entrada. Limitado a 2000 tokens

"A beautiful colorful sunset over the ocean"
sizeenum<1:1 | 2:3 | 3:2 | 1024x1024 | 1024x1536 | 1536x1024>

Tamaño de la imagen generada, admite dos formatos: **Formato de relación de aspecto:** - `1:1`: Cuadrado - `2:3`: Vertical - `3:2`: Horizontal **Formato en píxeles:** - `1024x1024`: Cuadrado - `1024x1536`: Vertical - `1536x1024`: Horizontal

"1024x1024"
qualityenum<low | medium | high>

Calidad de la imagen generada **Niveles de calidad admitidos:** - `low`: Baja calidad, generación más rápida - `medium`: Calidad media - `high`: Alta calidad, generación más lenta (predeterminado)

"high"
image_urlsstring<uri>[]

Lista de URLs de imagen de referencia para funciones de imagen a imagen y edición de imagen **Nota:** - Una solicitud admite cantidad de imágenes de entrada: `14` imágenes - Tamaño de imagen: no más de `10MB` - Formatos de imagen admitidos: `.jpeg`, `.jpg`, `.png`, `.webp`, `.bmp`, `.tiff`, `.gif` - Rango de relación de aspecto (ancho/alto): `[1/16, 16]` - Ancho y alto (px) > 14 - Total de píxeles: no más de `6000×6000` - Las URLs de imagen deben ser directamente visibles por el servidor, o la URL de imagen debe activar la descarga directa al acceder (generalmente estas URLs terminan con extensiones de archivo de imagen, como `.png`, `.jpg`)

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]
nenum<1>

Número de imágenes a generar, actualmente solo admite `1`

1
callback_urlstring<uri>

URL de callback HTTPS para completación de tarea **Momento del Callback:** - Se activa cuando la tarea se completa, falla o se cancela - Se envía después de la confirmación de facturación **Restricciones de Seguridad:** - Solo protocolo HTTPS - Direcciones IP internas están prohibidas (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - La longitud de la URL no debe exceder `2048` caracteres **Mecanismo de Callback:** - Tiempo de espera: `10` segundos - Máximo `3` reintentos después del fallo (a `1`/`2`/`4` segundos después del fallo) - El formato de respuesta del callback es consistente con la API de consulta de tareas - El código de estado 2xx se considera exitoso, otros códigos activan reintento

"https://your-domain.com/webhooks/image-task-completed"

Respuesta

application/json
成功

Cuerpo de respuesta

createdinteger

Marca de tiempo de creación de la tarea

1757156493
idstring

ID de tarea

"task-unified-1757156493-imcg5zqt"
modelstring

Nombre del modelo real utilizado

"gpt-image-1.5"
objectenum<image.generation.task>

Tipo de objeto de tarea

"image.generation.task"
progressinteger

Porcentaje de progreso de la tarea (0-100)

0
statusenum<pending | processing | completed | failed>

Estado de la tarea

"pending"
task_infoobject
{
  "can_cancel": true,
  "estimated_time": 100
}
typeenum<text | image | audio | video>

Tipo de salida de la tarea

"image"
usageobject

Información de uso y facturación

{
  "billing_rule": "per_call",
  "credits_reserved": 2.5,
  "user_group": "default"
}
POST/v1/images/generations
curl --request POST \
  --url https://api.starmagic.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-1.5",
  "prompt": "A beautiful colorful sunset over the ocean"
}'
Respuesta: 成功
{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-1.5",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 100
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 2.5,
    "user_group": "default"
  }
}