API Qwen-Image 3.0

Gere ou edite uma imagem pela GoEnhance com o modelo 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.
Criar uma API Key
Cena de estúdio abstrata representando a geração pela API Qwen-Image 3.0

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.
Objetos de arte em vidro em uma única cena de estúdio, sugerindo geração e edição de imagens

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.
Corredor de dados sem marca com um rastro de luz contínuo, representando a entrega assíncrona
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 model exatamente com o valor qwen-image-3.

Prompt

Escreva de 1 a 2000 caracteres descrevendo a imagem ou a edição desejada.

Proporção de tela

Use auto ou uma proporção documentada de 1:1 até 1:8 e 8:1.

Nível de saída

Escolha 1K ou 2K; 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.
Criar uma API Key
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.

Perguntas frequentes sobre a API Qwen-Image 3.0

Qual é o endpoint da API Qwen-Image 3.0?

Envie requisições POST para https://api.goenhance.ai/api/v1/images/generations com model: qwen-image-3.

Quanto custa a API Qwen-Image 3.0?

O preço de saída documentado é de 1.75 tokens, ou $0.035, tanto em 1K quanto em 2K. Cada imagem de referência acrescenta 0.19 token, ou $0.0039.

A API consegue editar imagens existentes?

Sim. Adicione image_list com de uma a três URLs de imagens acessíveis, cada uma com menos de 10 MB. Omita o campo para geração apenas a partir de texto.

Quais proporções são suportadas?

A API suporta auto, 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2, 1:2, 2:1, 1:4, 4:1, 1:8 e 8:1. As saídas em 1:8 e 8:1 ficam limitadas ao nível 1K.

Como funcionam os callbacks?

Informe uma URL de callback HTTPS acessível publicamente. A GoEnhance envia as mudanças processing, success e failed no mesmo formato da resposta de detalhe do job. Callbacks que não retornam 200 são repetidos até três vezes, com tempo limite de três segundos por tentativa.

Esta é uma API oficial da Alibaba?

Não. A Qwen está associada à Alibaba, mas este endpoint é fornecido de forma independente pela GoEnhance. Isso não implica parceria com a Alibaba nem endosso da Alibaba. Para um serviço operado pela Alibaba, consulte a documentação da Alibaba Cloud.

Comece a construir com a Qwen-Image 3.0