Introdução
Wan 2.7 Pro 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 Pro pelo material de partida
| O que você tem no início | Modo |
|---|---|
| um brief visual escrito | Wan 2.7 Pro Texto para imagem |
| uma imagem que precisa de uma mudança dirigida | Wan 2.7 Pro Edição de imagem |
Recursos e destaques
Até 4K, no text-to-image
Aqui o text-to-image trabalha por padrão em 2k, cerca de 4 megapixels, e vai até 4k, cerca de 16 megapixels, onde a família padrão para em 2k. O image-to-image trabalha em 2k. Essa divisão é o ponto: use 4k quando for gerar uma imagem principal que vai ser recortada ou impressa, não quando for recolorir um packshot.
Luz de vela, pele e pincelada
O segundo quadro desta página é um interior pictórico: uma figura contra um biombo em contraluz, uma vela e uma taça de vinho numa mesa de laca. Queda suave de luz, textura de pincel visível e um rosto que se lê nesse tamanho são as primeiras coisas a desmoronar numa tela pequena, e exatamente para o que a maior serve.
Ele guarda cada parte de uma instrução comprida
No image-to-image, a capacidade extra vai para seguir instruções compostas — pegue este objeto, coloque naquela superfície, iguale a luz da segunda imagem, não mexa na condensação. A família padrão derruba uma oração de uma instrução dessas com mais frequência que esta.
Parâmetros da requisição
| Parâmetro | Obrigatório | Descrição |
|---|---|---|
prompt | Sim | Escreva a mudança e a lista do que não pode mudar. pelo menos 1 caracteres · no máximo 5000 caracteres |
image_urls | Sim | De uma a nove referências numa chamada. A ordem tem significado: 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. |
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.075 / imagem
Casos de uso
Adaptar uma imagem aprovada a um novo contexto de campanha
Envie o packshot e a superfície de destino como duas referências rotuladas e peça para igualar a direção da luz e a temperatura de cor da segunda. A condensação, o rótulo e o formato do vidro ficam intactos porque você disse isso de forma explícita.
Explorar uma mudança controlada de direção de arte
Mantenha a pose e o figurino da referência e mude a luz ou o cenário na mesma instrução. Instruções compostas são exatamente aquilo para que este endpoint foi ajustado, então diga a direção da luz, a temperatura de cor e as partes que não podem se mover.
Preparar uma série consistente de variações
Fixe seed em toda uma série de variações para que a única diferença entre duas edições seja a parte que você mudou. Toda edição roda numa área de 2k, cerca de 4 megapixels; o 4k só está disponível em texto para imagem.
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 — e escreva a mudança seguida da lista do que não pode mudar. Com uma a nove referências, diga a função de cada uma; a última define as proporções quando aspect_ratio fica de fora.
Mantenha a revisão verificável por partes
Cada requisição devolve uma imagem. Monte uma série de variações repetindo a chamada com o seed e todo o resto fixos, mude uma parte por vez e compare cada resultado com a origem, e não com a edição anterior.
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. Um aspect_ratio diferente recompõe a imagem em vez de recortá-la, então confira se os elementos mantidos continuam onde deveriam.
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-pro/edit",
"input": {
"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.





























