
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.
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
qwen-image-3-0/v1/images/generationsqwen-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-proTarifas pay-as-you-go ao vivo do catálogo EmpirioLabs. Você paga só pelo que usa, sem mínimo mensal.
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 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 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-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)Parâmetros de requisição suportados pela API Qwen Image 3.0 na EmpirioLabs. Os padrões valem quando um campo é omitido.
| Parâmetro | Tipo | Padrão | Intervalo / valores | Descrição |
|---|---|---|---|---|
| prompt | string | - | - | 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_variant | enum | qwen-image-3.0-pro | qwen-image-3.0-pro, qwen-image-3.0 | Escolha Pro para um fotorrealismo mais forte, layouts densos, tipografia multilíngue fina e edições complexas, ou Base para geração de menor custo. |
| image | array | - | - | De uma a três imagens de referência como URLs, URIs de dados ou objetos de imagem enviados. |
| images | array | - | - | Alias-palinos no plural para múltiplas referências de imagens enviadas. |
| aspect_ratio | enum | auto | auto, 1:1, 16:9, 9:16, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5 | Proporçã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... |
| resolution | enum | 2K | auto, 1K, 2K | Ní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... |
| size | string | - | - | Tamanho exato da saída como LARGURA*ALTURA, por exemplo 2048*1536. Isso sobrepõe aspect_ratio e resolução. |
| use_custom_size | boolean | false | - | Use custom_width e custom_height em vez dos presets de proporção e resolução. |
| custom_width | number | - | 256 a 2048 | Largura 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_height | number | - | 256 a 2048 | Altura 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_images | number | 1 | 1 a 6 | Número de imagens de saída. Cada saída é cobrada separadamente. |
| negative_prompt | string | - | - | Descreva elementos visuais ou qualidades a evitar na saída. |
| prompt_extend | boolean | true | - | Expanda o prompt automaticamente para uma composição e detalhes mais fortes. |
| prompt_extend_mode | enum | direct | direct, agent | Obras 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. |
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.
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.
Qwen Image 3.0 é servido por POST /v1/images/generations em api.empiriolabs.ai com autenticação padrão por token Bearer.
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.
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.
Confira nossos preços ou entre em contato se quiser que seu próprio modelo seja implementado em nossa pilha.