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 CloudGeração de ImagemLançado 21 de jul. de 2026SingaporeEndpoint proprietárioNovo

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 generationimage editingmulti imagetext renderingmultilingual textdense layoutsphotorealism

Especificações de Qwen Image 3.0

ID do modelo
qwen-image-3-0
Provedor
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ê paga só pelo que usa, sem mínimo mensal.

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 um fotorrealismo mais forte, layouts densos, tipografia multilíngue fina e edições complexas, ou Base para geração de menor custo.
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

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. O 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. Modes - 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. - Extensão de prompt direto funciona para geração e edição. A extensão de prompt do agente oferece um 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, presets automáticos, proporção de aspecto ou um tamanho exato personalizado. - Os 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 de 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 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 automatizada de segurança de conteúdo. Uma imagem sinalizada como explícita não é retornada. Como a imagem é gerada antes da verificação ser executada, uma geração sinalizada ainda é cobrada.

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. A tabela de tarifas ao vivo desta página sempre corresponde ao que a API cobra.

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.

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.

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.