O Qwen-Image é um modelo de geração de imagens de uso geral que oferece suporte a diversos estilos artísticos e se destaca na renderização complexa de texto . Ele processa layouts com várias linhas, gera textos no nível de parágrafo e renderiza detalhes refinados.
Acesso rápido: Guia do usuário | Experimente online(Singapore | Beijing)** |
Exemplos
Prompt | Imagem gerada |
|---|---|
Um pôster desenhado à mão em estilo terapêutico, mostrando três filhotes brincando com uma bola sobre uma grama verde exuberante, adornado com elementos decorativos como pássaros e estrelas. O título principal “Venha Brincar de Bola!” aparece em destaque no topo, com uma fonte cartoon azul e em negrito. Abaixo dele, o subtítulo “Venha [Mostrar Suas Habilidades]!” surge em fonte verde. Um balão de fala adiciona um charme lúdico com o texto: “Hehe, veja só como vou impressionar meus amiguinhos agora!” Na parte inferior, um texto complementar diz: “Que bom jogar bola com nossos amigos de novo!” A paleta de cores gira em torno de verdes e azuis frescos, com toques de rosa e amarelo vibrantes para ressaltar uma atmosfera alegre e infantil. | ![]() |
Visão geral do modelo
| Modelo | Descrição | Especificações da imagem de saída |
|---|---|---|
qwen-image-2.0-pro RecomendadoMesmas capacidades do qwen-image-2.0-pro-2026-04-22 | Série Qwen Pro para geração e edição de imagens. Oferece renderização de texto mais robusta, textura realista e maior aderência semântica.Para edição de imagens, consulte Edição do Qwen-Image. | Resolução: Defina largura e altura livremente. O total de pixels deve ficar entre 512×512 e 2048×2048. A resolução padrão é 2048×2048.Formato: PNGNúmero de imagens: 1–6 |
qwen-image-2.0-pro-2026-06-22 Recomendado | ||
| qwen-image-2.0-pro-2026-04-22 | ||
| qwen-image-2.0-pro-2026-03-03 | ||
qwen-image-2.0 RecomendadoMesmas capacidades do qwen-image-2.0-2026-03-03 | Série acelerada Qwen para geração e edição de imagens. Equilibra qualidade e velocidade de resposta.Para edição de imagens, consulte Edição do Qwen-Image. | |
qwen-image-2.0-2026-03-03 Recomendado |
Pré-requisitos
Antes de fazer uma chamada, obtenha uma chave de API e exporte a chave de API como uma variável de ambiente. Para realizar chamadas com o SDK, instale o DashScope SDK.
API síncrona
HTTP
Chamadas síncronas retornam os resultados em uma única requisição.
Singapore: POST https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
China (Beijing): POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation
Substitua {WorkspaceId} pelo seu ID do workspace real.
Parâmetros da requisição |
|
Cabeçalhos da requisição | |
Content-Type string (Obrigatório)O tipo de conteúdo da requisição. Deve ser application/json. | |
Authorization string (Obrigatório)Autentica a requisição com uma chave de API do Model Studio. Exemplo: Bearer sk-xxxx. | |
Corpo da requisição | |
model string (obrigatório)Nome do modelo. Exemplo: qwen-image-2.0-pro. | |
input object (obrigatório)Informações de entrada.
Propriedades messages array (obrigatório)Array de objetos de mensagem. Apenas conversas de turno único são suportadas, portanto o array deve conter exatamente um elemento.
Propriedades role string (obrigatório)Função da mensagem. Defina como user.contentarray (obrigatório)Array de objetos de conteúdo da mensagem.
Propriedades text string(obrigatório)Um prompt positivo descrevendo o conteúdo, estilo e composição desejados para a imagem.Suporta chinês e inglês. A série qwen-image-2.0 aceita até 1.300 tokens. Outros modelos aceitam até 800 tokens. O sistema trunca os tokens excedentes.Nota: Apenas um campo de texto é permitido. Omiti-lo ou fornecer mais de um retorna um erro. | |
parameters object (opcional)Parâmetros de processamento de imagem.
Propriedades negative_prompt string (opcional)Um prompt negativo descrevendo o que você não deseja na imagem.Suporta chinês e inglês. O comprimento máximo é de 500 caracteres. Caracteres excedentes são truncados automaticamente.Exemplo: Baixa resolução, baixa qualidade, membros distorcidos, dedos malformados, cores supersaturadas, aparência de cera, sem detalhes faciais, superfícies excessivamente lisas, aparência gerada por IA. Composição caótica. Texto borrado ou distorcido.size string (opcional)Resolução da imagem de saída, formatada como largura*altura.Modelos da série qwen-image-2.0: O total de pixels deve estar entre 512×512 e 2048×2048. A resolução padrão é 2048×2048. Resoluções recomendadas:
bool (opcional)Ativa a reescrita inteligente de prompts. O modelo otimiza o prompt positivo. Não afeta o prompt negativo.
Ver exemplos de reescrita Prompt original (orig_prompt): Um gato ruivo sentado com expressão alegre, parecendo vivaz, adorável e incrivelmente realista.Prompt real (actual_prompt): Retrato fotorrealista de vida selvagem: Um gato ruivo sentado com pelagem exuberante beijada pelo sol e uma expressão vibrante e alegre, olhos brilhando com curiosidade e calor. A cabeça do gato está levemente inclinada, orelhas erguidas para frente, boca gentilmente aberta em uma pose contente e vivaz — exalando charme adorável e detalhes incrivelmente realistas. A iluminação natural suave realça a textura de cada bigode e fio de pelo individual, com reflexos sutis no focinho e parte interna das orelhas. Fundo: um jardim de outono suavemente desfocado na hora dourada — tons quentes de folhas âmbar, luz solar filtrada através das árvores e leves indícios de degraus de pedra musgosos. A composição enfatiza o gato como ponto focal central, capturado em foco nítido com rasa profundidade de campo. Estilo: fotografia ultrarrealista, nível de detalhe National Geographic, resolução 8K, Canon EOS R5, abertura f/1.2, iluminação cinematográfica, color grading fiel à vida, pós-processamento mínimo. Sem texto ou sobreposições. bool (opcional)Adiciona uma marca d'água “Qwen-Image” no canto inferior direito da imagem. Padrão: false. Estilo da marca d'água: integer (opcional)Semente de número aleatório. Intervalo válido: [0,2147483647].Usar a mesma seed gera saídas semelhantes. Se omitida, o algoritmo usa uma semente aleatória.Nota: A geração de imagens é probabilística. Mesmo com a mesma seed, os resultados podem variar. |
Parâmetros da resposta |
As URLs das imagens são válidas apenas por 24 horas e depois são removidas automaticamente. Salve as imagens geradas prontamente. |
output objectInformações de saída da tarefa.
Propriedades choices arraySaída do modelo. Este array contém exatamente um elemento.
Propriedades finish_reason stringMotivo pelo qual a tarefa parou. O valor é stop para paradas naturais.message objectMensagem de resposta do modelo.
Propriedades role stringFunção da mensagem. Valor fixo: assistant.contentarray
Propriedades image stringURL da imagem gerada (formato PNG). Expira após 24 horas. Baixe e salve-a prontamente.objectEstatísticas do resultado da tarefa. Não retornado para modelos da série qwen-image-2.0.
Propriedades TOTAL integerNúmero total de tarefas.SUCCEEDED integerNúmero de tarefas bem-sucedidas.FAILED integerNúmero de tarefas com falha. | |
usage objectChamadas síncronas do SDK ImageSynthesis não retornam este campo.
Propriedades image_count integerNúmero de imagens geradas. Para modelos da série qwen-image-2.0, isso equivale ao n solicitado (1–6).width integerLargura da imagem gerada, em pixels.height integerAltura da imagem gerada, em pixels. | |
request_id stringIdentificador único da requisição para rastreamento e solução de problemas. | |
code stringCódigo de erro. Retornado apenas para requisições com falha. Consulte Códigos de erro. | |
message stringMensagem de erro detalhada. Retornada apenas para requisições com falha. Consulte Códigos de erro. |
Chamada via DashScope SDK
O DashScope SDK suporta Python e Java.
Os nomes dos parâmetros no SDK correspondem closely aos parâmetros HTTP, e as estruturas dos parâmetros seguem convenções específicas da linguagem. Para parâmetros de chamada síncrona, consulte HTTP.
- Python
- Java
Exemplo de requisição
Exemplo de resposta
As URLs das imagens expiram após 24 horas. Baixe as imagens prontamente.
Uso com o OpenAI Agents SDK
Modelos de geração de imagens como o Qwen-Image são chamados por meio da API nativa do DashScope e não suportam o modo compatível com OpenAI (compatible-mode). Portanto, não é possível usá-los diretamente como modelo de raciocínio de um Agent no OpenAI Agents SDK.
Em frameworks de agentes como o OpenAI Agents SDK, você pode encapsular a geração de imagens como uma ferramenta (function tool) e utilizar um modelo de chat de texto compatível com o modo OpenAI (como o qwen-plus) como núcleo de raciocínio do Agent para orquestrá-la. Por exemplo:
Antes de executar, instale as dependências: pip install openai-agents dashscope.
Faturamento e limitação de taxa
- Para cotas gratuitas e preços, consulte Preços dos modelos.
- Para limites de taxa, consulte Qwen-Image.
- Detalhes do faturamento: Cada imagem gerada com sucesso é cobrada. Chamadas com falha ou erros de processamento não geram cobranças nem consomem sua cota gratuita para novos usuários.
Códigos de erro
Se a chamada do modelo falhar e retornar uma mensagem de erro, consulte Códigos de erro para resolução.
Perguntas frequentes
P: Devo ativar ou desativar o parâmetro prompt_extend?
R: Ative esta opção (padrão) se desejar um conteúdo de imagem mais diversificado e permitir que o modelo adicione detalhes. Desative-a caso precise de controle mais rigoroso sobre os detalhes da imagem e otimize seus prompts usando o Guia de prompts de texto para imagem.
P: Quais são as diferenças entre os modelos da série qwen-image-2.0?
R:
-
Modelos combinados de geração e edição de imagens: Suportam tanto texto para imagem quanto edição de imagens.
qwen-image-2.0-proeqwen-image-2.0-pro-2026-03-03: Mesmas capacidades. A série Pro oferece renderização de texto mais profissional, texturas realistas mais refinadas, cenas realistas detalhadas e maior aderência semântica. Suporta apenas chamadas síncronas.qwen-image-2.0eqwen-image-2.0-2026-03-03: Mesmas capacidades. A versão acelerada equilibra desempenho e qualidade do modelo. Suporta apenas chamadas síncronas.
