Skip to main content
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-image
  • wan2.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 com omni-moderation-latest
  • false ou 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
Exemplo: "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 imagem
A 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*1024
string
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 n máximo é 12
  • thinking_mode e color_palette são ignorados no modo sequencial
  • O wan2.7-image-pro suporta 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
Exemplo: [[], [[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 hex e ratio
  • A soma de todos os valores de ratio deve ser exatamente 100.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.