Como Usar a API Qwen Image 3.0

Resposta curta: Qwen Imagem 3.0 é um modelo de imagem com variantes Base e Pro para geração e edição. Uso model_variant para escolher a variante Base de menor custo ou a versão Pro de maior qualidade. Ambos passam por PÓS-/v1/images/generations.

Base ou Pro?

Ambas as variantes aceitam até três imagens de referência e podem retornar até seis imagens em um único pedido. Cada imagem de referência adiciona uma pequena carga de entrada por imagem. Assista ao vivo Precificação do Qwen Image 3.0 para todas as taxas Base, Pro e entrada-imagem.

Gerar com Base

Definir sincronização: verdadeiro quando você quer que o pedido aguarde a resposta completa da imagem em formato de OpenAI. Sem ele, a geração de imagens permanece assíncrona e retorna um trabalho para pesquisar.

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "Autorização: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Conteúdo: application/json" \ -d '{ "modelo": "qwen-image-3-0", "model_variant": "qwen-image-3.0", "prompt": "Uma campanha premium de água com gás em um set cobalto. A etiqueta diz EMPIRIO LABS em letras brancas nítidas. Condensação, luz de borda dura, fotografia editorial de produtos.", "resolução": "1K", "aspect_ratio": "4:5", "prompt_extend": verdadeiro, "prompt_extend_mode": "direto", "num_images": 1, "sincronização": verdadeiro }'

Editando com Pro

Coloque as imagens antes da instrução. O mesmo endpoint entra automaticamente no modo de edição.

curl -X POST https://api.empiriolabs.ai/v1/images/generations \ -H "Autorização: Portador $EMPIRIOLABS_API_KEY" \ -H "Tipo-Conteúdo: application/json" \ -d '{ "modelo": "qwen-image-3-0", "model_variant": "qwen-image-3.0-pro", "imagens": [ "https://example.com/product.png", "https://example.com/style-reference.png" ], "prompt": "Mantenha a identidade do produto da primeira imagem, use a linguagem de iluminação e cores da segunda, e adicione o título CONSTRUÍDO PARA AMANHÃ.", "size": "2048*1536", "negative_prompt": "texto errado, logo distorcido, produto duplicado", "seed": 271828, "sync": true }'

Níveis de resolução e faturamento

• Presets: escolha resolução como 1K, 2K, ou Auto, então selecione um aspect_ratio.
• Dimensões exatas: Uso Tamanho: "LARGURA*ALTURA", ou ligar use_custom_size e fornecer custom_width Além disso custom_height.
• Limite de vantagem: saídas de até 2,25 megapixels usam a taxa de 1K. Qualquer coisa maior usa a taxa de 2K.
• Preço base: O Base tem um único preço de saída em ambos os níveis de pixel.

Modos de extensão de prompt

Direto é o padrão e funciona tanto para geração quanto para edição. agente realiza refinamento mais profundo de prompts para text-to-image, mas não pode ser usado quando imagens de referência são anexadas. Cenário prompt_extend: falso Quando a redação exata e as instruções de composição devem passar inalteradas.

Notas operacionais úteis

• Edições apenas com imagem funcionam. Se você anexar uma imagem sem um prompt, EmpirioLabs fornece uma instrução neutra que preserva os principais sujeitos.
• Tamanhos personalizados têm limites de área. A área de saída deve permanecer entre 512x512 e 2048x2048 pixels, cada lado pode ter no máximo 2048 pixels, e a proporção deve permanecer entre 1:8 e 8:1.
• Os formatos de referência são amplos. JPG, JPEG, PNG, BMP, TIFF, WEBP e GIF são aceitos, com até 10 MB por imagem.
• Edições complexas em 2K demoram mais. Crie um timeout generoso para o cliente para edições Pro densas, especialmente com múltiplas referências.

Experimente Qwen Image 3.0

Abrir Imagem Qwen 3.0 no Playground. Para cada parâmetro, nível de precificação e campo de resposta, use o Referência da API Qwen Image 3.0.