API activeQwen 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.

Voir la requête Documentation

Présentation du modèle

Endpoint: /api/v1/images/generations
Coût en crédits: 4 credits at 1K, 8 at 2K
Latence habituelle: Async
Entrée et sortie: Text, up to 10 images → PNG, WebP, or JPEG

Capacités

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

Paramètres de requête

Paramètre	Type	Exigence	Description
model	string	Requis	Model identifier. Par défaut: `qwen-image-2.1`
prompt	string	Requis	Generation or edit prompt, up to 5000 characters.
image_urls	string[]	Facultatif	One to ten public image URLs. Supplying images switches the request to image editing.
aspect_ratio	string	Facultatif	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. Par défaut: `3:2 for text-to-image, auto for edits`
resolution	1K \| 2K	Facultatif	Output resolution tier. 2K costs more credits than 1K. Par défaut: `1K`
background	opaque \| transparent	Facultatif	Transparent output cannot be JPEG, and cannot be combined with a mask. Par défaut: `opaque`
output_format	png \| webp \| jpeg	Facultatif	Generated file format. Par défaut: `png`
enhance_prompt	boolean	Facultatif	Expand the prompt before generation. prompt_extend is accepted as an alias. Par défaut: `true`
seed	integer	Facultatif	Integer from 0 to 2147483647. Par défaut: `0`
mask_url	string	Facultatif	Public mask URL for a local edit. Requires exactly one reference image and an opaque background.

Exemple de requête

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"
}'

L'endpoint de génération est asynchrone. Interrogez GET /api/v1/tasks/ avec la même clé Bearer.