API ativaQwen 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 solicitação Documentação

Visão geral do modelo

Endpoint: /api/v1/images/generations
Custo em créditos: 4 credits at 1K, 8 at 2K
Latência típica: Async
Entrada e saída: Text, up to 10 images → PNG, WebP, or JPEG

Recursos

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

Parâmetros da solicitação

Parâmetro	Tipo	Requisito	Descrição
model	string	Obrigatório	Model identifier. Padrão: `qwen-image-2.1`
prompt	string	Obrigatório	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. Padrão: `3:2 for text-to-image, auto for edits`
resolution	1K \| 2K	Opcional	Output resolution tier. 2K costs more credits than 1K. Padrão: `1K`
background	opaque \| transparent	Opcional	Transparent output cannot be JPEG, and cannot be combined with a mask. Padrão: `opaque`
output_format	png \| webp \| jpeg	Opcional	Generated file format. Padrão: `png`
enhance_prompt	boolean	Opcional	Expand the prompt before generation. prompt_extend is accepted as an alias. Padrão: `true`
seed	integer	Opcional	Integer from 0 to 2147483647. Padrão: `0`
mask_url	string	Opcional	Public mask URL for a local edit. Requires exactly one reference image and an opaque background.

Exemplo de solicitação

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

O endpoint de geração é assíncrono. Consulte GET /api/v1/tasks/ com a mesma chave Bearer.