Communitygithub.com

Seedance 2.5 API (SamurAIGPT)

Habilidade de agente para interagir com a API Seedance 2.5, permitindo gerar e modificar vídeos a partir de descrições textuais.

O que é Seedance 2.5 API (SamurAIGPT)?

Esta habilidade de agente permite que você utilize a API do Seedance 2.5 para gerar e modificar vídeos baseados em prompts de texto, seguindo vídeos de estilo, imagem de início ou texto personalizado. Ela oferece suporte à geração a partir de texto (text2video), modificação de vídeos existentes (modify-video) e previsão de vídeos (predict-video). A habilidade é útil para criar conteúdos visuais rapidamente sem depender de interfaces manuais, com opções como iniciar a partir de texto ou imagem, ajustar durações e selecionar entre diferentes modelos (turbo, standard, quality, high_quality). Ela funciona em qualquer agente compatível com a estrutura skill-based, como Claude Code, Cursor ou Codex, e requer uma chave de API do Seedance configurada no ambiente (SEEDANCE_API_KEY). A comunicação é feita via chamadas HTTP à API oficial, com retorno de URLs dos vídeos gerados.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamurAIGPT/Seedance-2.5-API/tree/main/skills/seedance-v2

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Seedance 2.5 API (SamurAIGPT) faz?

Habilidade de agente em skills/seedance-v2/SKILL.md

Visão Geral

Esta habilidade permite que um agente de IA (como Claude Code, Cursor ou Codex) interaja com a API Seedance 2.5 para gerar vídeos baseados em descrições textuais ou modificar vídeos existentes.

Pré-requisitos

  • Uma chave de API do Seedance (obtida em console.seedance.ai)
  • A chave deve ser definida como variável de ambiente SEEDANCE_API_KEY

Funcionalidades

1. Gerar vídeo a partir de texto (text2video)

seedance_generate_video(prompt: str, tail_video_url: str = None, start_image_url: str = None, model: str = 'turbo', duration: int = 5)

Gera um vídeo a partir de um prompt de texto.

Parâmetros:

  • prompt (string, obrigatório): Descrição textual do vídeo desejado.
  • tail_video_url (string, opcional): URL de um vídeo de estilo para seguir.
  • start_image_url (string, opcional): URL de uma imagem de início.
  • model (string, opcional): Modelo a ser usado (turbo padrão, standard, quality, high_quality).
  • duration (int, opcional): Duração do vídeo em segundos (padrão: 5).

2. Modificar vídeo (modify-video)

seedance_modify_video(video_url: str, prompt: str, model: str = 'turbo', duration: int = 5)

Modifica um vídeo existente com base em um prompt.

Parâmetros:

  • video_url (string, obrigatório): URL do vídeo a ser modificado.
  • prompt (string, obrigatório): Descrição textual da modificação desejada.
  • model (string, opcional): Modelo a ser usado (turbo padrão).
  • duration (int, opcional): Duração do vídeo em segundos (padrão: 5).

3. Previsão de vídeo (predict-video)

seedance_predict_video(task_id: str)

Prevê o resultado de uma tarefa de geração de vídeo.

Parâmetros:

  • task_id (string, obrigatório): ID da tarefa a ser prevista.

Exemplo de Uso

# Gerar um vídeo de um gato dançando
video_url = seedance_generate_video(prompt="Um gato dançando salsa")
print(f"Vídeo gerado: {video_url}")
# Modificar um vídeo existente
modificado = seedance_modify_video(
    video_url="https://exemplo.com/video.mp4",
    prompt="Adicionar filtro vintage"
)
print(f"Vídeo modificado: {modificado}")

Notas

  • Certifique-se de que a variável de ambiente SEEDANCE_API_KEY esteja configurada antes de usar.
  • Os URLs retornados expiram; baixe os vídeos se precisar mantê-los.
  • Consulte a documentação oficial para limites de taxa e mais detalhes.

Habilidades Relacionadas