API activaQwen Image

Qwen Image 2.1

qwen-image-2.1

Text-to-image and reference editing at 1K or 2K, with up to 10 images, local masks, and optional transparent backgrounds.

Ver solicitud Documentación

Resumen del modelo

Endpoint: /api/v1/images/generations
Coste en créditos: 4 credits at 1K, 8 at 2K
Latencia habitual: Async
Entrada y salida: Text, up to 10 images → PNG, WebP, or JPEG

Capacidades

1K and 2K output
Up to 10 reference images
Local mask edits
Transparent PNG or WebP

Parámetros de solicitud

Parámetro	Tipo	Requisito	Descripción
model	string	Obligatorio	Model identifier. Predeterminado: `qwen-image-2.1`
prompt	string	Obligatorio	Generation or edit prompt, up to 5000 characters.
image_urls	string[]	Opcional	One to ten public image URLs. Supplying images switches the request to image editing.
aspect_ratio	string	Opcional	Text-to-image ratios are 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, and 9:16. Image editing also accepts auto. Predeterminado: `3:2 for text-to-image, auto for edits`
resolution	1K \| 2K	Opcional	Output resolution tier. 2K costs more credits than 1K. Predeterminado: `1K`
background	opaque \| transparent	Opcional	Transparent output cannot be JPEG, and cannot be combined with a mask. Predeterminado: `opaque`
output_format	png \| webp \| jpeg	Opcional	Generated file format. Predeterminado: `png`
enhance_prompt	boolean	Opcional	Expand the prompt before generation. prompt_extend is accepted as an alias. Predeterminado: `true`
seed	integer	Opcional	Integer from 0 to 2147483647. Predeterminado: `0`
mask_url	string	Opcional	Public mask URL for a local edit. Requires exactly one reference image and an opaque background.

Ejemplo de solicitud

curl https://qwenapi.org/api/v1/images/generations \
  -H "Authorization: Bearer $QWEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-2.1",
  "prompt": "Editorial poster for a night market, bold headline NIGHT MARKET, gold ink on charcoal paper, wide margins",
  "aspect_ratio": "3:2",
  "resolution": "1K",
  "output_format": "png"
}'

El endpoint de generación es asíncrono. Consulta GET /api/v1/tasks/ con la misma clave Bearer.