Introdução
Qwen Image 2 Edição de imagem recebe exatamente uma imagem de referência e uma instrução e devolve um resultado editado: com outra luz, outro estilo, outra roupa ou com letreiro adicionado, conforme o prompt descreve.
Qwen Image 2 é o modelo de imagem de uso geral da Alibaba: prompts de até 800 caracteres lidos nativamente em chinês ou inglês, cinco proporções no texto para imagem e um endpoint de edição que refaz uma referência na proporção que você escolher. Uma imagem por requisição, com um seed opcional para manter um sorteio fixo enquanto você compara.
Escolha o modo do Qwen Image 2 pelo material de partida
| Material de partida | Modo |
|---|---|
| Uma direção de arte ou um brief de design por escrito | Qwen Image 2 Texto para imagem |
| Uma imagem de origem aprovada para revisar | Qwen Image 2 Edição de imagem |
Recursos e destaques
Prompts em dois idiomas
O Qwen Image 2 lê diretamente prompts em chinês e em inglês, então a equipe pode trabalhar no idioma em que o brief fica mais claro, sem reescrevê-lo na hora de passar adiante.
Uma mudança escrita em uma imagem fornecida
O modo de edição parte de uma imagem fornecida e de uma instrução escrita. Use esse ponto de partida quando a identidade ou a composição já existem e o que está em revisão é uma mudança deliberada, não um conceito novo.
Dois pontos de partida bem separados
Texto para imagem serve para montar uma cena nova a partir da direção de arte; a edição serve para revisar uma imagem de origem. Escolher primeiro o material de partida evita avaliar um brief de edição como se fosse uma geração do zero.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Até 800 caracteres descrevendo o resultado, não a fonte. Diga o que precisa ficar idêntico e o que muda; o que não for dito pode derivar. pelo menos 1 caracteres · no máximo 800 caracteres |
image_urls | Sim | Exatamente uma URL jpeg, png ou webp acessível publicamente, de uma imagem sobre a qual você tem direitos. Uma segunda imagem é recusada antes de a requisição sair da plataforma. pelo menos 1 itens · no máximo 1 itens |
aspect_ratio | Não | 1:1 por padrão, ou 4:3, 3:4, 16:9, 9:16, 3:2, 2:3 e 21:9. A saída não segue o formato da fonte, então defina a proporção da sua foto sempre que ela importar. |
seed | Não | Deixe de fora para um sorteio novo a cada chamada; defina para comparar duas redações da mesma edição contra um sorteio idêntico. |
Preços
$0.035 / imagem
Casos de uso
Refinar uma imagem fornecida
Use este modo quando uma foto existente deve definir o assunto, a composição ou o estilo. Envie-a como única entrada de image_urls, diga o que muda e o que precisa continuar idêntico, e compare o resultado com a origem no tamanho em que vai ser usado.
Produto em um cenário novo
Envie a foto do produto e descreva o ambiente onde ele deve ficar, incluindo a luz que ele precisa receber. Uma chamada, uma imagem. Se o ambiente tiver de vir de uma segunda foto, use um modelo de edição que aceite várias referências.
Produção de campanha bilíngue
Adapte um key visual aprovado para outro mercado pedindo um letreiro sobre uma superfície livre, escrito no prompt exatamente como deve aparecer, em chinês ou em inglês. Mantenha uma frase curta: letreiros e textos longos são trabalho da linha Qwen Image 3.0.
Personagens e figurino
Mantenha a pessoa de uma foto e descreva a peça nova em palavras, incluindo tecido e brilho. Ajuste aspect_ratio ao formato da foto — o padrão é 1:1 — para o resultado não virar um quadrado que você não pediu.
Guia de prompt e dicas práticas
Escolha o enquadramento antes de escrever
Quem define o formato da saída é aspect_ratio, não a imagem de origem. O padrão é 1:1 e há oito proporções, entre elas 3:2, 2:3 e 21:9; defina a que combina com a sua foto antes de escrever a instrução.
Use os 800 caracteres em uma cena completa
Descreva o resultado, não a origem. Diga primeiro o que precisa continuar idêntico, depois o que muda, e use o resto no novo cenário e na luz — tudo o que não for dito pode escapar.
Adapte o exemplo incluído
Comece pelo exemplo publicado e troque a direção criativa, mantendo o contrato de entrada deste modo.
Keep the woman and her satin robe from the image. Place her leaning on the bar of a narrow neon-lit cocktail lounge, and match the warm red lantern light onto her face and shoulders so it reads as one photograph.
Uma nova encenação com uma só referência: a mulher e o robe ficam, o bar com neon é descrito em palavras e o ajuste de luz é pedido de forma explícita. A imagem tem de vir de você — a URL aqui é um marcador, não uma amostra hospedada.
Confira o resultado antes de iterar
Aqui não há controle de intensidade e só uma referência é aceita — uma segunda é recusada antes de a requisição sair da plataforma. aspect_ratio tem 1:1 como padrão e não segue a origem, então uma foto vertical volta quadrada se você não definir a proporção. Quanto da origem sobrevive depende de quão específica é a instrução. Fixe seed quando quiser comparar duas redações da mesma edição sobre um sorteio idêntico.
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-2/edit",
"input": {
"aspect_ratio": "1:1",
"image_urls": [
"https://example.com/reference.png"
],
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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.


















