Introdução
Wan 2.7 Edição de imagem retrabalha imagens fornecidas com uma mudança dirigida. Use quando a imagem de origem tem detalhes que precisam continuar reconhecíveis enquanto muda uma decisão local ou de estilo.
Escolha o modo do Wan 2.7 pelo material de partida
| O que você tem no início | Modo |
|---|---|
| um brief visual escrito | Wan 2.7 Texto para imagem |
| uma imagem que precisa de uma mudança dirigida | Wan 2.7 Edição de imagem |
Recursos e destaques
A edição com nove imagens desenha o que você escreveu
Dê uma referência ao image-to-image e ele desenha o briefing que você enviou, figurino e enquadramento incluídos. Nesta plataforma não há flag de conteúdo nem declaração por requisição em nenhum dos dois endpoints — a diferença está no modelo. No text-to-image ele responde a um prompt delicado com um quadro mais comportado. A cena do café desta página é text-to-image, uma camisa branca larga com chuva na janela, e é mais ou menos aí que o endpoint de texto para.
Combine até nove imagens sem pintar máscara nenhuma
O image-to-image aceita de uma a nove imagens de origem numa única requisição, então uma peça de roupa, um rosto, um ambiente e uma referência de cor podem entrar todos na mesma edição. Diga no prompt para que serve cada fonte — uma pilha sem rótulo vira média, que é o motivo mais comum de uma edição com nove imagens voltar embolada.
Ele planeja a composição antes de desenhar
O Wan 2.7 planeja o quadro antes de desenhá-lo, e isso aparece no que exige uma decisão espacial: quem está em primeiro plano, o que a mão está segurando, onde fica a fonte de luz. Prompts descritivos longos, com um sujeito claro e uma relação clara, rendem mais que pilhas de palavras-chave aqui.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Diga o que muda e o que não pode mudar. Refira-se às fontes por posição — imagem 1, imagem 2 — para o modelo saber qual é o sujeito e qual é a superfície. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De uma a nove imagens de referência numa chamada. A ordem importa: o prompt se refere a elas por posição, e a última define as proporções quando |
bounding_boxes | Não | Retângulos opcionais que marcam onde a edição deve acontecer, até dois por imagem de referência. no máximo 18 itens |
aspect_ratio | Não | 1:1, 4:3, 3:4, 16:9, 9:16, 3:2 ou 2:3. Sem padrão — deixe de fora para seguir as proporções da última referência. |
num_outputs | Não | De 1 a 4, cada uma com seu próprio seed sobre o mesmo briefing. |
resolution | Não | 1k ou 2k; padrão 1k. O 2k tem quatro vezes os pixels do 1k, e o enquadramento continua seguindo |
color_palette | Não | Tema de cores opcional com 3 a 10 cores (8 é o recomendado). pelo menos 3 itens · no máximo 10 itens |
seed | Não | De 0 a 2147483647. Fixe ao longo de um conjunto de variantes, para a única diferença entre duas edições ser a oração que você mudou. |
Preços
$0.03 / imagem
Casos de uso
Adaptar uma imagem aprovada a um novo contexto de campanha
Envie a imagem aprovada como referência e diga o único elemento que muda — o cenário, o tratamento de cor, um objeto de cena — e tudo o que não pode mudar. Se você deixar aspect_ratio de fora, o resultado segue as proporções da última referência.
Explorar uma mudança controlada de direção de arte
Envie o packshot e uma referência de cor e peça para mudar o esmalte, o tecido ou o acabamento enquanto o linho, os objetos e a luz da janela ficam intactos. Uma chamada, sem máscara, e um seed fixo para a série de variações continuar comparável.
Preparar uma série consistente de variações
A edição de imagem aceita de uma a nove referências numa única chamada, então uma peça de roupa, um rosto, um ambiente e uma referência de cor podem entrar na mesma edição. Fixe seed em toda a série para que a única diferença entre duas edições seja a parte que você mudou.
Guia de prompt e dicas práticas
Diga o que precisa ficar e o que pode mudar
Chame as fontes pela posição — imagem 1, imagem 2 — para o modelo saber qual é o assunto e qual é a superfície. Diga primeiro o que precisa continuar idêntico e depois a mudança; uma pilha de referências sem rótulo vira média.
Mantenha a revisão verificável por partes
Peça um único ajuste específico e compare com a origem. num_outputs devolve até quatro leituras da mesma edição com seeds diferentes, cada uma cobrada, o que mostra logo se o problema era a instrução ou o sorteio.
Valide o resultado que depende da origem
Cada referência precisa ser JPEG, PNG sem transparência, BMP ou WEBP, ter de 240 a 8.000 pixels por lado, proporção entre 1:8 e 8:1 e no máximo 20 MB. No padrão 1k a edição tem cerca de um megapixel; defina resolution como 2k para ter quatro vezes isso.
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/wan-2.7/edit",
"input": {
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"resolution": "1k"
}
}'
# 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.





























