Zurück zu den Modellen
Live-APIQwen Image
Live-APIQwen ImageQwen Image 2.1
qwen-image-2.1Text-to-image and reference editing at 1K or 2K, with up to 10 images, local masks, and optional transparent backgrounds.
Modellübersicht
- Endpunkt
- /api/v1/images/generations
- Credit-Kosten
- 4 credits at 1K, 8 at 2K
- Typische Latenz
- Async
- Ein- und Ausgabe
- Text, up to 10 images → PNG, WebP, or JPEG
Funktionen
- 1K and 2K output
- Up to 10 reference images
- Local mask edits
- Transparent PNG or WebP
Anfrageparameter
| Parameter | Typ | Anforderung | Beschreibung |
|---|---|---|---|
| model | string | Erforderlich | Model identifier. Standard: qwen-image-2.1 |
| prompt | string | Erforderlich | Generation or edit prompt, up to 5000 characters. |
| image_urls | string[] | Optional | One to ten public image URLs. Supplying images switches the request to image editing. |
| aspect_ratio | string | Optional | 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. Standard: 3:2 for text-to-image, auto for edits |
| resolution | 1K | 2K | Optional | Output resolution tier. 2K costs more credits than 1K. Standard: 1K |
| background | opaque | transparent | Optional | Transparent output cannot be JPEG, and cannot be combined with a mask. Standard: opaque |
| output_format | png | webp | jpeg | Optional | Generated file format. Standard: png |
| enhance_prompt | boolean | Optional | Expand the prompt before generation. prompt_extend is accepted as an alias. Standard: true |
| seed | integer | Optional | Integer from 0 to 2147483647. Standard: 0 |
| mask_url | string | Optional | Public mask URL for a local edit. Requires exactly one reference image and an opaque background. |
Anfragebeispiel
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"
}'Der Generierungsendpunkt ist asynchron. Rufen Sie GET /api/v1/tasks/ mit demselben Bearer-Schlüssel ab.