qwen-image-3. Use apenas um prompt para texto para imagem ou adicione de uma a três URLs de referência para editar imagens. A GoEnhance oferece acesso independente à API; não é uma API oficial da Alibaba nem uma empresa afiliada à Alibaba.API Qwen-Image 3.0
Gere ou edite uma imagem pela GoEnhance com o modelo
Criar uma API Key
Geração e edição em um único fluxo
Um endpoint, dois modos
Envie um POST para /api/v1/images/generations com model: qwen-image-3. Informe apenas um prompt para texto para imagem ou inclua de uma a três URLs de imagens de referência acessíveis para edição. Cada requisição retorna uma imagem.
Resultados assíncronos por design
Um envio bem-sucedido retorna um img_uuid. Guarde esse valor, faça polling em GET /api/v1/jobs/detail ou informe uma URL de callback HTTPS pública para receber as mudanças de status processing, success e failed.
Valide os campos documentados antes de enviar uma tarefa de geração ou edição.
Parâmetros da API Qwen-Image 3.0
ID do modelo
Defina <code>model</code> exatamente com o valor <code>qwen-image-3</code>.
Prompt
Escreva de 1 a 2000 caracteres descrevendo a imagem ou a edição desejada.
Proporção de tela
Use <code>auto</code> ou uma proporção documentada de 1:1 até 1:8 e 8:1.
Nível de saída
Escolha <code>1K</code> ou <code>2K</code>; o padrão documentado é 2K.
Imagens de referência
Opcionalmente, informe de uma a três URLs de imagens, cada uma com menos de 10 MB, para edição.
Controles de prompt
Opcionalmente, defina um prompt negativo, uma seed e o modo de expansão direct ou agent.
O preço é calculado pela saída mais o adicional das imagens de referência.
Preços da API Qwen-Image 3.0
Preço de saída
Cada saída em 1K ou 2K custa 1.75 tokens, equivalente a $0.035 por imagem gerada.
Adicional por referência
Cada imagem de referência acrescenta 0.19 token, equivalente a $0.0039 por imagem de referência.
Cálculo da tarefa
Uma requisição com duas referências custa 2.13 tokens: 1.75 + (2 × 0.19).
Integre a API Qwen-Image 3.0
1
Montar a requisição
Envie sua credencial de API no cabeçalho Authorization e faça um POST com um corpo JSON contendo
model e prompt. Acrescente proporção, tamanho da imagem ou URLs de referência apenas quando precisar. 2
Guardar o ID da tarefa
Verifique se veio
code: 0 e armazene o img_uuid retornado. Trate respostas de tokens insuficientes e de autenticação como falhas, e não como resultados de imagem. 3
Concluir a tarefa
Faça polling no endpoint de detalhe do job ou use um callback HTTPS público. Aceite o arquivo somente depois que a tarefa chegar a success e trate o status failed de forma explícita.
Adicione geração de imagens e edições controladas aos fluxos de produção sem montar uma infraestrutura própria de serving de modelos.
Casos de uso para desenvolvedores
Imagens de produto
Crie conceitos de produto prontos para campanha a partir de prompts estruturados.
Variações criativas
Gere novas direções visuais para anúncios, posts e landing pages.
Edições guiadas por referência
Transforme de uma a três referências enviadas preservando a intenção do prompt.
Campanhas localizadas
Produza conceitos visuais por mercado a partir de briefings criativos localizados.
Pipelines de assets
Enfileire jobs de geração assíncronos dentro de fluxos de conteúdo automatizados.
Prototipagem de design
Explore ideias de composição, material e cor antes da produção final.
Respostas às dúvidas mais comuns sobre preços, entradas e integração.