seedance-2.0-mini API

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

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-mini",
    "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.

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-mini
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 (padrão 720p)
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–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 480p e 720p. Use -1 para cronometragem automática ou escolha 4–15 segundos; a taxa de quadros é fixada em 24fps. 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, portanto, uma solicitação precisa de pelo menos uma imagem ou vídeo de referência. Marcar mídia com valores role em content[]; Os fluxos de trabalho de primeiro quadro, edição e extensão são mutuamente exclusivos. Este modelo não aceita frames, camera_fixed, output_format ou omni_reference_task_type.

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-mini",
    "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-mini", "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.