seedance-2.0 API

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

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

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

Prompt: One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.

Solicitação que produziu esta amostra

{
  "model": "seedance-2.0",
  "prompt": "One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, 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.0",
    "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.0
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 / 4k (padrão 720p)
ratio	Não	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	Não	4–15 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

Limites de entrada e saída

Este modelo suporta saída de 480p, 720p, 1080p e 4k com duração de 4 a 15 segundos. As referências multimodais permitem até nove imagens, três vídeos e três clipes de áudio; o áudio não pode ser usado sozinho. Marcar mídia com valores role em content[]; Os fluxos de trabalho de primeiro quadro, edição, extensão e pesquisa na Web têm suas próprias restrições. 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

A série Seedance 2.0 suporta texto para vídeo, primeiro/primeiro e último quadro, referências multimodais, edição, extensão e pesquisa na web para texto para vídeo. Ordene mídia como texto, imagem, vídeo e áudio.

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.0",
    "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"}
    ],
    "generate_audio": true, "ratio": "16:9", "duration": 11
  }'

Edição de vídeo e pesquisa na web

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0", "content": [{"type": "text", "text": "Macro shot of cherry blossoms in spring"}],
    "generate_audio": true, "ratio": "16:9", "duration": 11,
    "tools": [{"type": "web_search"}]
  }'

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