CLI

Seedance CLI: crea video e immagini dal terminale e dalle app di IA

La CLI di Seedance funziona nel terminale e nelle app di IA che eseguono comandi, come Claude Code, Codex, Cursor e OpenCode. Usa gli stessi crediti agli stessi prezzi del sito e può usare file del tuo computer come riferimento.

Per chi usa app di IA sul computer, come Claude Code, Codex, Cursor e OpenCode. Se usi Claude o ChatGPT sul web o nell’app mobile, usa MCP. Scopri come usare MCP

Come funziona

  1. 1

    Invia l’istruzione alla tua app di IA

    Incolla l’istruzione qui sotto in Claude Code, Codex, Cursor, OpenCode o in un’altra app di IA che esegue comandi. L’app installa la CLI.

    Copia questa istruzione e inviala alla tua app di 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

    Accedi e autorizza

    L’app apre il browser. Accedi al tuo account Seedance 2.0 AI e consenti l’accesso.

  3. 3

    Di’ cosa vuoi creare

    Ad esempio: “Crea un video di 5 secondi di una barchetta di carta che scorre lungo una strada piovosa di notte” oppure “Crea un’immagine di un gatto rosso che guarda la pioggia”. L’app ti indica prima il costo in crediti, poi genera (se il costo è elevato ti chiede prima conferma) e salva il video o l’immagine nella cartella in cui lavora (o dove preferisci). Ogni generazione compare anche nella tua cronologia sul sito.

Guardalo in azione

Lo chiedi in una frase e la tua app di IA esegue i comandi. L’output proviene da un’esecuzione reale; l’attesa qui è abbreviata e questa generazione ha richiesto circa due minuti.

result.mp4
result.mp4: il video prodotto da questi comandi.

Configurala tu

  1. 1

    Installare la CLI

    Installa la CLI con il primo comando. Richiede Node.js 22 o versioni successive su macOS o Linux; su Windows usa WSL.

    npm install -g @seedance2ai/cli
  2. 2

    Accedere e autorizzare nel browser

    Esegui il secondo comando, poi accedi e consenti l’accesso nella finestra del browser che si apre.

    seedance2 auth login
  3. 3

    Controllare il saldo crediti

    Controlla il saldo dei crediti con il terzo comando.

    seedance2 account

Genera

Una volta configurata, basta dire all’app di IA cosa vuoi generare. Per generare manualmente, segui questi passaggi:

  1. 1

    Scrivere la richiesta

    Crea un file chiamato request.json con il modello e i suoi campi, come nell’esempio qui sotto. I campi immagine e video accettano anche file del tuo computer.

    request.json

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

    Controllare il prezzo

    Esegui questo comando per vedere il costo in crediti. Il controllo del prezzo è gratuito.

    seedance2 estimate --input request.json
  3. 3

    Avviare la generazione

    Sostituisci CREDITS con quel prezzo; una generazione più costosa non viene inviata. Il comando attende il risultato e restituisce l’ID dell’attività.

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

    Scaricare il risultato

    Sostituisci TASK_ID con l’ID dell’attività del passaggio precedente.

    seedance2 download TASK_ID --output result.mp4

Esegui seedance2 --help per vedere tutti i comandi.

Modelli disponibili

Ogni modello offre le stesse opzioni del sito web e dell’API.

  • Seedance 2.5
    Video
    Da testo, immagine o media di riferimento a video; da 4 a 30 secondi, fino a 2K, con audio. Richiede un acquisto precedente.
  • Seedance 2.0
    Video
    Da testo, immagine o media di riferimento a video; da 4 a 15 secondi, nei livelli di qualità Mini, Fast e Pro.
  • Kling 4.0
    Video
    Da testo, media di riferimento o fotogrammi chiave a video; da 3 a 30 secondi, in 720p o 1080p.
  • GPT Image 2.5
    Immagine
    Generazione di immagini da testo e modifica delle immagini.
  • GPT Image 2
    Immagine
    Generazione di immagini da testo e modifica delle immagini, con fino a quattro immagini per richiesta.
  • Nano Banana Pro
    Immagine
    Generazione di immagini da testo e modifica delle immagini fino a 4K.
  • Nano Banana 2
    Immagine
    Generazione di immagini da testo e modifica delle immagini fino a 4K, con la possibilità di basarsi sui risultati di ricerca.
  • Nano Banana 2 Lite
    Immagine
    Generazione di immagini da testo e modifica delle immagini in 1K, al costo più basso.
  • Seedream 5 Pro
    Immagine
    Generazione di immagini da testo e modifica delle immagini in 1K o 2K.
  • Seedream 5 Lite
    Immagine
    Generazione di immagini da testo e modifica delle immagini in 2K o 4K.

Crediti e fatturazione

  • Connettersi, controllare il saldo, richiedere un preventivo e verificare lo stato delle attività non consuma crediti.
  • I crediti vengono addebitati solo all’invio di una generazione, sullo stesso saldo personale utilizzato sul sito web e nell’API.
  • Le generazioni non riuscite vengono rimborsate automaticamente.
  • Quando la durata del video è impostata su automatica, viene riservata la durata massima e i crediti non utilizzati vengono rimborsati dopo la generazione.
  • L’abbonamento al tuo assistente IA viene fatturato separatamente dai crediti di Seedance 2.0 AI.

Domande frequenti

Quali app di IA possono usare la CLI di Seedance?

Qualsiasi app di IA in grado di eseguire comandi sul tuo computer. Nel terminale: Claude Code, Codex, Gemini CLI, OpenCode e Qwen Code. Negli editor di codice: Cursor, Windsurf, Trae e Kiro. Come estensioni dell’editor: GitHub Copilot in modalità Agent, Cline e Roo Code. Le app di chat come Claude, ChatGPT e Gemini sul web o nell’app mobile non possono eseguire comandi; con queste usa MCP. La CLI richiede Node.js 22 o versioni successive su macOS o Linux; su Windows usa WSL.

Posso usare immagini o video salvati sul mio computer?

Sì, nelle app di IA che vengono eseguite sul tuo computer, come Claude Code, Codex, Cursor e OpenCode: l’app carica il file al posto tuo prima della generazione. Le app di chat come Claude, ChatGPT e Gemini non possono accedere ai file del tuo computer, quindi con queste i file di riferimento devono essere accessibili tramite un URL HTTPS pubblico. Carica il file su un servizio che fornisca un link diretto e includi tale link nella richiesta.

Quali crediti vengono utilizzati?

Il tuo saldo personale di crediti, lo stesso utilizzato sul sito web e nell’API. I crediti del team non vengono utilizzati.