curl --request POST \
  --url https://api.evolink.ai/v1/images/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "qwen-image-3.0",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-3.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 30
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 2.2483,
    "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: qwen-image-3.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"
  }
}

Qwen-Image

Qwen Image 3.0

Qwen (qwen-image-3.0) es la edición estándar de la generación y edición de imágenes Qwen 3.0 y admite igualmente los dos modos: generación de imagen a partir de texto (T2I, sin imagen de referencia) y edición de imagen (I2I, con 1-3 imágenes de referencia), equilibrando calidad y velocidad
Los parámetros de solicitud, el criterio de tamaño y la estructura de respuesta son idénticos a los de qwen-image-3.0-pro; solo cambian la calidad de generación y el precio
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

Facturación:

Se factura por «número de imágenes de salida × nivel de resolución»; en la edición estándar 1K y 2K cuestan lo mismo (a diferencia de Pro, donde 2K es más caro)
Si se envían imágenes de referencia (I2I), cada imagen de referencia se factura una vez aparte; este cargo es independiente de n y no crece con el número de imágenes de salida
El precio unitario es inferior al de Pro: elige este modelo cuando prime la relación calidad-precio

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": "qwen-image-3.0",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background",
  "size": "16:9",
  "quality": "2K"
}
'

{
  "created": 1757156493,
  "id": "task-unified-1757156493-imcg5zqt",
  "model": "qwen-image-3.0",
  "object": "image.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 30
  },
  "type": "image",
  "usage": {
    "billing_rule": "per_image",
    "credits_reserved": 2.2483,
    "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: qwen-image-3.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>

predeterminado:qwen-image-3.0

requerido

Nombre del modelo

Opciones disponibles:

qwen-image-3.0

Ejemplo:

"qwen-image-3.0"

prompt

string

requerido

Prompt que describe la imagen a generar (texto a imagen), o cómo editar la imagen de entrada (edición de imagen). Limitado a 4500 tokens

Maximum string length: 4500

Ejemplo:

"Replace the background of this image"

image_urls

string<uri>[]

Lista de URL de imágenes de referencia (opcional). Sin valor o array vacío = texto a imagen (T2I); con 1-3 imágenes = edición de imagen (I2I)

Nota:

Número de imágenes de entrada admitidas por solicitud: 0-3; más de 3 provoca un error
Solo se admiten URL de imágenes http/https públicas, no se admite base64 / data-url
El ancho y el alto de la imagen deben estar en el rango [384-3072] píxeles
Formatos de archivo admitidos: .jpg, .jpeg, .png, .bmp, .webp, .tiff
La URL de la imagen debe poder verse directamente desde el servidor, o descargarse directamente al acceder a ella (normalmente estas URL terminan con la extensión de la imagen, por ejemplo .png, .jpg)

Ejemplo:

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

integer

predeterminado:1

Especifica el número de imágenes a generar, admite cualquier valor entero entre [1,6]

Nota:

Cada solicitud se precobrará según el valor de n, los cobros reales se basan en el número de imágenes generadas
El cargo por las imágenes de referencia (image_urls) se cobra una sola vez por imagen subida y no crece con n

Rango requerido: 1 <= x <= 6

Ejemplo:

1

negative_prompt

string

Prompt negativo para describir contenido que no desea ver en la imagen, utilizado para restringir la salida

Nota:

Admite chino e inglés, longitud máxima de 500 caracteres, cada carácter chino/letra cuenta como un carácter, el exceso se truncará automáticamente

Maximum string length: 500

Ejemplo:

"low resolution, error, worst quality, low quality, mutilated, extra fingers, bad proportions"

size

string

predeterminado:auto

Tamaño de la imagen generada, admite tres opciones:

Opción 1 - Automático (predeterminado):

auto: el modelo selecciona automáticamente el tamaño de salida adecuado según el prompt (en este caso quality no tiene efecto)

Opción 2 - Formato de relación de aspecto:

1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9, 9:21
Se usa junto con el parámetro quality; el sistema calcula automáticamente los píxeles correspondientes a la relación y la resolución, sin necesidad de especificarlos manualmente

Opción 3 - Formato de píxeles:

ancho×alto, por ejemplo: 1024x1024, 2048x2048, 2720x1530, etc.
Rango de píxeles totales: [262144, 4194304] (es decir, de 512×512 a 2048×2048)
Rango de la relación de aspecto: [1/16, 16], un lado puede superar 2048px
Tanto el ancho como el alto deben ser mayores que 14px

Nota:

size y n son independientes entre sí; cuando n>1 también se puede especificar el tamaño/la relación
Si no se envía size, el valor predeterminado es auto

Ejemplo:

"16:9"

quality

enum<string>

predeterminado:1K

Nivel de resolución, se usa junto con el formato de relación de aspecto de size; el valor predeterminado es 1K (no tiene efecto con auto ni con el formato de píxeles).

Relación	1K	2K
`1:1`	1024×1024	2048×2048
`2:3`	832×1248	1664×2496
`3:2`	1248×832	2496×1664
`3:4`	864×1152	1770×2360
`4:3`	1152×864	2360×1770
`4:5`	896×1120	1792×2240
`5:4`	1120×896	2240×1792
`9:16`	800×1424	1530×2720
`16:9`	1424×800	2720×1530
`21:9`	1568×672	3122×1338
`9:21`	672×1568	1338×3122

Opciones disponibles:

1K,

2K

Ejemplo:

"2K"

prompt_extend

boolean

predeterminado:false

Indica si se habilita la reescritura inteligente del prompt. El valor predeterminado es false (no reescribe el prompt del usuario sin permiso); solo cuando se pasa explícitamente true se usa un modelo grande para optimizar el prompt positivo, con una mejora notable para prompts poco descriptivos o sencillos

Ejemplo:

true

watermark

boolean

predeterminado:false

Si agregar la marca de agua "Qwen-Image" en la esquina inferior derecha de la imagen. El valor predeterminado es false

Ejemplo:

false

seed

integer

Semilla aleatoria, rango [0, 2147483647], usar el mismo valor de semilla puede mantener resultados de generación consistentes

Nota:

Si no se proporciona, el algoritmo usará automáticamente una semilla aleatoria
El proceso de generación del modelo es probabilístico; incluso usando la misma semilla, no se garantiza que los resultados sean exactamente iguales cada vez

Rango requerido: 0 <= x <= 2147483647

Ejemplo:

12345

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

"qwen-image-3.0"

object

enum<string>

Tipo de tarea específico

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

Qwen Image 3.0

Autorizaciones

Cuerpo

Respuesta