CLI

Seedance CLI: crea vídeos e imágenes desde la terminal y aplicaciones de IA

La CLI de Seedance funciona en tu terminal y en aplicaciones de IA que ejecutan comandos, como Claude Code, Codex, Cursor y OpenCode. Usa los mismos créditos a los mismos precios que el sitio web y puede usar archivos de tu ordenador como referencia.

Para quienes usan aplicaciones de IA en su ordenador, como Claude Code, Codex, Cursor y OpenCode. Si usas Claude o ChatGPT en la web o en la aplicación móvil, usa MCP. Ver cómo usar MCP

Cómo funciona

  1. 1

    Envía la instrucción a tu aplicación de IA

    Pega la siguiente instrucción en Claude Code, Codex, Cursor, OpenCode u otra aplicación de IA que ejecute comandos. La aplicación instala la CLI.

    Copia esta instrucción y envíala a tu aplicación 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

    Inicia sesión y autoriza

    La aplicación abre tu navegador. Inicia sesión en tu cuenta de Seedance 2.0 AI y permite el acceso.

  3. 3

    Di lo que quieres crear

    Por ejemplo: «Haz un vídeo de 5 segundos de un barco de papel que flota por una calle lluviosa de noche» o «Crea una imagen de un gato naranja mirando la lluvia». La aplicación te indica primero el coste en créditos, genera (si es caro, te pregunta antes) y guarda el vídeo o la imagen en la carpeta en la que trabaja (o donde le indiques). Cada generación aparece también en tu historial del sitio web.

Míralo en funcionamiento

Lo pides en una frase y tu aplicación de IA ejecuta los comandos. La salida procede de una ejecución real; la espera se ha acortado aquí y esta generación tardó unos dos minutos.

result.mp4
result.mp4: el vídeo que generaron estos comandos.

Configúrala tú mismo

  1. 1

    Instalar la CLI

    Instala la CLI con el primer comando. Necesita Node.js 22 o posterior en macOS o Linux; en Windows, usa WSL.

    npm install -g @seedance2ai/cli
  2. 2

    Iniciar sesión y autorizar en el navegador

    Ejecuta el segundo comando y luego inicia sesión y permite el acceso en la ventana del navegador que se abre.

    seedance2 auth login
  3. 3

    Consultar el saldo de créditos

    Consulta tu saldo de créditos con el tercer comando.

    seedance2 account

Generar

Una vez configurada, solo tienes que decirle a la aplicación de IA lo que quieres generar. Para generar manualmente, sigue estos pasos:

  1. 1

    Escribir la solicitud

    Crea un archivo llamado request.json con el modelo y sus campos, como en el ejemplo de abajo. Los campos de imagen y vídeo también aceptan archivos de tu ordenador.

    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 el precio

    Ejecuta este comando para ver el coste en créditos. Consultar el precio es gratis.

    seedance2 estimate --input request.json
  3. 3

    Iniciar la generación

    Sustituye CREDITS por ese precio; una generación que cueste más no se envía. El comando espera el resultado y devuelve el ID de tarea.

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

    Descargar el resultado

    Sustituye TASK_ID por el ID de tarea del paso anterior.

    seedance2 download TASK_ID --output result.mp4

Ejecuta seedance2 --help para ver todos los comandos.

Modelos disponibles

Cada modelo ofrece las mismas opciones que en el sitio web y en la API.

  • Seedance 2.5
    Vídeo
    Texto, imagen o material de referencia a vídeo; de 4 a 30 segundos, hasta 2K, con sonido. Requiere una compra previa.
  • Seedance 2.0
    Vídeo
    Texto, imagen o material de referencia a vídeo; de 4 a 15 segundos, con los niveles de calidad Mini, Fast y Pro.
  • Kling 4.0
    Vídeo
    Texto, material de referencia o fotogramas clave a vídeo; de 3 a 30 segundos, en 720p o 1080p.
  • GPT Image 2.5
    Imagen
    Generación de imágenes a partir de texto y edición de imágenes.
  • GPT Image 2
    Imagen
    Generación de imágenes a partir de texto y edición de imágenes, con hasta cuatro imágenes por solicitud.
  • Nano Banana Pro
    Imagen
    Generación de imágenes a partir de texto y edición de imágenes en hasta 4K.
  • Nano Banana 2
    Imagen
    Generación de imágenes a partir de texto y edición de imágenes en hasta 4K, con apoyo opcional en resultados de búsqueda.
  • Nano Banana 2 Lite
    Imagen
    Generación de imágenes a partir de texto y edición de imágenes en 1K, con el coste más bajo.
  • Seedream 5 Pro
    Imagen
    Generación de imágenes a partir de texto y edición de imágenes en 1K o 2K.
  • Seedream 5 Lite
    Imagen
    Generación de imágenes a partir de texto y edición de imágenes en 2K o 4K.

Créditos y facturación

  • Conectarse, consultar el saldo, solicitar un presupuesto y consultar el estado de las tareas no consume créditos.
  • Los créditos solo se descuentan al enviar una generación, del mismo saldo personal que se utiliza en el sitio web y en la API.
  • Las generaciones fallidas se reembolsan automáticamente.
  • Si la duración del vídeo está configurada en modo automático, se reserva la duración máxima y los créditos no utilizados se reembolsan tras la generación.
  • La suscripción a tu asistente de IA se factura por separado de los créditos de Seedance 2.0 AI.

Preguntas frecuentes

¿Qué aplicaciones de IA pueden usar la CLI de Seedance?

Cualquier aplicación de IA que pueda ejecutar comandos en tu ordenador. En la terminal: Claude Code, Codex, Gemini CLI, OpenCode y Qwen Code. En editores de código: Cursor, Windsurf, Trae y Kiro. Como extensiones del editor: GitHub Copilot en modo Agent, Cline y Roo Code. Las aplicaciones de chat como Claude, ChatGPT y Gemini en la web o en la aplicación móvil no pueden ejecutar comandos; con ellas, usa MCP. La CLI requiere Node.js 22 o posterior en macOS o Linux; en Windows, usa WSL.

¿Puedo usar imágenes o vídeos guardados en mi ordenador?

Sí, en las aplicaciones de IA que se ejecutan en tu ordenador, como Claude Code, Codex, Cursor y OpenCode: la aplicación sube el archivo por ti antes de generar. Las aplicaciones de chat como Claude, ChatGPT y Gemini no pueden acceder a los archivos de tu ordenador, así que con ellas los archivos de referencia deben estar disponibles en una URL HTTPS pública. Sube el archivo a un servicio que ofrezca un enlace directo e incluye ese enlace en tu solicitud.

¿Qué créditos se utilizan?

Tu saldo personal de créditos, el mismo que se utiliza en el sitio web y en la API. No se utilizan los créditos del equipo.