img_uuid e depois consulte por polling ou use callbacks. A GoEnhance oferece acesso independente e não é a API oficial da Alibaba.API Qwen-Image 3.0 Pro
Acesse o Qwen-Image 3.0 Pro pela GoEnhance com um único endpoint para geração de imagens a partir de texto e edição guiada por referências. Envie um prompt, adicione até três URLs de imagem se quiser, receba um
Criar uma API Key
Um endpoint para gerar e editar
Gerar a partir de um prompt
Omita image_list para gerar apenas a partir de texto. Escolha uma proporção compatível e a saída 1K ou 2K, ou deixe ratio: auto definir a composição.
Edite com até três referências
Adicione de uma a três URLs de imagem acessíveis em image_list. A ordem delas define como o prompt se refere a cada fonte; cada referência precisa ter menos de 10MB.
Valide o modo da requisição, a proporção, o nível e os controles opcionais antes de enviar.
Parâmetros da API Qwen-Image 3.0 Pro
Modelo obrigatório
Defina <code>model</code> como <code>qwen-image-3-pro</code>.
Prompt
Envie um prompt de texto obrigatório com 1 a 2000 caracteres.
Proporção da imagem
Escolha <code>auto</code> ou uma das 13 proporções documentadas, de <code>1:1</code> até <code>8:1</code>.
Nível de saída
Defina <code>image_size</code> como <code>1K</code> ou <code>2K</code>; o padrão é <code>2K</code>.
Imagens de referência
Se quiser, envie de um a três objetos de URL em <code>image_list</code>, cada um com menos de 10MB.
Controles do prompt
Opcionalmente adicione um prompt negativo, uma seed de 0 a 2147483647 ou <code>prompt_extend_mode</code>. O modo <code>agent</code> vale apenas para texto para imagem.
O custo vem do nível de saída mais um acréscimo por imagem de referência.
Preços da API Qwen-Image 3.0 Pro
Saída 1K
O preço documentado é de 2.43 tokens ($0.049) por imagem 1K gerada.
Saída 2K
O preço documentado é de 4.85 tokens ($0.097) por imagem 2K gerada. Requisições com <code>ratio: auto</code> são cobradas nesse nível.
Acréscimo por referência
Cada imagem de referência acrescenta 0.19 tokens ($0.0039). As proporções <code>1:8</code> e <code>8:1</code> ficam limitadas ao nível 1K — e são cobradas como tal.
Integre o Qwen-Image 3.0 Pro em três passos
1
1. Monte e valide
Escolha entre texto para imagem ou edição com referências, escreva o prompt, valide as proporções e as URLs de imagem e depois inclua o cabeçalho de autorização.
2
2. Envie e guarde
Envie a requisição por POST com
model: qwen-image-3-pro e guarde o img_uuid retornado. 3
3. Trate a conclusão
Faça polling em
GET /api/v1/jobs/detail ou receba eventos de callback HTTPS até a tarefa ter sucesso ou falhar; depois guarde o resultado ou trate o erro.Atende tanto a geração de novas imagens quanto fluxos controlados baseados em referências.
Casos de uso da API Qwen-Image 3.0 Pro
Visuais de produto
Gere conceitos de cena prontos para campanha ou leve referências de produto já aprovadas para novos ambientes.
Variações de anúncios
Produza direções visuais guiadas pelo prompt para banners, mídia paga e testes criativos sazonais.
Protótipos de design
Transforme a direção de arte escrita em conceitos de imagem antes de partir para a produção completa.
Restilização por referências
Use até três referências ordenadas para guiar a composição, os detalhes do sujeito ou o tratamento visual.
Campanhas localizadas
Crie variações de cena por região mantendo o mesmo contrato de integração.
Pipelines de conteúdo
Conecte a geração assíncrona aos sistemas de moderação, revisão, armazenamento e publicação do seu aplicativo.
Respostas sobre preços, entradas, entrega assíncrona e a intenção de busca pela API da Alibaba.