CLI

Seedance CLI: crie vídeos e imagens no terminal e em aplicativos de IA

A CLI do Seedance funciona no seu terminal e em aplicativos de IA que executam comandos, como Claude Code, Codex, Cursor e OpenCode. Ela usa os mesmos créditos pelos mesmos preços do site e pode usar arquivos do seu computador como referência.

Para quem usa aplicativos de IA no computador, como Claude Code, Codex, Cursor e OpenCode. Se você usa o Claude ou o ChatGPT na web ou no aplicativo para celular, use o MCP. Ver como usar o MCP

Como funciona

  1. 1

    Envie a instrução para o seu aplicativo de IA

    Cole a instrução abaixo no Claude Code, Codex, Cursor, OpenCode ou em outro aplicativo de IA que execute comandos. O aplicativo instala a CLI.

    Copie esta instrução e envie-a para o seu aplicativo de IA

    Read https://www.seedance2ai.io/mcp-guide.txt and set up the Seedance2 CLI on this computer. Let me sign in in my browser, and show me the credit cost before generating.
  2. 2

    Faça login e autorize

    O aplicativo abre o navegador. Faça login na sua conta do Seedance 2.0 AI e permita o acesso.

  3. 3

    Diga o que você quer criar

    Por exemplo: “Crie um vídeo de 5 segundos de um barco de papel descendo uma rua chuvosa à noite” ou “Crie uma imagem de um gato laranja olhando a chuva”. O aplicativo informa primeiro o custo em créditos, depois gera (se o custo for alto, pergunta antes) e salva o vídeo ou a imagem na pasta em que está trabalhando (ou onde você pedir). Cada geração também aparece no seu histórico no site.

Veja em funcionamento

Você pede em uma frase e o seu aplicativo de IA executa os comandos. A saída vem de uma execução real; a espera foi encurtada aqui e esta geração levou cerca de dois minutos.

result.mp4
result.mp4: o vídeo gerado por estes comandos.

Configure você mesmo

  1. 1

    Instalar a CLI

    Instale a CLI com o primeiro comando. É necessário Node.js 22 ou posterior no macOS ou Linux; no Windows, use o WSL.

    npm install -g @seedance2ai/cli
  2. 2

    Entrar e autorizar no navegador

    Execute o segundo comando e, em seguida, faça login e permita o acesso na janela do navegador que se abre.

    seedance2 auth login
  3. 3

    Verificar saldo de créditos

    Confira seu saldo de créditos com o terceiro comando.

    seedance2 account

Gerar

Depois de configurar, basta dizer ao aplicativo de IA o que você quer gerar. Para gerar manualmente, siga estes passos:

  1. 1

    Escrever a solicitação

    Crie um arquivo chamado request.json com o modelo e seus campos, como no exemplo abaixo. Os campos de imagem e vídeo também aceitam arquivos do seu computador.

    request.json

    {"model":"seedance2","quality_tier":"fast","prompt":"A paper boat drifting down a rainy street at night","duration":"5","resolution":"720p"}
  2. 2

    Consultar o preço

    Execute este comando para ver o custo em créditos. A consulta de preço é gratuita.

    seedance2 estimate --input request.json
  3. 3

    Iniciar a geração

    Substitua CREDITS por esse preço; uma geração mais cara não é enviada. O comando aguarda o resultado e retorna o ID da tarefa.

    seedance2 create --input request.json --max-credits CREDITS --wait
  4. 4

    Baixar o resultado

    Substitua TASK_ID pelo ID da tarefa da etapa anterior.

    seedance2 download TASK_ID --output result.mp4

Execute seedance2 --help para ver todos os comandos.

Modelos disponíveis

Cada modelo oferece as mesmas opções do site e da API.

  • Seedance 2.5
    Vídeo
    Texto, imagem ou mídia de referência para vídeo; de 4 a 30 segundos, até 2K, com som. Requer uma compra anterior.
  • Seedance 2.0
    Vídeo
    Texto, imagem ou mídia de referência para vídeo; de 4 a 15 segundos, nos níveis de qualidade Mini, Fast e Pro.
  • Kling 4.0
    Vídeo
    Texto, mídia de referência ou quadros-chave para vídeo; de 3 a 30 segundos, em 720p ou 1080p.
  • GPT Image 2.5
    Imagem
    Geração de imagens a partir de texto e edição de imagens.
  • GPT Image 2
    Imagem
    Geração de imagens a partir de texto e edição de imagens, com até quatro imagens por solicitação.
  • Nano Banana Pro
    Imagem
    Geração de imagens a partir de texto e edição de imagens em até 4K.
  • Nano Banana 2
    Imagem
    Geração de imagens a partir de texto e edição de imagens em até 4K, com embasamento opcional em resultados de pesquisa.
  • Nano Banana 2 Lite
    Imagem
    Geração de imagens a partir de texto e edição de imagens em 1K, com o menor custo.
  • Seedream 5 Pro
    Imagem
    Geração de imagens a partir de texto e edição de imagens em 1K ou 2K.
  • Seedream 5 Lite
    Imagem
    Geração de imagens a partir de texto e edição de imagens em 2K ou 4K.

Créditos e cobrança

  • Conectar, consultar o saldo, solicitar um orçamento e consultar o status das tarefas não consome créditos.
  • Os créditos são debitados somente quando uma geração é enviada, do mesmo saldo pessoal usado no site e na API.
  • Gerações com falha são reembolsadas automaticamente.
  • Quando a duração do vídeo está definida como automática, a duração máxima é reservada e os créditos não utilizados são reembolsados após a geração.
  • A assinatura do seu assistente de IA é cobrada separadamente dos créditos do Seedance 2.0 AI.

Perguntas frequentes

Quais aplicativos de IA podem usar a CLI do Seedance?

Qualquer aplicativo de IA que consiga executar comandos no seu computador. No terminal: Claude Code, Codex, Gemini CLI, OpenCode e Qwen Code. Em editores de código: Cursor, Windsurf, Trae e Kiro. Como extensões do editor: GitHub Copilot no modo Agent, Cline e Roo Code. Aplicativos de chat como Claude, ChatGPT e Gemini na web ou no aplicativo para celular não conseguem executar comandos; com eles, use o MCP. A CLI requer Node.js 22 ou posterior no macOS ou no Linux; no Windows, use o WSL.

Posso usar imagens ou vídeos salvos no meu computador?

Sim, em aplicativos de IA que rodam no seu computador, como Claude Code, Codex, Cursor e OpenCode: o aplicativo envia o arquivo por você antes de gerar. Aplicativos de chat como Claude, ChatGPT e Gemini não conseguem acessar arquivos do seu computador, então, com eles, os arquivos de referência precisam estar disponíveis em uma URL HTTPS pública. Envie o arquivo para um serviço que ofereça um link direto e inclua esse link na sua solicitação.

Quais créditos são usados?

Seu saldo pessoal de créditos, o mesmo usado no site e na API. Os créditos da equipe não são usados.