Qwen Image 3.0 Pro

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-pro",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background"
}
'

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

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-pro",
  "prompt": "An orange cat wearing an astronaut helmet, cyberpunk neon background"
}
'

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

requerido

Nombre del modelo

Opciones disponibles:

qwen-image-3.0-pro

Ejemplo:

"qwen-image-3.0-pro"

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

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, auto por defecto:

auto (predeterminado): el modelo selecciona automáticamente un tamaño de salida adecuado
ancho x alto: como 1024x1024, 1024x1536, 1536x1024, etc.; el ancho y el alto deben estar en el rango [512, 2048] píxeles

Nota:

Especificar el tamaño explícitamente solo está disponible cuando el número de imágenes de salida n es 1; de lo contrario, se produce un error; auto no tiene esta restricción

Ejemplo:

"1024x1024"

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-pro"

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

Z Image Turbo Generación de imágenes Qwen Image Edit Plus

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

Autorizaciones

Cuerpo

Respuesta