Qwen Image 3.0 API

Geração e edição de imagens Qwen com variantes Base e Pro, tipografia multilíngue, referências multi-imagem e saída controlável em 1K ou 2K.

Alibaba Cloud Geração de Imagem Lançado 21 de jul. de 2026 Singapore Endpoint proprietário

Sobre Qwen Image 3.0

Geração e edição de imagens Qwen com variantes Base e Pro, tipografia multilíngue, referências multi-imagem e saída controlável em 1K ou 2K.

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

image generation image editing multi image text rendering multilingual text dense layouts photorealism

Especificações de Qwen Image 3.0

ID do modelo
qwen-image-3-0
Autor
Alibaba Cloud
Categoria
Geração de Imagem
Lançado
21 de jul. de 2026
Entrada
TextoImagem
Saída
Imagem
Região
Singapore
Endpoints
POST/v1/images/generations
IDs de modelo alternativos
qwen-image-3.0qwen-image-3-0-proqwen-image-3.0-proalibaba/qwen-image-3-0alibaba/qwen-image-3.0alibaba/qwen-image-3-0-proalibaba/qwen-image-3.0-pro

Preços da API Qwen Image 3.0

Tarifas pay-as-you-go ao vivo do catálogo EmpirioLabs. Você também pode escolher um plano com franquias semanais.

Tipo
Especificação
Tarifa
Saída Base (1K ou 2K)
por imagem
$0.030
Saída Pro de até 2,25MP (1K)
por imagem
$0.040
Saída Pro acima de 2,25MP (2K)
por imagem
$0.075
Imagem de Entrada (1K ou 2K)
por imagem de entrada
$0.003
Comparar na página completa de preços

Como chamar a API Qwen Image 3.0

Qwen Image 3.0 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: enviar o job
curl https://api.empiriolabs.ai/v1/images/generations \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen-image-3-0",
    "prompt": "Describe what you want Qwen Image 3.0 to generate."
  }'
cURL: consultar o resultado
curl https://api.empiriolabs.ai/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $EMPIRIOLABS_API_KEY"
Python
import requests

response = requests.post(
    "https://api.empiriolabs.ai/v1/images/generations",
    headers={"Authorization": "Bearer YOUR_EMPIRIOLABS_API_KEY"},
    json={
        "model": "qwen-image-3-0",
        "prompt": "Describe what you want Qwen Image 3.0 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)
Referência completa da API Qwen Image 3.0

Parâmetros da API Qwen Image 3.0

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

ParâmetroTipoPadrãoIntervalo / valoresDescrição
promptstring--Descreva a imagem a ser criada. Com imagens de entrada anexadas, isso se torna a instrução de edição. Uma edição apenas de imagem usa um prompt de preservação neutro.
model_variantenumqwen-image-3.0-proqwen-image-3.0-pro, qwen-image-3.0Escolha Pro para fotorrealismo mais forte, layouts densos, tipografia multilíngue fina e edições complexas, ou Base para geração de menor custo. Quando isso não está...
imagearray--De uma a três imagens de referência como URLs, URIs de dados ou objetos de imagem enviados.
imagesarray--Alias-palinos no plural para múltiplas referências de imagens enviadas.
aspect_ratioenumautoauto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5Proporção de aspecto de saída opcional. Auto é o padrão. Com resolução fixa de 1K ou 2K, o Auto usa o tamanho quadrado desse nível. Com a Resolução definida como...
resolutionenum2Kauto, 1K, 2KNível de pixel de saída. O padrão é 2K, o nível máximo suportado. O nível 1K permanece em ou abaixo de 2,25 megapixels, enquanto 2K está acima de 2,25 megapixels. O...
sizestring--Tamanho exato da saída como LARGURA*ALTURA, por exemplo 2048*1536. Isso sobrepõe aspect_ratio e resolução.
use_custom_sizebooleanfalse-Use custom_width e custom_height em vez dos presets de proporção e resolução.
custom_widthnumber-256 a 2048Largura de saída personalizada em pixels. A área total deve estar entre 512x512 e 2048x2048, com uma proporção de 1:8 a 8:1.
custom_heightnumber-256 a 2048Altura de saída personalizada em pixels. A área total deve estar entre 512x512 e 2048x2048, com uma proporção de 1:8 a 8:1.
num_imagesnumber11 a 6Número de imagens de saída. Cada saída é cobrada separadamente.
negative_promptstring--Descreva elementos visuais ou qualidades a evitar na saída.
prompt_extendbooleantrue-Expanda o prompt automaticamente para uma composição e detalhes mais fortes.
prompt_extend_modeenumdirectdirect, agentObras diretas para geração e edição. O agente realiza refinamentos mais profundos de prompts e está disponível apenas para solicitações text-to-image.
3 parâmetros a mais na documentação

Bom saber

O Qwen Image 3.0 combina geração e edição de imagens Base e Pro 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. Base oferece uma opção de menor custo para iteração rápida.

Variantes

  • Escolha qwen-image-3.0-pro para fotorrealismo, layouts densos, tipografia multilíngue fina e edições complexas de múltiplas imagens.
  • Escolha qwen-image-3.0 para geração e edições rotineiras de menor custo.
  • Escolha com model_variant. Sem ele, os IDs do modelo qwen-image-3.0, alibaba/qwen-image-3.0 e alibaba/qwen-image-3-0 rodam Base 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 três 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.

Limites de saída e entrada

  • 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 pré-definidos e personalizados ficam entre 512x512 e 2048x2048 pixels, com cada lado selecionado até 2048 pixels e proporção de aspecto de 1:8 a 8:1. O dimensionamento automático pode escolher suas próprias dimensões dentro dos níveis de saída 1K ou 2K.
  • As imagens de entrada podem ser JPG, JPEG, PNG, BMP, TIFF, WEBP ou GIF, com até 10 MB cada.
  • Prompts suportam até 4.500 tokens.

Faturamento

  • A base usa uma taxa de saída entre 1K e 2K.
  • Saídas Pro de até 2,25 megapixels usam a taxa de 1K. Saídas Pro maiores usam a taxa de 2K.
  • Cada imagem de referência adiciona a taxa de entrada da imagem mostrada acima.

Desempenho

  • Gerações de 1K são otimizadas para iteração interativa. Edições complexas em 2K podem levar vários minutos.

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.

Templates de geração Qwen Image 3.0

Efeitos com Qwen Image 3.0 como modelo recomendado. Abra um para ver a prévia e como executá-lo. Todos os templates de geração

Qwen Image 3.0 no blog

Anúncios, testes de prompts e comparações que cobrem este modelo.

API Qwen Image 3.0: perguntas frequentes

Quanto custa a API Qwen Image 3.0?

Na EmpirioLabs, Qwen Image 3.0 é cobrado por uso: Saída Base (1K ou 2K) $0.030 por imagem; Saída Pro de até 2,25MP (1K) $0.040 por imagem; Saída Pro acima de 2,25MP (2K) $0.075 por imagem; Imagem de Entrada (1K ou 2K) $0.003 por imagem de entrada. Você também pode escolher um plano com franquias semanais. A tabela de tarifas ao vivo desta página sempre corresponde ao que a API cobra.

Quais entradas e saídas o Qwen Image 3.0 aceita?

O Qwen Image 3.0 recebe Texto, Imagem como entrada e retorna Imagem.

Quais resoluções o Qwen Image 3.0 aceita?

O Qwen Image 3.0 aceita auto, 1K, 2K. O padrão é 2K, e a referência de parâmetros lista os limites de cada resolução.

Qual endpoint Qwen Image 3.0 usa?

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

Qual é o ID de modelo do Qwen Image 3.0?

Envie qwen-image-3-0 como modelo na sua requisição. Os IDs alternativos qwen-image-3.0, qwen-image-3-0-pro, qwen-image-3.0-pro, alibaba/qwen-image-3-0, alibaba/qwen-image-3.0, alibaba/qwen-image-3-0-pro, alibaba/qwen-image-3.0-pro também funcionam.

Quando o Qwen Image 3.0 foi lançado?

Alibaba Cloud lançou o Qwen Image 3.0 em 21 de jul. de 2026.

De onde o Qwen Image 3.0 é servido?

No EmpirioLabs, o Qwen Image 3.0 é servido a partir de Singapore.

Posso testar Qwen Image 3.0 no navegador antes de integrar?

Sim. O playground da EmpirioLabs executa Qwen Image 3.0 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 3.0?

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. Você também pode escolher um plano com franquias semanais.

Compare Qwen Image 3.0 com outros modelos

Todas as comparações de modelos

Pronto para usar endpoints melhores?

Confira nossos preços ou entre em contato se quiser que seu próprio modelo seja implementado em nossa pilha.