wan2.7-image API

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

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

Parâmetros: size=1536x1024n=1

Prompt: A long hotel corridor with a heavily patterned carpet, doors receding into the distance. A woman in a floor-length crimson satin coat has just taken one step forward. Behind her heel the carpet pattern has started to peel up off the floor, lifting away as loose ribbons of colour that keep the print exactly and curl into the air down the length of the hall. One hard green exit sign above, warm wall sconces along the corridor. Wide low camera on the floor line, deep perspective, real cloth weight, film grain, slight vignette, no text.

Solicitação que produziu esta amostra

{
  "model": "wan2.7-image",
  "prompt": "A long hotel corridor with a heavily patterned carpet, doors receding into the distance. A woman in a floor-length crimson satin coat has just taken one step forward. Behind her heel the carpet pattern has started to peel up off the floor, lifting away as loose ribbons of colour that keep the print exactly and curl into the air down the length of the hall. One hard green exit sign above, warm wall sconces along the corridor. Wide low camera on the floor line, deep perspective, real cloth weight, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

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",
    "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
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",
    "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", "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", "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	O modelo documentado nesta página.