wan2.7-image
Geração e Edição de Imagens wan2.7
- Série de imagens Wan2.7: suporta text-to-image, edição de imagens, edição interativa, geração sequencial e referência multi-imagem
- Modo de processamento assíncrono — envie uma tarefa e consulte os resultados usando o
task_idretornado - Suporta resoluções 1K / 2K / 4K; o wan2.7-image-pro suporta até 4K em text-to-image
- A cobrança é feita com base no número de imagens geradas com sucesso, independentemente da resolução ou da proporção
POST
Autorização
string
obrigatório
Todas as requisições exigem autenticação por Bearer Token.Acesse a página de gerenciamento de chaves de API para obter sua chave de API e, em seguida, adicione-a ao cabeçalho da requisição:
Modelos disponíveis
A cobrança é feita com base em imagens geradas com sucesso × preço unitário. A entrada não é cobrada. Resolução e proporção não afetam o preço. Requisições com falha não são cobradas.
Corpo da requisição
string
obrigatório
Nome do modelo de geração de imagens.
wan2.7-image-pro— Edição profissional, até 4K para text-to-imagewan2.7-image— Edição padrão, mais rápida, até 2K
boolean
padrão:"false"
Define se o conteúdo deve ser moderado antes do envio da tarefa de imagem.
true: verificar prompts e imagens de entrada comomni-moderation-latestfalseou omitido: não enviar solicitação de moderação, sem custo nem latência adicionais de moderação (padrão)
string
Descrição textual para a geração da imagem, até 5000 caracteres.
- Text-to-image (sem
image_urls): obrigatório - Edição de imagens (com
image_urls): opcional, mas recomendado
"A flower shop with exquisite windows, beautiful wooden door, flowers on display"array<string>
Array de URLs de imagens de entrada para cenários de edição e referência multi-imagem.Fornecer esse campo altera a requisição para o modo de edição de imagens.Formatos suportados: URLs HTTP/HTTPS; Base64
data:image/...;base64,...Restrições: até 9 imagens; JPEG / PNG / WEBP / BMP; 240–8000 px, proporção 1:8 ~ 8:1; ≤ 20MB por imagemA proporção de saída corresponde automaticamente à última imagem de entrada. O modo de edição suporta no máximo 2K — 4K não está disponível.
integer
padrão:"1"
Número de imagens a serem geradas.
- Modo padrão: 1–4 (padrão 1)
- Modo sequencial (
enable_sequential: true): 1–12 (padrão 1)
Cobrado por imagem gerada com sucesso. Cobrança antecipada com base em
n.string
Resolução ou proporção de saída. Suporta três formatos:① Palavra-chave de resolução (recomendado):
1K / 2K (padrão) / 4K (somente text-to-image com wan2.7-image-pro)② Proporção: 1:1 / 16:9 / 9:16 / 4:3 / 3:4 / 3:2 / 2:3 (padrão para o nível 2K)③ Dimensões em pixels: 1024x1024 ou 1024*1024string
Palavra-chave do nível de resolução:
1K / 2K / 4K. Pode ser combinado com size (proporção).string
Prompt negativo descrevendo elementos a evitar. Exemplo:
"blurry, distorted, low quality"boolean
padrão:"false"
Define se uma marca d’água “AI Generated” deve ser adicionada no canto inferior direito.
integer
Semente aleatória, intervalo 0–2147483647. A mesma semente com parâmetros idênticos produz resultados visualmente consistentes.
boolean
padrão:"true"
Ativa o modo de raciocínio aprimorado para melhorar a qualidade da imagem ao custo de um tempo de geração mais longo.
Só tem efeito quando o modo sequencial está desativado e nenhuma imagem de entrada é fornecida.
boolean
padrão:"false"
Ativa o modo de geração sequencial de imagens — gera múltiplas imagens tematicamente coerentes em uma única requisição. Ideal para storyboards e séries.
- Quando ativado, o
nmáximo é 12 thinking_modeecolor_palettesão ignorados no modo sequencial- O
wan2.7-image-prosuporta até 2K no modo sequencial (4K não é suportado)
array
Caixas delimitadoras (bounding boxes) para edição interativa — especifica regiões exatas para editar ou inserir conteúdo.Estrutura:
[[[x1, y1, x2, y2], ...], ...]- O comprimento do array externo deve ser igual ao comprimento de
image_urls - Passe
[]para imagens sem caixa delimitadora - Máximo de 2 caixas por imagem; as coordenadas são valores absolutos em pixels, com origem (0,0) no canto superior esquerdo
[[], [[989, 515, 1138, 681]]]array<object>
Tema de cores personalizado. Somente no modo padrão (não no modo sequencial).
- 3–10 entradas (8 recomendadas); cada entrada exige
hexeratio - A soma de todos os valores de
ratiodeve ser exatamente100.00%
Resposta
string
Status da resposta. Retorna
"success" em caso de sucesso.array
Exemplos
Texto para imagem (mínimo)
Texto para imagem (com resolução)
Texto para imagem (paleta de cores personalizada)
Geração sequencial de imagens
Edição de imagem única
Referência multi-imagem / Fusão de elementos
Edição interativa (Bounding Box)
bbox_list corresponde a image_urls na proporção 1 para 1. Passe [] para imagens sem seleção.
Consulta de resultadosA geração de imagens é assíncrona. Consulte o endpoint Status da Tarefa usando o
task_id retornado até que status == completed.