seedance-2.5 API

Use o ID exato do modelo seedance-2.5. O campo do modelo deve corresponder exatamente a esta página.

Exemplo de saídaseedance-2.5POST /v1/videos5.1s

Parâmetros: duration=5resolution=1080pratio=16:9

Prompt: A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.

Solicitação que produziu esta amostra

{
  "model": "seedance-2.5",
  "prompt": "A small research submersible descends through the deep ocean, its headlights sweeping over a drifting field of bioluminescent jellyfish and a sunken stone archway. Camera follows from behind, particles float in the beams, blue-black water, calm and mysterious, photoreal, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

Autenticação e endpoint

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

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Criar uma tarefa

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A white cat runs through a neon-lit street in the rain, cinematic tracking shot"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

Pesquisa e download

Salve o ID da tarefa. Enquete GET /v1/videos/{task_id} e download com GET /v1/videos/{task_id}/content. Os URLs de resultados podem expirar, portanto transfira o arquivo imediatamente.

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

Solicitar notas

Seedance usa content[] para texto, quadros e mídia de referência; o contrato separado Seedance asset management é documentado de forma independente.

Nota

Envie primeiro as imagens de pessoas virtuais para a biblioteca de recursos do Seedance. Aguarde o estado Active e use asset://<ID> em content[]. O Modelflare não oferece verificação de pessoas reais.

Parâmetros de solicitação

Seedance usa um envelope multimodal assíncrono. Coloque texto e mídia em content[]; as funções de mídia selecionam o primeiro/último quadro ou fluxos de trabalho de referência.

Campo	Obrigatório	Notas
model	Sim	seedance-2.5
content[]	Sim	text, image_url, video_url e audio_url; use role para identificar o propósito da mídia
resolution	Não	480p / 720p / 1080p
ratio	Não	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Não	-1 para cronometragem automática ou 4–30 segundos
generate_audio	Não	Gere diálogos, efeitos e áudio de fundo sincronizados
tools	Não	Use web_search somente onde a página oficial do modelo suportar
watermark	Não	Se deve adicionar uma marca d’água
omni_reference_task_type	Não	auto / reference / edit / extend; edição e extensão impõem regras de proporção/duração mais rígidas
output_format	Não	mp4 / mov
return_last_frame	Não	Retorna o quadro final como uma imagem

Limites de entrada e saída

Este modelo suporta 480p, 720p e 1080p. Use -1 para cronometragem automática ou escolha de 4 a 30 segundos. Uma solicitação pode combinar até 30 imagens, 10 vídeos e 10 clipes de áudio. A geração de referência comum aceita uma proporção explícita ou adaptive; os fluxos de trabalho de edição, extensão e primeiro/último quadro exigem ratio: "adaptive" e a edição requer duration: -1. As imagens de pessoas virtuais devem ser enviadas primeiro para a biblioteca de recursos; o Modelflare não oferece verificação de pessoas reais.

Exemplos de fluxo de trabalho documentados

Seedance 2.5 classifica fluxos de trabalho de referência, edição, extensão e guiados por quadros a partir das funções de mídia e do tipo de tarefa. Os exemplos mantêm o contrato oficial enquanto usam o endpoint e o ID do modelo do Modelflare.

Referência multimodal

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "omni_reference_task_type": "reference",
    "content": [
      {"type":"text","text":"@image1 performs the movement from @video1, paced to @audio1"},
      {"type":"image_url","image_url":{"url":"https://example.com/character.jpg"},"role":"reference_image"},
      {"type":"video_url","video_url":{"url":"https://example.com/motion.mp4"},"role":"reference_video"},
      {"type":"audio_url","audio_url":{"url":"https://example.com/music.mp3"},"role":"reference_audio"}
    ],
    "ratio": "16:9", "duration": 15, "output_format": "mp4"
  }'

Edição de vídeo

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "edit",
    "content": [
      {"type":"text","text":"Remove the background pedestrians but preserve the main subject"},
      {"type":"video_url","video_url":{"url":"https://example.com/source.mov"},"role":"reference_video"}
    ],
    "ratio": "adaptive", "duration": -1, "output_format": "mov"
  }'

Extensão de vídeo

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "omni_reference_task_type": "extend",
    "content": [{"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}],
    "ratio": "adaptive", "duration": 11, "output_format": "mov"
  }'

Primeiro e último frames

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5", "content": [
      {"type":"text","text":"The subject smiles while the camera makes a smooth orbit"},
      {"type":"image_url","image_url":{"url":"https://example.com/first.jpg"},"role":"first_frame"},
      {"type":"image_url","image_url":{"url":"https://example.com/last.jpg"},"role":"last_frame"}
    ],
    "ratio": "adaptive", "duration": -1, "return_last_frame": true
  }'

Erros e tarefas com falha

Parâmetros de modelo inválidos retornam um 4xx com um ID de solicitação. Uma tarefa assíncrona também pode entrar com falha após a criação ser bem-sucedida; use error_code e error_message da resposta da enquete como o motivo final da tarefa. Não tente novamente a mesma solicitação com um formato JSON diferente.

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 faturamento baseado em token. 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
seedance-2.5	O modelo documentado nesta página.