Introdução
O Qwen Image 3.0 Edição de imagem recebe de uma a três imagens de referência e uma instrução e devolve um resultado editado. Com uma única referência, é uma edição pontual; com duas ou três, ele combina — um rosto de uma, uma peça de roupa ou um fundo de outra —, desde que o prompt diga qual é qual.
O Qwen Image 3.0 é o modelo de imagem da Alibaba especializado em renderizar texto: prompts de até 5.000 caracteres, oito proporções, um nível de 1K ou 2K e um endpoint de edição que lê de uma a três referências. Sem censura, sem flag para marcar.
Escolha o modo do Qwen Image 3.0 pelo material de partida
| Material de partida | Modo |
|---|---|
| Uma direção de arte ou um brief de design por escrito | Qwen Image 3.0 Texto para imagem |
| Uma imagem de origem aprovada para revisar | Qwen Image 3.0 Edição de imagem |
Recursos e destaques
Composição de imagem pensada para o texto
O Qwen Image 3.0 é útil para conceitos visuais em que o texto fornecido, a composição e o tratamento da imagem precisam ser pensados juntos. Trate as letras geradas como um rascunho de design e revise antes de publicar.
Compor do zero e revisar uma origem são trabalhos diferentes
Use texto para imagem para montar um visual a partir de um brief escrito. Use a edição de imagem quando uma imagem existente traz a identidade, o layout ou o material que precisa ser mantido enquanto uma mudança definida é feita.
Revise a hierarquia antes do detalhe decorativo
Em pôsteres, embalagens e conceitos de campanha, decida primeiro a hierarquia da mensagem e o ponto focal. Um resultado bonito ainda falha na tarefa se o texto aprovado ou os dados do produto não aparecerem corretamente.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 5.000 caracteres. Diga o que muda e o que precisa ficar idêntico; tudo o que você deixar sem mencionar fica aberto a ser redesenhado. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De uma a três URLs publicamente acessíveis, de imagens cujos direitos você detém. pelo menos 1 itens · no máximo 3 itens |
aspect_ratio | Não | Aplica-se ao resultado, não às fontes. Uma referência que não esteja na proporção definida volta remodelada, então case de propósito quando quiser manter o enquadramento original. |
resolution | Não | 1k ou 2k, padrão 2k. É a escolha de faixa que muda o preço; cada imagem de referência em |
num_outputs | Não | Fixo em 1: uma imagem editada por requisição. Para saber se a instrução foi ambígua ou o sorteio foi azarado, dispare a mesma edição duas ou três vezes em paralelo sem seed. |
enable_prompt_expansion | Não | Ligada por padrão nesta família. Ela completa briefings magros e reescreve os detalhados, então desligue assim que o prompt for uma descrição precisa de plano. Valor padrão: |
negative_prompt | Não | Até 2.000 caracteres de exclusões. Em edições, é mais útil contra artefatos que a fonte convida — emendas na borda de uma peça, joias duplicadas, letras remanescentes. no máximo 2000 caracteres |
seed | Não | Omita enquanto explora. Fixe para comparar duas redações da mesma instrução contra um sorteio idêntico. |
Preços
| Especificação | Preço |
|---|---|
| $0.03 / imagem |
| $0.03 / imagem |
Casos de uso
Refinar uma imagem fornecida
Use este modo quando de uma a três imagens existentes devem definir o assunto, o layout ou o material. Liste-as em image_urls na ordem em que o seu prompt as cita — primeira, segunda, terceira — e diga o que cada uma fornece.
Conjuntos de personagens e séries de moda
Mantenha o personagem de uma imagem aprovada e mude um detalhe por requisição: figurino, luz ou pose. Fixe seed quando comparar duas redações da mesma mudança, para que não seja o sorteio que mudou.
Variações com texto localizado
Envie a imagem aprovada ao endpoint de edição e mude só as palavras da placa. Pose, figurino, luz e tratamento de cor são descritos como inalterados, então a variação difere no texto, e não na imagem inteira.
Cenários de hotelaria e ambientação
Envie uma imagem aprovada de quarto ou de bar e acrescente ou troque a sinalização: um aviso de porta, uma lousa de cardápio, uma linha de neon. Cite o texto novo e, se já existir uma placa, cite também o texto antigo.
Guia de prompt e dicas práticas
Escolha primeiro a proporção e o nível
aspect_ratio vale para o resultado, não para as origens: uma referência de outro formato volta remodelada, então ajuste de propósito quando o enquadramento original precisar sobreviver. Deixe a resolução em 2k para tudo que tem texto; cada imagem de referência também soma no orçamento.
Descreva a cena e cite o texto ao pé da letra
Diga primeiro o que precisa continuar idêntico e depois o que muda; tudo o que não for mencionado pode ser redesenhado. Em edições de texto, cite o texto antigo e o novo. negative_prompt aceita até 2.000 caracteres e ajuda contra restos de letras e joias duplicadas.
Adapte o exemplo incluído
Comece pelo exemplo publicado com aspect_ratio: 3:4 e resolution: 2k. Troque o assunto e a direção criativa, mas mantenha o contrato de entrada deste modo.
Keep the bathroom, the mirror, the steam, the woman's reflection, the basin, the lighting and the whole composition exactly as they are. On the blank fogged area of the mirror to the left of her reflection, add two lines of writing drawn in bold red lipstick, thick glossy strokes with clear dark glass showing through where the fog is wiped away, slightly dripping at the ends: the first line reads 'WAIT UP' and the second line below reads 'FOR ME'. The lettering is large, hand-drawn, neatly spelled and clearly legible, and catches the warm bathroom light. Change nothing else.
Texto acrescentado numa superfície que não é plana nem limpa: vidro embaçado, em que cada traço precisa tirar a condensação e mostrar o vidro escuro por trás, com um pequeno escorrido nas pontas. A instrução limita a edição à área livre à esquerda do reflexo e manda que todo o resto fique como está. Forneça a sua própria imagem — a URL é um marcador.
Confira o resultado antes de iterar
O prompt precisa dizer qual referência fornece o quê; com duas ou três fontes, o modelo não deduz os papéis sozinho. Editar um texto no lugar funciona quando você escreve tanto o texto antigo quanto o novo. A identidade escapa em edições pesadas, então mude uma coisa por vez em vez de trocar o estilo e o texto na mesma chamada.
Início rápido da API
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "alibaba/qwen-image-3.0/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "2k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
Consulte a referência da API para autenticação, esquema completo, polling e tratamento de erros.
