curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-imagine-image-2.0",
  "prompt": "Calle de Tokio de noche en estilo cyberpunk, luces de neón reflejadas en el asfalto mojado"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "grok-imagine-image-2.0",
  "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": 3.06,
    "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: grok-imagine-image-2.0",
    "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"
  }
}

Grok

Grok Imagine Image 2.0 Generacion de imagenes

Grok Imagine Image 2.0 (grok-imagine-image-2.0) es el modelo de generación y edición de imágenes de xAI: la generación de texto a imagen y la edición de imagen comparten el mismo nombre de modelo
Sin image_urls es texto a imagen; al enviar 1~3 imágenes de referencia cambia automáticamente al modo de edición de imagen, sin cambiar de modelo
Modo de procesamiento asíncrono, usa el ID de tarea devuelto para consultar
Los enlaces de imágenes generadas son válidos por 24 horas, guárdalos oportunamente

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": "grok-imagine-image-2.0",
  "prompt": "Calle de Tokio de noche en estilo cyberpunk, luces de neón reflejadas en el asfalto mojado"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "grok-imagine-image-2.0",
  "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": 3.06,
    "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: grok-imagine-image-2.0",
    "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>

requerido

Nombre del modelo de generación de imágenes. La generación de texto a imagen y la edición de imagen comparten este nombre de modelo; el modo cambia automáticamente según se envíe o no image_urls

Opciones disponibles:

grok-imagine-image-2.0

Ejemplo:

"grok-imagine-image-2.0"

prompt

string

requerido

Prompt que describe la imagen que se desea generar o cómo editar las imágenes de referencia enviadas

Sintaxis de referencia multiimagen:

Al enviar varias imágenes de referencia, use <IMAGE_0>, <IMAGE_1>, <IMAGE_2> en el prompt para referirse a la 1.ª, 2.ª y 3.ª imagen de referencia respectivamente
Los índices comienzan en 0 y se corresponden uno a uno con el orden del array image_urls
Ejemplo: Coloca al personaje de <IMAGE_0> en la escena de <IMAGE_1>

Ejemplo:

"Calle de Tokio de noche en estilo cyberpunk, luces de neón reflejadas en el asfalto mojado"

image_urls

string<uri>[]

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

Nota:

Número de imágenes de entrada por solicitud: 0~3 (sin este parámetro = texto a imagen, 1~3 = edición de imagen)
Solo se admiten URLs de imagen http / https accesibles públicamente; base64 y data URL no son compatibles
Formatos de archivo admitidos: .jpeg, .jpg, .png, .webp
Las URLs de imagen deben ser directamente accesibles 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)
En la edición de imagen, las imágenes de referencia generan un coste adicional que se cuenta una sola vez por solicitud y no se multiplica por n

Maximum array length: 3

Ejemplo:

[
  "https://example.com/person.png",
  "https://example.com/scene.png"
]

size

enum<string>

predeterminado:auto

Relación de aspecto de la imagen generada; valor predeterminado auto

Relaciones admitidas (13):

Relación	Descripción
`1:1`	Cuadrado
`4:3` / `3:4`	Horizontal / vertical clásico
`3:2` / `2:3`	Horizontal / vertical estándar
`16:9` / `9:16`	Pantalla ancha / vertical móvil
`2:1` / `1:2`	Muy ancho / muy alto
`19.5:9` / `9:19.5`	Móvil pantalla completa horizontal / vertical
`20:9` / `9:20`	Ultraancho horizontal / vertical

Nota:

auto: el modelo decide la relación por sí mismo; omitir este parámetro equivale a auto (la salida suele ser vertical)
Los valores fuera de la tabla anterior no son compatibles

Opciones disponibles:

1:1,

4:3,

3:4,

3:2,

2:3,

16:9,

9:16,

2:1,

1:2,

19.5:9,

9:19.5,

20:9,

9:20,

auto

Ejemplo:

"16:9"

resolution

enum<string>

predeterminado:1K

Nivel de píxeles de la imagen de salida; valor predeterminado 1K; admite los niveles 1K y 2K

Nota:

Este modelo no admite 4K
Los valores no distinguen mayúsculas de minúsculas

Opciones disponibles:

1K,

2K

Ejemplo:

"1K"

quality

enum<string>

predeterminado:medium

Nivel de calidad de generación, controla la profundidad de razonamiento del modelo; valor predeterminado medium

Valor	Descripción
`low`	Generación más rápida y de menor coste
`medium`	Mejor calidad y más detalle

Nota:

Este modelo solo admite los niveles low / medium; otros valores como high no son compatibles
quality (nivel de calidad) y resolution (nivel de píxeles) son independientes y se pueden combinar libremente
Los valores no distinguen mayúsculas de minúsculas

Opciones disponibles:

low,

medium

Ejemplo:

"medium"

integer

predeterminado:1

Número de imágenes a generar, rango 1~10, valor predeterminado 1

Nota:

Cada imagen se factura de forma independiente y el coste aumenta linealmente con n
El coste adicional de las imágenes de referencia se cuenta una sola vez por solicitud y no se multiplica por n

Rango requerido: 1 <= x <= 10

Ejemplo:

1

callback_url

string<uri>

Dirección de callback HTTPS después de completar la tarea

Momento del callback:

Se activa cuando la tarea se completa, falla o se cancela
Se envía después de completar la confirmación de facturación

Restricciones de seguridad:

Solo se admite el protocolo HTTPS
El callback a direcciones IP internas está prohibido (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 en caso de fallo (reintentos después de 1 segundo/2 segundos/4 segundos)
El formato del cuerpo de respuesta del callback es consistente con el formato de respuesta de la API de consulta de tareas
La dirección de callback que devuelve un código de estado 2xx se considera exitosa, otros códigos de estado activarán reintentos

Ejemplo:

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

Respuesta

Tarea de imagen creada con éxito

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 usado realmente

Ejemplo:

"grok-imagine-image-2.0"

object

enum<string>

Tipo específico 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

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

Grok Imagine Image 2.0 Generacion de imagenes

Autorizaciones

Cuerpo

Respuesta