Alibaba
Qwen Image 3.0
qwen-image-3.0/image-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
Experimentar qwen-image-3.0/image-to-image
Entrada
Criações
Ver todas as criaçõesSaída
imagePreços
qwen-image-3.0/image-to-image per image
| Preço unitário | $0.0358 |
|---|
Visão geral do posicionamento
Modelo de edição de imagens que realiza modificações iterativas com base em imagens de referência, pertencente à série Qwen-Image 3.0. Ao enviar de 1 a 3 imagens de referência e um prompt positivo descrevendo o que deve ser preservado e modificado, é possível alterar cenário, estilo, vestuário e texto da imagem, preservando detalhes-chave da imagem original, e gerar imagens em 1K ou 2K. Indicado para desenvolvedores que precisam transformar rapidamente materiais existentes em infográficos, pôsteres, conceitos de UI ou imagens de exibição de produtos, especialmente em cenários de produção de conteúdo com grande densidade de texto na imagem e alta exigência de composição multilíngue.
Destaques principais
- Edição iterativa com imagens de referência, preservando detalhes da imagem original — usa de 1 a 3 imagens como entrada e modifica cenário, estilo, vestuário e texto conforme o prompt, em vez de redesenhar completamente, facilitando iterações repetidas sobre o mesmo material.
- Renderização de texto em layouts densos e fontes pequenas — voltado ao design de imagens que carregam informações, com layout e renderização de texto multilíngue mais estáveis, adequado para infográficos, mockups de interface e outros resultados com grande densidade de texto.
- Prompts capazes de descrever layouts complexos — o prompt positivo tem limite de 18.000 caracteres, suficiente para descrever cenas com múltiplos elementos, estrutura de layout e requisitos de modificação por região.
- Especificações de saída controláveis — suporta níveis de resolução 1K/2K, 8 proporções de aspecto, saída em png ou jpeg, seed aleatória e prompt negativo, facilitando a integração dos resultados ao fluxo de produção.
Descrição das capacidades
Edição com imagens de referência: envia de 1 a 3 imagens de referência junto com um prompt para alterar o conteúdo preservando informações-chave da imagem original, adequado para modificações direcionadas em materiais existentes em vez de gerar novamente.
Prompts longos e restrições negativas: o prompt positivo suporta descrições longas de layout e das áreas a preservar ou modificar, e há prompt negativo para excluir elementos indesejados, permitindo controle preciso da imagem.
Layout e renderização de texto: gera imagens com layout correto e texto multilíngue, adaptando-se à produção de conteúdos visuais com grande densidade de texto, como infográficos e conceitos de interface.
Otimização automática de prompt: o prompt_extend vem ativado por padrão, podendo expandir automaticamente o prompt e reduzir o esforço de descrição quando a entrada é curta; também pode ser desativado para manter o texto original.
Especificações de saída e reprodutibilidade: permite especificar nível de resolução, proporção de aspecto e formato de arquivo, além de reproduzir resultados via seed, facilitando a produção em lote de materiais com estilo consistente.
Cenários de aplicação
- Designers reformulam pôsteres ou infográficos existentes — enviam o pôster ou layout original e ajustam textos, estilo ou layout conforme o prompt, obtendo uma versão atualizada do material visual pronta para veiculação.
- Equipes de produto iteram conceitos de UI — usam capturas de tela da interface existente como referência, modificam cores, layout ou textos e produzem conceitos de interface de alta fidelidade para avaliação e discussão de protótipos.
- Operações de e-commerce atualizam imagens de exibição de produtos — usam imagens de produtos como referência, ajustam cenário, fundo ou vestuário do modelo e geram imagens de exibição para páginas de detalhes e materiais de marketing.
- Localização de materiais multilíngues — usam materiais em chinês ou inglês como referência, substituem idioma e estilo e geram materiais visuais promocionais adaptados a diferentes mercados.
Limitações e recomendações de seleção
Suporta apenas edição de imagens, sem capacidade de texto para imagem; para gerar imagens a partir de texto puro, é necessário escolher a linha de texto para imagem da mesma série. As imagens de referência são limitadas a 1–3, com no máximo 10 MB por imagem, e SVG não é suportado, o que limita cenários de composição complexa com várias imagens. A legibilidade de textos em fontes pequenas é afetada pela densidade do layout e pelo idioma, devendo ser verificada imagem por imagem antes da entrega. Por ser um modelo recente, há poucas avaliações independentes públicas; recomenda-se validar o efeito com alguns exemplos antes de integrá-lo a fluxos em lote.
Novidades
Ver o changelog →- Novo modelo Novo modelo disponível: qwen-image-3.0-pro/text-to-image
- Novo modelo Modelo image-to-image qwen-image-3.0-pro lançado
- Novo modelo Adicionados qwen-image-3.0/text-to-image…
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
https://api.hiapi.ai/v1/tasks Cabeçalhos
AuthorizationstringObrigatórioChave de API da conta. Obrigatória em toda requisição. Exemplo: Bearer YOUR_HIAPI_API_KEY. Obter chave de API
Content-TypestringOpcionalO 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-KeystringOpcionalChave 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.
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órioValor fixo atual: qwen-image-3.0/image-to-image
routestringOpcionalValor fixo atual: default
inputobjectObrigatório
Objeto de parâmetros de negócio para qwen-image-3.0/image-to-image e a rota default — veja a tabela de parâmetros abaixo.
seedintegerOpcionalmin 0max 2147483647Semente aleatória para controlar a aleatoriedade dos resultados gerados, com valor em formato de número inteiro; a mesma semente combinada com os mesmos outros parâmetros permite reproduzir resultados semelhantes.
promptstringObrigatóriominLength 1maxLength 18000Prompt positivo, descreve em texto o conteúdo que deve ser preservado e alterado, com valor em formato de string.
image_urlsarrayObrigatóriominItems 1maxItems 3Array de URLs de imagens de referência, cujos elementos são strings de links de imagens, de 1 a 3; suporta JPEG, PNG, WEBP, BMP, GIF, TIFF, cada uma com no máximo 10 MB, não suporta SVG.
Array [ string ]
resolutionstringOpcionalPadrão: "1K"Nível de resolução de saída, com valor em formato de string, padrão 1K.
1K2Kaspect_ratiostringOpcionalPadrão: "1:1"Proporção largura-altura da imagem de saída, com valor em formato de string, padrão 1:1.
1:13:22:34:33:416:99:1621:9output_formatstringOpcionalPadrão: "png"Formato de arquivo da imagem gerada, com valor em formato de string, padrão png.
pngjpegprompt_extendbooleanOpcionalPadrão: trueDefine se o prompt deve ser otimizado automaticamente, com valor em formato booleano, padrão true.
negative_promptstringOpcionalPadrão: ""maxLength 500Conteúdo que não se deseja que apareça na imagem, com valor em formato de string, padrão string vazia.
callbackobjectOpcional
Configuração de notificação de estado terminal. Se omitida, sem callback: consulte a tarefa por conta própria.
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órioObrigató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.
finalstoragestringOpcionalPadrã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.
temppersistentExemplos 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/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"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/image-to-image",
input: {
"prompt": "…",
"image_urls": "…",
"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/image-to-image",
"input": {
"prompt": "…",
"image_urls": "…",
"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
https://api.hiapi.ai/v1/tasks/:id Campos da resposta
taskIdstringObrigatórioID da tarefa, sempre com prefixo tk-hiapi-.
modelstringObrigatórioNome 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.
routestringOpcionalPresente apenas se o parâmetro route explícito foi usado; ecoa o valor enviado.
statusstringObrigatórioEstado da tarefa.
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órioMomento de criação da tarefa (segundos Unix).
completednumberObrigatórioSegundos 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órioURL do artefato, baixável diretamente.
typestringObrigatórioValores possíveis no momento: video, image, audio, first_frame, last_frame, thumbnail; poderão ser ampliados.
expireAtnumberObrigatórioSegundos Unix de disponibilidade do artefato; baixe ou transfira antes da expiração.
errorobjectOpcional
Presente apenas com status == fail.
codestringObrigatórioCódigo de erro de negócio.
messagestringObrigatórioDescriçã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"
}
}
} Artigos
Ver todos os artigos →-
Avaliação comparativa
Comparação lado a lado do Recraft v4.1 Flash em text-to-image: guia de seleção e migração para desenvolvedores
Com um custo de $0.01 por imagem e capacidade de text-to-image pura, avalie se ele é adequado para seu pipeline de geração de imagens
-
Tutorial
recraft-v4.1-flash geração de imagens por texto na prática: 5 cenários de negócio de alto valor e pontos de integração
Partindo de um custo de US$ 0,01 por imagem, planeje como aplicar a geração de imagens em negócios reais
-
Tutorial
Como chamar kling-4.0/image-to-video na HiAPI: curl, Python e polling
-
Tutorial
Usar Kandinsky 6.0 Pro text-to-video na HiAPI: tutorial de curl e Python
Demonstração prática com foco na requisição: montar a chamada de prompt para clipe de vídeo, enviar a requisição, consultar o status de conclusão e baixar o resultado
-
Tutorial
Como chamar hailuo-2.3/text-to-video pela API HiAPI: curl, Python e exemplos de requisição executáveis
-
Avaliação comparativa
hailuo-2.3-fast/image-to-video comparação lado a lado: como escolher modelos de imagem para vídeo e pontos de migração
-
Tutorial
Como usar kling-4.0/text-to-video através da API HiAPI: curl, Python e um exemplo de requisição executável
Guia prático para desenvolvedores: prompts cinematográficos, áudio sincronizado, polling assíncrono e download da saída
-
Tutorial
Como chamar hailuo-2.3-fast/image-to-video pela API HiAPI: curl e Python na prática
A primeira requisição executável do nível rápido e econômico de geração de vídeo a partir de imagem — do ID do modelo ao download do MP4
-
Tutorial
Tutorial de kandinsky-6.0-pro/image-to-video na HiAPI: curl + Python
Faça uma requisição de imagem para vídeo funcional na HiAPI: do upload do primeiro quadro ao polling assíncrono e ao download final
Modelos relacionados
Ver todos os modelos →Mesmo tipo
-
Nano Banana Pro Google $0.057 /imagem -
Nano Banana Google $0.021 /imagem -
Z-Image Alibaba $0.008 /imagem -
Recraft Creative Upscale Recraft $0.357 /imagem -
Grok Imagine Image 2.0 xAI $0.052 /imagem -
Ideogram V3 Character Ideogram $0.090 /imagem -
Ideogram V4 Ideogram $0.050 /imagem -
Recraft Crisp Upscale Recraft $0.004 /imagem -
BRIA Eraser Bria $0.058 /imagem -
Grok Imagine xAI $0.011 /segundo -
GPT Image 2.5 OpenAI $0.017 /imagem -
Recraft V4.1 Recraft $0.010 /imagem
Mesmo provedor
-
Wan 2.6 Flash Alibaba $0.043 /segundo -
Qwen Audio 3.0 TTS Alibaba $0.030 /1.000 caracteres -
HappyHorse 1.1 Alibaba $0.160 /segundo -
Qwen Image 2.0 Alibaba $0.042 /imagem -
Qwen Image 2.1 Alibaba $0.020 /imagem -
HappyHorse 1.0 Alibaba $0.168 /segundo -
Wan 3.0 Video Alibaba $0.040 /segundo -
Wan 2.7 Video Alibaba $0.100 /segundo -
Wan 2.7 Image Alibaba $0.035 /imagem -
Z-Image Alibaba $0.008 /imagem





