wan2.7-image-pro API

Use o ID exato do modelo wan2.7-image-pro. O campo do modelo deve corresponder exatamente a esta página.

Exemplo de saídawan2.7-image-proPOST /v1/images/generations

Parâmetros: size=2Kn=1

Prompt: Modern poster in Chinese ink-wash style: layered misty mountains, a lone wooden boat on a still river, a single red seal-like accent, generous negative space, elegant and minimal, no text.

Solicitação que produziu esta amostra

{
  "model": "wan2.7-image-pro",
  "prompt": "Modern poster in Chinese ink-wash style: layered misty mountains, a lone wooden boat on a still river, a single red seal-like accent, generous negative space, elegant and minimal, no text.",
  "n": 1,
  "size": "2K"
}

Autenticação e endpoint

Use uma chave de API Modelflare com https://modelflare.dev/v1. O ponto de entrada do gateway é POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Gerar uma imagem

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1024x1024", "n": 1
  }'

Solicitar notas

Os modelos de imagem compatíveis com OpenAI usam prompt, n, size e quality; use a edição apenas quando a página oficial a documentar.

Parâmetros de solicitação

Wan2.7 Image / Pro usa a API de imagens síncronas. Use o formato plano compatível com OpenAI para chamadas simples; use input.messages mais parameters para múltiplas imagens, edição de região e geração sequencial. A conversão de texto em imagem Pro suporta até 4K fora do modo sequencial; o modelo padrão suporta até 2K.

Campo	Obrigatório	Notas
model	Sim	wan2.7-image-pro
prompt	Sim	Instrução de geração ou edição
image	Não	URL de imagem única/Base64; use input.messages para até 9 imagens
input.messages	Não	Mensagens aninhadas para múltiplas imagens, edição de região e geração sequencial
size	Não	1K/2K; A conversão de texto em imagem não sequencial Pro também suporta 4K
n	Não	1–4 para geração ordinária; 1–12 para geração sequencial; cobrado por imagem bem-sucedida
thinking_mode	Não	Modo de pensamento quando nenhuma imagem é fornecida
watermark	Não	Se deve adicionar uma marca d’água
parameters.prompt_extend	Não	Expansão do prompt, padrão verdadeiro;
parameters.bbox_list	Não	Caixas de região de edição interativa
parameters.enable_sequential	Não	Habilitar geração sequencial
parameters.color_palette	Não	3–10 cores HEX com porcentagens totalizando 100%

Limites de resposta e entrada

Utilize a forma plana para chamadas simples; use input.messages e parameters para múltiplas imagens, edição de região e geração sequencial. São suportadas até 9 imagens de entrada, cada uma com menos de 20 MB, 240–8.000 px por borda, com proporção de aspecto de 1:8 a 8:1. A contagem de saída comum é de 1 a 4 e a contagem de saída sequencial é de 1 a 12; A conversão de texto em imagem Pro suporta 4K fora do modo sequencial, enquanto outras combinações chegam a 2K.

Exemplos de fluxo de trabalho documentados

Wan2.7 A imagem suporta uma forma plana e uma forma aninhada input.messages/parameters; use a forma aninhada para múltiplas imagens, edição de região e geração sequencial.

Edição de múltiplas imagens

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro",
    "input": {"messages": [{"role": "user", "content": [
      {"image": "https://example.com/person.png"},
      {"image": "https://example.com/background.png"},
      {"text": "将图 1 中的人物放入图 2 的场景中"}
    ]}], "parameters": {"size": "2K", "n": 1, "prompt_extend": true}}
  }'

Edição interativa de região

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro", "input": {"messages": [{"role": "user", "content": [
      {"image": "https://example.com/room.png"},
      {"text": "将选中区域的花瓶替换成红玫瑰"}
    ]}], "parameters": {"size": "2K", "n": 1, "bbox_list": [[[420, 280, 760, 720]]]}}
  }'

Grupo de imagens sequenciais

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "wan2.7-image-pro", "input": {"messages": [{"role": "user", "content": [{"text": "生成四张角色一致的季节分镜"}]}]},
    "parameters": {"size": "2K", "enable_sequential": true, "n": 4, "watermark": false}
  }'

Erros e tarefas com falha

Parâmetros de modelo inválidos retornam um 4xx com um ID de solicitação; use os campos de resposta e a mensagem de erro definidos pelo contrato modelo selecionado.

Escopo suportado

Esta página cobre chamadas de geração e edição de modelo Modelflare. O enriquecimento de pesquisa ou mapa, gerenciamento de voz e gerenciamento de biblioteca de elementos são APIs de recursos fora dessa superfície pública de chamada de modelo e não são campos de solicitação obrigatórios.

Preços e cobrança

Este modelo utiliza cobrança por chamada. Consulte a página de preços do modelo para obter o preço atual do cliente, a lista de preços de referência e as especificações completas.

Nota

Esta página documenta a interface pública do Modelflare; os campos e limites mostrados aqui são o contrato atual.

Variantes

ID do modelo	Diferença
wan2.7-image-pro	O modelo documentado nesta página.