Pular para o conteúdo

API do Mage · Modelo de vídeo

API do Seedance

Seedance, com filtro rigoroso

POST https://api.mage.space/v1/seedance/generate

Resumo rápido

A API do Seedance executa o Seedance 2.5 e outras 3 variantes pelo Mage em POST https://api.mage.space/v1/seedance/generate. Uma solicitação com as configurações padrão custa 618 Gems (cerca de US$ 0,618), sem assinatura. O Seedance aceita personagens salvos, referências e referências de áudio por @handle no prompt.

  • VídeoSaída
  • 4Variantes
  • 618Gems por clipe, padrão
  • $0.618Aproximadamente, em USD

Visão geral

O que a API do Seedance faz

O Seedance da ByteDance, do Seedance 2.0 Mini para rascunhos ao Seedance 2.5, com clipes de até 30 segundos, várias referências ou Characters e edições a partir de um vídeo de origem. Filtro rigoroso: aplica-se o filtro de conteúdo do provedor.

A linha de vídeo Seedance, da ByteDance, com movimento cinematográfico e áudio: Seedance 2.0 Mini, Seedance 2.0 Fast, Seedance 2.0 e Seedance 2.5, o mais poderoso, com clipes de até 30 segundos. Filtro rigoroso: o filtro de conteúdo do provedor analisa o prompt, as mídias de entrada e o vídeo finalizado; uma solicitação recusada por ele falha com `content_blocked` e um motivo, e o valor é reembolsado.

Aceita image, additional_images e videos como entradas.

Início rápido

Chame a API do Seedance

Defina MAGE_API_KEY, envie para /seedance/generate e consulte status_url até a solicitação ser concluída.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seedance/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "4",
  "model_id": "seedance-2.5"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('seedance', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'seedance-2.5',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("seedance", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "4",
    "model_id": "seedance-2.5",
})

print(request["result"]["url"])

Modelos

Valores de model_id do Seedance

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

model_idNomePadrão
seedance-2.0-miniSeedance 2.0 Mini
seedance-2.0-fastSeedance 2.0 Fast
seedance-2.0Seedance 2.0
seedance-2.5Seedance 2.5Sim

Opções

Parâmetros do Seedance

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

CampoValores
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

Entradas

Mídias que o Seedance aceita

Envie cada uma como URL https, data URL ou upload de até 100 MB.

CampoFunção
imageA imagem de referência.
additional_imagesImagens de referência adicionais.
videosOs vídeos de origem.

Regras

O que a API do Seedance exige

  • A edição de vídeo exige exatamente um vídeo de origem, de 4 a 30 segundos no `seedance-2.5` e de 2 a 15 segundos nos demais modelos.
  • No `seedance-2.5`, uma edição mantém a duração e a proporção do vídeo de origem: `duration` e `aspect_ratio` são ignorados, e o preço acompanha a duração do vídeo.

Mais modelos de vídeo

Outras APIs de geração de vídeo no Mage

  • Vídeo · a partir de 245 Gems

    API do Wan 3.0

    Wan 3.0, com filtro rigoroso

  • Vídeo · a partir de 40 Gems

    API do Wan Video v2.2

    Vídeo com pesos abertos e uma variante Lightning

  • Vídeo · a partir de 189 Gems

    API do Berry

    Vídeo fiel às suas referências

  • Vídeo · a partir de 360 Gems

    API do Blueberry

    Fixe o primeiro e o último frame

  • Vídeo · a partir de 618 Gems

    API do Cherry

    Nossa família de vídeos principal

  • Vídeo · a partir de 375 Gems

    API do Grok Video

    Grok Imagine em movimento

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Seedance?
Uma solicitação do Seedance com as configurações padrão (Seedance 2.5) custa 618 Gems, cerca de US$ 0,618. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do Seedance?
POST https://api.mage.space/v1/seedance/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos do Seedance posso chamar?
seedance-2.0-mini (Seedance 2.0 Mini), seedance-2.0-fast (Seedance 2.0 Fast), seedance-2.0 (Seedance 2.0), seedance-2.5 (Seedance 2.5). O padrão é o Seedance 2.5.
O Seedance aceita imagens de referência ou personagens?
O Seedance aceita image, additional_images, videos. O Seedance aceita personagens salvos, referências e referências de áudio por @handle no prompt.
Posso usar o Seedance no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Seedance pelo nome. Seu assistente lê as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do Seedance são mantidos?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.