curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2-beta",
  "prompt": "A beautiful colorful sunset over the ocean"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-2-beta",
  "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"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gpt-image-2-beta",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

GPT Image

GPT Image 2 Generación de imágenes Beta

El modelo GPT Image 2 (gpt-image-2-beta) 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

Compatibilidad de tamaño:

Actualmente solo se admite size=auto, o tamaños de relación (por ejemplo size="1:1") con resolution="1K"
Cuando size=auto, el campo resolution se ignora y se trata como 1K
resolution="2K" / resolution="4K" y los tamaños de píxeles explícitos (por ejemplo 1024x1024) no son compatibles actualmente
Para 2K, 4K o control explícito de píxeles, usa gpt-image-2

Facturación (per_call):

Se factura únicamente en el nivel 1K
n está fijado en 1; quality no está disponible en este canal

POST

images

generations

curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "gpt-image-2-beta",
  "prompt": "A beautiful colorful sunset over the ocean"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "gpt-image-2-beta",
  "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"
  }
}

{
  "error": {
    "code": "invalid_request",
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": "insufficient_quota",
    "message": "Insufficient quota. Please top up your account.",
    "type": "insufficient_quota"
  }
}

{
  "error": {
    "code": "model_access_denied",
    "message": "Token does not have access to model: gpt-image-2-beta",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Too many requests, please try again later",
    "type": "rate_limit_error"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Internal server error",
    "type": "api_error"
  }
}

Autorizaciones

Authorization

string

header

requerido

Todas las APIs requieren autenticación Bearer Token

Obtener API Key:

Visita la Página de gestión de API Key para obtener tu API Key

Agregar al encabezado de la solicitud:

Authorization: Bearer YOUR_API_KEY

Cuerpo

application/json

model

enum<string>

predeterminado:gpt-image-2-beta

requerido

Nombre del modelo de generación de imágenes

Opciones disponibles:

gpt-image-2-beta

Ejemplo:

"gpt-image-2-beta"

prompt

string

requerido

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

Maximum string length: 2000

Ejemplo:

"A beautiful colorful sunset over the ocean"

size

string

predeterminado:auto

Tamaño de la imagen generada. Admite dos modos:

1. auto (predeterminado)

El modelo determina automáticamente el tamaño de salida. En este modo, el campo resolution se ignora y se trata como 1K.

2. Relación (debe usarse con resolution="1K")

1:1: Cuadrado
3:2 / 2:3: Horizontal / Vertical
4:3 / 3:4: Horizontal / Vertical
5:4 / 4:5: Horizontal / Vertical
16:9 / 9:16: Pantalla ancha horizontal / vertical
21:9 / 9:21: Ultrapanorámica horizontal / vertical
2:1 / 1:2: Horizontal / Vertical
3:1 / 1:3: Panorámica horizontal / vertical (relación máxima)

Nota: Los tamaños de píxeles explícitos (por ejemplo 1024x1024) no son compatibles actualmente. Para control explícito de píxeles, usa gpt-image-2.

Ejemplo:

"16:9"

resolution

enum<string>

predeterminado:1K

Nivel de resolución. Solo es efectivo cuando size es una relación. Actualmente solo se admite 1K.

Cuándo se ignora:

Cuando size=auto, este campo se ignora y se trata como 1K (no es necesario pasar este parámetro)

Dimensiones de salida horizontal/cuadrado (las dimensiones verticales son las horizontales con ancho/alto invertidos):

Relación	1K
`1:1`	1024×1024
`2:1`	1456×720
`3:1`	1776×592
`3:2`	1248×832
`4:3`	1184×880
`5:4`	1152×912
`16:9`	1360×768
`21:9`	1568×672

Nota: 2K / 4K no son compatibles actualmente. Para mayor resolución, usa gpt-image-2.

Opciones disponibles:

1K

Ejemplo:

"1K"

image_urls

string<uri>[]

Lista de URLs de imagen de referencia para funciones de imagen a imagen y edición de imagen

Nota:

Hasta 16 imágenes de referencia por solicitud
Formatos de imagen admitidos: .jpeg, .jpg, .png, .webp
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)

Maximum array length: 16

Ejemplo:

[
  "https://example.com/image1.png",
  "https://example.com/image2.png"
]

callback_url

string<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

Ejemplo:

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

Respuesta

Tarea de imagen creada exitosamente

created

integer

Marca de tiempo de creación de la tarea

Ejemplo:

1757156493

string

ID de tarea

Ejemplo:

"task-unified-1757156493-imcg5zqt"

model

string

Nombre del modelo real utilizado

Ejemplo:

"gpt-image-2-beta"

object

enum<string>

Tipo de objeto de tarea

Opciones disponibles:

image.generation.task

progress

integer

Porcentaje de progreso de la tarea (0-100)

Rango requerido: 0 <= x <= 100

Ejemplo:

0

status

enum<string>

Estado de la tarea

Opciones disponibles:

pending,

processing,

completed,

failed

Ejemplo:

"pending"

task_info

object

Información de tarea asíncrona

Show child attributes

type

enum<string>

Tipo de salida de la tarea

Opciones disponibles:

text,

image,

audio,

video

Ejemplo:

"image"

usage

object

Información de uso y facturación

Show child attributes

GPT Image 2 Generación de imágenes Generación de imágenes GPT Image 1.5 Lite

Serie de imágenes

Serie de videos

Serie de audio

Serie de texto

Gestión de cuenta

Gestión de tareas

Gestión de archivos

GPT Image 2 Generación de imágenes Beta

Autorizaciones

Todas las APIs requieren autenticación Bearer Token

Cuerpo

Respuesta