Qwen Image 2.1 API

Sobre Qwen Image 2.1

Geração e edição de imagens com variantes Pro e Turbo, até dez imagens de referência, saída PNG transparente e tamanhos personalizados de até 2560x2560.

Também conhecido como Qwen Image, Alibaba Cloud Qwen Image 2.1

Especificações de Qwen Image 2.1

ID do modelo

qwen-image-2-1

Autor

Alibaba Cloud

Categoria

Geração de Imagem

Lançado

2 de out. de 2026

Entrada

TextoImagem

Saída

Imagem

Região

Singapore

Endpoints

POST/v1/images/generations

IDs de modelo alternativos

qwen-image-2.1qwen-image-2.1-proqwen-image-2.1-turboalibaba/qwen-image-2-1alibaba/qwen-image-2.1

Preços da API Qwen Image 2.1

Tarifas pay-as-you-go ao vivo do catálogo EmpirioLabs. Você paga só pelo que usa, sem mínimo mensal.

Como chamar a API Qwen Image 2.1

Qwen Image 2.1 roda por POST /v1/images/generations. A requisição retorna um job_id na hora; consulte GET /v1/jobs/{job_id} até o job terminar e leia as URLs de saída do resultado. Ou adicione "sync": true para pular o polling: a requisição fica aberta e retorna direto a resposta de imagem no estilo OpenAI, então SDKs OpenAI funcionam sem mudanças. Obtenha uma chave de API no painel EmpirioLabs.

curl https://api.empiriolabs.ai/v1/images/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-2-1",
    "prompt": "Describe what you want Qwen Image 2.1 to generate."
  }'

curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"

import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "qwen-image-2-1",
        "prompt": "Describe what you want Qwen Image 2.1 to generate.",
    },
)
job = response.json()

# Generation runs as an async job. Poll until it completes.
import time
while True:
    status = requests.get(
        f"https://api.empiriolabs.ai/v1/jobs/{job['job_id']}",
        headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    ).json()
    if status.get("status") in ("completed", "failed"):
        print(status)
        break
    time.sleep(5)

Parâmetros da API Qwen Image 2.1

Parâmetros de requisição suportados pela API Qwen Image 2.1 na EmpirioLabs. Os padrões valem quando um campo é omitido.

Bom saber

O Qwen Image 2.1 combina geração e edição de imagem Pro e Turbo em um único modelo. Pro é selecionado por padrão, a saída começa em 2K e a proporção de aspecto começa em Auto. Turbo oferece uma opção mais rápida e de menor custo.

Variantes

• Escolha qwen-image-2.1-pro para a melhor qualidade de imagem e edições complexas.
• Escolha qwen-image-2.1-turbo para geração e edições rotineiras mais rápidas e de menor custo.
• Escolha com model_variant. Sem ele, o ID do modelo qwen-image-2.1-turbo roda Turbo e todos os outros ids desse modelo rodam Pro.

Modos

• Texto para imagem a partir de um prompt.
• Edição de imagens e geração guiada por referência de uma a dez imagens.
• A extensão de prompt direto funciona para geração e edição. A extensão de prompt do agente oferece refinamento mais profundo apenas para solicitações text-to-image.

Imagens transparentes

• As imagens de saída são arquivos PNG. Para um fundo transparente, defina prompt_extend como falso e descreva a imagem desta forma: "Esta é uma imagem RGBA com transparência. Um frasco de perfume de vidro. A imagem tem canal alfa e o fundo é transparente."

Limites de produção

• De uma a seis imagens de saída por requisição.
• 1K, 2K, automático, presets de proporção ou um tamanho exato personalizado.
• Tamanhos exatos e personalizados ficam entre 512x512 e 2560x2560 pixels de área total, com proporção de aspecto de 1:8 a 8:1.

Faturamento

• Cada imagem de saída é cobrada na taxa de sua variante. Imagens de referência não são faturadas.

Segurança de conteúdo

Imagens geradas passam por uma verificação automática de segurança de conteúdo. Uma imagem sinalizada como explícita não é devolvida. Como a imagem é gerada antes da verificação ser executada, uma geração sinalizada ainda é cobrada.

API Qwen Image 2.1: perguntas frequentes

Quanto custa a API Qwen Image 2.1?

Na EmpirioLabs, Qwen Image 2.1 é cobrado por uso: Prós $0.040 por imagem; Turbo $0.016 por imagem. A tabela de tarifas ao vivo desta página sempre corresponde ao que a API cobra.

Qual endpoint Qwen Image 2.1 usa?

Qwen Image 2.1 é servido por POST /v1/images/generations em api.empiriolabs.ai com autenticação padrão por token Bearer.

Posso testar Qwen Image 2.1 no navegador antes de integrar?

Sim. O playground da EmpirioLabs executa Qwen Image 2.1 no navegador com os mesmos parâmetros que a API expõe, para você testar prompts antes de escrever código.

Como consigo uma chave de API Qwen Image 2.1?

Crie uma conta EmpirioLabs e gere uma chave em API Keys no painel. A cobrança usa créditos pay-as-you-go, então você paga apenas pelas requisições que faz.