Alibaba

Qwen Image 3.0

qwen-image-3.0-pro/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-pro/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.

Preços

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

Especificações	Preço unitário
1K	$0.0497
2K	$0.0993

Visão geral do posicionamento

O Qwen Image 3.0 Pro é um modelo de geração de imagens a partir de texto da série Qwen, da Alibaba, focado em imagens produtivas que carregam informações reais: uma única imagem pode organizar conteúdos densos como infográficos, layouts de jornal, conceitos de interface, grades de produtos, entre outros, além de renderizar textos multilingues com layout correto. Ele foi feito para desenvolvedores que precisam converter prompts longos em ativos visuais utilizáveis de forma estável, sendo adequado para geração de imagens em lote em aplicações de design, conteúdo, e-commerce e educação.

Destaques principais

Prompts longos suportam layouts complexos — o limite de prompt é de 18000 caracteres, suficiente para descrever arranjos multibloco, hierarquia e o texto de cada bloco.
A renderização de texto e layout é o foco — voltado à geração de imagens com elementos densos e com texto, reduzindo o retrabalho de adicionar textos e formatar o layout após a geração.
Parâmetros controláveis cobrem necessidades comuns de geração de imagens — suporta proporção de aspecto, resolução 1K/2K, formatos png/jpeg, prompt negativo e reprodução por seed.

Descrição das capacidades

Geração com prompts de texto longo: passa-se a descrição completa da imagem pelo campo prompt, com suporte a descrições longas de layout e elementos, obtendo diretamente a imagem final em uma única chamada e reduzindo a montagem em etapas.

Resolução e proporção de aspecto controladas: resolution pode ser 1K ou 2K; aspect_ratio cobre 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16 e 21:9, facilitando gerar diretamente no tamanho correspondente ao local de veiculação.

Otimização automática de prompt e restrições negativas: prompt_extend vem ativado por padrão e pode completar e otimizar automaticamente o prompt; negative_prompt serve para excluir conteúdos indesejados e aumentar a estabilidade da geração.

Reprodução por semente aleatória: oferece o parâmetro seed; inserir uma semente de 0 a 2147483647 permite reproduzir o mesmo resultado, facilitando comparações de ajuste de parâmetros e a estabilidade de fluxos em lote.

Formatos de saída direta: output_format suporta png e jpeg, permitindo escolher diretamente o formato de arquivo conforme o uso downstream e dispensando etapas extras de transcodificação.

Cenários de aplicação

Equipes de conteúdo: geração de pôsteres e layouts a partir de textos longos — inserir títulos, corpo do texto e requisitos de layout no prompt para produzir pôsteres ou layouts em estilo de jornal com texto, usados diretamente em publicações de conteúdo e materiais operacionais.
Desenvolvedores de design: geração de conceitos de interface — gerar conceitos de UI e esboços de alta fidelidade nas proporções 16:9 ou 9:16, como referência visual para revisão de produto e implementação front-end.
Operação de e-commerce: criação de imagens de exibição de produtos — gerar grades de produtos e imagens de exibição em 1:1 ou 4:3, combinando com seed fixa para produzir em lote materiais de marketing com estilo uniforme.
Cenários educacionais: materiais explicativos com texto e imagem — descrever a estrutura dos pontos de conhecimento com prompts longos e gerar imagens explicativas com texto e imagem lado a lado, para ilustrar slides de aula e materiais de treinamento.

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

O modelo é posicionado para produção visual informativa, com elementos densos e texto na imagem, e não é a primeira escolha para ilustrações ou criações artísticas puramente estéticas. Os prompts precisam especificar claramente o layout e o texto, exigindo boa capacidade de descrição; a composição complexa com múltiplas imagens de referência não faz parte do escopo desta linha (esta linha é apenas texto para imagem). O efeito é influenciado pela densidade do layout e pelo idioma; antes da geração formal em lote, deve-se validar com amostras pequenas e controlar a estabilidade com seed fixa e prompt negativo.

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-pro/text-to-image

routestringOpcional

Valor fixo atual: default

inputobjectObrigatório

Objeto de parâmetros de negócio para qwen-image-3.0-pro/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 da geração; assume a forma de um número inteiro, e a mesma semente reproduz resultados de geração semelhantes.

promptstringObrigatóriominLength 1maxLength 18000

Prompt positivo, descreve em formato de string o conteúdo, o estilo e a composição da imagem desejada, sendo a principal base para a geração da imagem.

resolutionstringOpcionalPadrão: "1K"

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

Opções:1K2K

aspect_ratiostringOpcionalPadrão: "1:1"

Proporção largura-altura do quadro de saída, especificada em formato de string; 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

Se o prompt deve ser otimizado automaticamente, valor booleano, padrão true; quando ativado, o prompt de entrada é automaticamente expandido e otimizado.

negative_promptstringOpcionalPadrão: ""maxLength 500

Prompt negativo, descreve em formato de string o conteúdo que não se deseja que apareça na imagem; o padrão é uma string vazia.

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-pro/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-pro/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-pro/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"
    }
  }
}