Alibaba

Qwen Image 3.0

qwen-image-3.0/text-to-image

Modelo de geração e edição de imagens de terceira geração da Alibaba, especializado em layout denso com prompts longos e renderização de texto em vários idiomas, com suporte à edição por imagem de referência

qwen-image-3.0-pro/image-to-image qwen-image-3.0-pro/text-to-image qwen-image-3.0/image-to-image qwen-image-3.0/text-to-image

Experimentar qwen-image-3.0/text-to-image

Entrada

Criações

Ver todas as criações

Saída

image

Preencha os parâmetros e gere — os resultados aparecerão aqui.

qwen-image-3.0 场景概念图：世界观氛围视觉探索

Estilo Arte conceitual · Construção de mundo · Cinematográfico

Prompt

Um keyframe de concept art cinematográfico em grande angular, retratando um mundo chamado Porto das Memórias de Maré, com cenário ambientado na hora azul logo após uma tempestade. Primeiro plano: blocos de cais de basalto negro úmidos, com poças rasas de reflexo, argolas de amarração de latão enferrujadas, cordas enroladas cobertas de crosta de sal e algumas lanternas de papel flutuantes meio submersas na água. Plano médio: uma fileira de casas palafitas curvadas, construídas com madeira de navio reciclada e placas de cobre oxidadas, sustentadas por enormes arcos de costelas de baleia que se estendem sobre passarelas estreitas; pequenas janelas emitem luz quente, sugerindo que são habitadas; escadas de madeira e pontes de corda conectam os níveis. Fundo: uma enorme torre em forma de farol, composta por engrenagens empilhadas de relógios de maré e reservatórios de vidro, emitindo um brilho ciano tênue, erguendo-se do mar cinzento e calmo, enquanto nuvens de tempestade distantes se rasgam no horizonte numa fina faixa de luz âmbar. Atmosfera: névoa marinha baixa rolando entre os edifícios, garoa fina, luz volumétrica atravessando a névoa pela direita, paleta de azul-esverdeado frio e azul-ardósia pontuada por âmbar contido, color grading cinematográfico de baixa saturação e aberração cromática sutil nas bordas da imagem. Estilo: realismo pictórico fundido ao design conceitual arquitetônico, com alta fidelidade de materiais em pedra úmida, veios de madeira desgastada e metal enferrujado, profundidade de campo suave mantendo o plano médio nítido, e espaço negativo ultra detalhado no céu para facilitar a composição tipográfica posterior. Composição 16:9, linha do horizonte no terço inferior, linhas-guia da passarela conduzindo o olhar até a torre.

Copie o prompt completo e adapte-o para a sua própria geração.

Etiquetas

Preços

qwen-image-3.0/text-to-image per image

Preço unitário	$0.0358

Visão geral da posição

O fluxo de geração de imagem a partir de texto do qwen-image-3.0 é a terceira geração de modelos de geração de imagem da série Qwen da Alibaba, voltado para cenários de desenvolvimento que exigem que a imagem carregue informações reais. Ele aceita prompts de até 18000 caracteres e é especializado em gerar infográficos, layouts de jornal, esboços conceituais de UI, grades de produtos e outras composições densas em elementos e com texto. Suporta duas resoluções, 1K/2K, oito proporções de aspecto, saída em PNG/JPEG e seed aleatória, sendo adequado como ferramenta de produtividade para materiais de design, protótipos de interface e materiais de marketing.

Destaques principais

Prompts longos para layouts complexos — limite de até 18000 caracteres por prompt, facilitando restringir em uma única descrição o layout de múltiplos blocos, elementos e conteúdo textual.
Diagramação e texto voltados para visuais informativos — otimização focada em diagramação densa, fontes pequenas e renderização multilíngue, tornando os layouts e esboços de interface gerados mais próximos de materiais diretamente utilizáveis.
Especificações de saída controláveis — resolução, proporção de aspecto, formato de arquivo e seed aleatória podem ser especificados; com prompt negativo e otimização automática de prompt, é fácil produzir em lote imagens com estilo consistente.

Descrição das capacidades

Geração de imagens complexas orientada por textos longos: um único prompt pode ter até 18000 caracteres, permitindo descrever composição, estilo e hierarquia de informações com descrições mais longas, reduzindo o custo de complementar o prompt em várias rodadas.

Layouts e esboços de interface com muito texto: adequado para gerar imagens em que elementos e texto coexistem, como infográficos, páginas de jornal, pôsteres e conceitos de UI, com resultados mais próximos de materiais de trabalho reais do que de imagens puramente estéticas.

Especificações de saída com controle preciso: resolução 1K ou 2K, oito proporções de aspecto de 1:1 a 21:9, formato PNG ou JPEG, e possibilidade de reproduzir ou ajustar finamente os resultados por meio da seed aleatória.

Aprimoramento de prompt e restrições negativas: prompt_extend vem ativado por padrão e pode complementar e otimizar automaticamente o prompt; negative_prompt serve para excluir elementos indesejados, aumentando o controle sobre a geração.

Cenários de aplicação

Geração de materiais de layout para equipes de design e conteúdo — inserir textos e descrições de layout de infográficos, páginas de jornal ou pôsteres e produzir imagens que podem ser usadas diretamente como referência de diagramação ou ilustração para publicação.
Esboços conceituais de UI para equipes de produto e front-end — descrever com prompts a estrutura de interfaces web, de jogos ou de transmissão ao vivo e gerar imagens conceituais para discussões de protótipos de alta fidelidade e revisões de design.
Imagens de produtos e marketing para operações de e-commerce — a partir de informações de produtos e requisitos de exibição, produzir grades de produtos e materiais de marketing para versões iniciais de páginas de detalhes e páginas de campanha.
Ilustrações texto-imagem para educação e documentação — gerar materiais com texto e imagem combinados ou ilustrações para documentos com base no conteúdo explicativo, como complemento visual para materiais didáticos, páginas de instruções e materiais internos.

Limitações e recomendações de seleção

Este fluxo suporta apenas geração de imagem a partir de texto; para modificar a imagem com base em uma imagem de referência, é necessário usar o fluxo de imagem para imagem da mesma família. As informações sobre as capacidades do modelo vêm principalmente de anúncios do fabricante e páginas de demonstração de terceiros, faltando avaliações de benchmark públicas e independentes; antes do lançamento oficial, recomenda-se validar com uma pequena amostra usando prompts do próprio negócio. Prompts longos e layouts com texto denso exigem alta precisão na descrição, e o resultado da geração é afetado pela densidade da diagramação e pelo idioma; recomenda-se combinar a seed aleatória com múltiplas gerações para filtrar os resultados. Se forem necessárias apenas ilustrações estéticas convencionais, pode-se usar um modelo mais leve de geração de imagem a partir de texto para controlar custos.

Novidades

Ver o changelog →

Novo modelo Novo modelo disponível: qwen-image-3.0-pro/text-to-image Oct 31, 2026
Novo modelo Modelo image-to-image qwen-image-3.0-pro lançado Oct 31, 2026
Novo modelo Adicionados qwen-image-3.0/text-to-image… Aug 20, 2026

Perguntas frequentes

Ver todas as perguntas →

O Qwen Image 3.0 de edição de imagens suporta quantas imagens de referência?

Suporta de 1 a 3 imagens de referência. É necessária pelo menos uma; o campo da API é input.image_urls.
Qual é a diferença entre a edição de imagens da versão padrão e da versão Pro?

A versão padrão enfatiza custo mais baixo e iteração rápida; a Pro é mais adequada para substituição precisa de texto, materiais complexos e layout final.
Como são cobrados 1K, 2K e as imagens de referência?

1K e 2K usam o mesmo nível de saída, e cada imagem de referência é cobrada uma taxa adicional; os valores exatos seguem o preço em tempo real desta página.
Como reduzir o desvio de sujeito, layout ou texto?

No Prompt, liste separadamente o conteúdo que deve ser alterado e o sujeito, o texto, a posição, os materiais, o enquadramento da câmera e a iluminação que devem ser preservados; quando precisar de texto preciso, escreva o texto desejado entre aspas.

Criar uma tarefa de geração

POST https://api.hiapi.ai/v1/tasks

Cabeçalhos

AuthorizationstringObrigatório

Chave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API

Content-TypestringOpcional

O corpo da requisição é sempre interpretado como JSON; se enviado, apenas application/json (charset opcional) é aceito — qualquer outro valor retorna 415. Exemplo: application/json.

Idempotency-KeystringOpcional

Chave de idempotência, até 255 bytes. Retries com a mesma chave da mesma conta criam a tarefa apenas uma vez; replays retornam o taskId original.

Chave de idempotência

Em timeouts de rede ou retries automáticos do cliente, a mesma chave cria a tarefa apenas uma vez, sem cobrança duplicada (escopo = a conta da chave de API). Use um identificador de negócio exclusivo (ex.: "order-42"); replays retornam o taskId original e as chaves expiram 24 h após a primeira requisição. A matriz completa de cenários está na introdução da API assíncrona unificada.

Corpo

modelstringObrigatório

Valor fixo atual: qwen-image-3.0/text-to-image

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para qwen-image-3.0/text-to-image e a rota default — veja a tabela de parâmetros abaixo.

seedintegerOpcionalmin 0max 2147483647

Semente aleatória usada para controlar a aleatoriedade do resultado da geração; use um número inteiro; com a mesma semente e os demais parâmetros idênticos, é possível reproduzir resultados semelhantes; se não for informada, o servidor gera uma aleatoriamente.

promptstringObrigatóriominLength 1maxLength 18000

Prompt positivo: descreve em texto o conteúdo, o estilo e a composição da imagem desejada; é a entrada principal da geração de imagem a partir de texto.

resolutionstringOpcionalPadrão: "1K"

Nível de resolução de saída; especifica em formato de string o nível de nitidez da imagem gerada; o padrão é 1K.

Opções:1K2K

aspect_ratiostringOpcionalPadrão: "1:1"

Proporção largura-altura da imagem de saída; especificada em formato de string de proporção; o padrão é 1:1.

Opções:1:13:22:34:33:416:99:1621:9

output_formatstringOpcionalPadrão: "png"

Formato de arquivo da imagem gerada; especificado em formato de string; o padrão é png.

Opções:pngjpeg

prompt_extendbooleanOpcionalPadrão: true

Define se o prompt deve ser otimizado automaticamente; valor booleano; quando ativado, o servidor expande e aprimora o prompt; o padrão é true.

negative_promptstringOpcionalPadrão: ""maxLength 500

Prompt negativo: descreve o conteúdo que não deve aparecer na imagem; o padrão é uma string vazia, o que significa que nenhuma restrição de exclusão é aplicada.

callbackobjectOpcional

Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.

Callbacks (Webhook)

Informe callback.url na criação e o HiAPI fará POST no seu serviço no estado terminal, sem polling. O corpo do callback replica a estrutura do detalhe da tarefa; assinatura, retries e idempotência estão descritos na introdução da API assíncrona unificada.

urlstringObrigatório

Obrigatória se callback estiver presente. No estado terminal é enviado um POST para esta URL; deve ser uma URL http(s) válida.

whenstringOpcionalPadrão: "final"

Atualmente só há suporte a final — notifica tanto em success quanto em fail.

Opções:final

storagestringOpcionalPadrão: "temp"

Nível de armazenamento de artefatos: temp (padrão, ~7 dias) ou persistent (longo prazo, cobrado por tamanho). Saldo insuficiente ou limite excedido ⇒ rebaixamento silencioso para temp; o nível efetivo aparece na resposta de detalhes.

Opções:temppersistent

Exemplos de requisição

# Envia uma tarefa assíncrona; retorna um taskId imediatamente (sem esperar a geração)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "qwen-image-3.0/text-to-image",
  "input": {
    "prompt": "…",
    "resolution": "1K",
    "aspect_ratio": "1:1",
    "output_format": "png",
    "prompt_extend": true,
    "negative_prompt": ""
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "qwen-image-3.0/text-to-image",
    input: {
      "prompt": "…",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png",
      "prompt_extend": true,
      "negative_prompt": ""
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "qwen-image-3.0/text-to-image",
        "input": {
          "prompt": "…",
          "resolution": "1K",
          "aspect_ratio": "1:1",
          "output_format": "png",
          "prompt_extend": True,
          "negative_prompt": ""
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Obter detalhes da tarefa

GET https://api.hiapi.ai/v1/tasks/:id

Campos da resposta

taskIdstringObrigatório

ID da tarefa, sempre com prefixo tk-hiapi-.

modelstringObrigatório

Nome completo resolvido do modelo. Tarefas enviadas com o parâmetro route retornam base@route (ex.: gpt-image-2/text-to-image@ext); caso contrário, igual ao nome enviado.

routestringOpcional

Presente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.

statusstringObrigatório

Estado da tarefa.

Valores de status

queued Na fila, ainda não iniciada. handling Em processamento. archiving Processamento concluído, preparando artefatos. success Terminal: concluído, artefatos disponíveis (retorna output). fail Terminal: falha (retorna error). Após o envio, acompanhe status: success e fail são terminais, os demais não. Faça polling a cada 1–3 s até o estado terminal. Em caso de sucesso, baixe os artefatos em output[].url e transfira antes de expireAt; para retenção longa, use storage: "persistent" na criação.

creatednumberObrigatório

Momento de criação da tarefa (segundos Unix).

completednumberObrigatório

Segundos Unix do estado terminal; 0 enquanto não terminal.

outputarrayOpcional

Presente apenas com status == success. Lista de artefatos — sempre um array; uma tarefa pode retornar vários types ao mesmo tempo (ex.: video + first_frame).

Array [ object ]

Itens do array

urlstringObrigatório

URL do artefato, baixável diretamente.

typestringObrigatório

Valores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.

expireAtnumberObrigatório

Segundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.

errorobjectOpcional

Presente apenas com status == fail.

codestringObrigatório

Código de erro de negócio.

messagestringObrigatório

Descrição do erro.

Exemplos de resposta

Sucesso

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Em processamento (não final)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Falhou

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}