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 img_uuid e depois consulte por polling ou use callbacks. A GoEnhance oferece acesso independente e não é a API oficial da Alibaba.
Criar uma API Key
Arte de estúdio sem marcas representando a geração de imagens com a API Qwen-Image 3.0 Pro

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.
Paisagem de fantasia em cena única e cheia de detalhes, representando a geração de imagem a partir de texto

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.
Natureza-morta de estúdio coerente, representando a edição de imagens guiada por referências
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 model como qwen-image-3-pro.

Prompt

Envie um prompt de texto obrigatório com 1 a 2000 caracteres.

Proporção da imagem

Escolha auto ou uma das 13 proporções documentadas, de 1:1 até 8:1.

Nível de saída

Defina image_size como 1K ou 2K; o padrão é 2K.

Imagens de referência

Se quiser, envie de um a três objetos de URL em image_list, cada um com menos de 10MB.

Controles do prompt

Opcionalmente adicione um prompt negativo, uma seed de 0 a 2147483647 ou prompt_extend_mode. O modo agent 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 ratio: auto 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 1:8 e 8:1 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.
Criar uma API Key
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.

Perguntas frequentes sobre a API Qwen-Image 3.0 Pro

Quanto custa a API Qwen-Image 3.0 Pro?

A GoEnhance documenta 2.43 tokens ($0.049) por saída 1K e 4.85 tokens ($0.097) por saída 2K, mais 0.19 tokens ($0.0039) para cada imagem de referência.

Esta é a API oficial da Alibaba?

Não. O Qwen está associado à Alibaba, enquanto esta página descreve um acesso independente à API fornecido pela GoEnhance. Isso não implica parceria nem endosso. Quem precisa de uma API operada pela Alibaba deve consultar a documentação da Alibaba Cloud.

O endpoint gera e edita imagens?

Sim. Omita image_list para gerar a partir de texto ou inclua de uma a três URLs de imagens de referência para editar. O endpoint retorna uma imagem gerada.

Quais proporções são suportadas?

Os valores documentados são 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.

Como funciona a extensão do prompt?

O modo padrão direct usa o prompt como está. O agent reescreve de forma mais profunda, mas só vale para requisições de texto para imagem sem image_list.

A API retorna a imagem na hora?

Não. Um envio bem-sucedido retorna um img_uuid. Faça polling no endpoint de detalhe da tarefa ou use eventos de callback para obter o resultado final.

E se o meu callback estiver indisponível?

Se o seu endpoint não retornar HTTP 200, a GoEnhance documenta até três novas tentativas de callback, com tempo limite de três segundos por tentativa. O polling continua sendo um caminho prático de recuperação.

Desenvolva com a API Qwen-Image 3.0 Pro