How to Generate AI Video From Your Terminal With TAVOA AI CLI

TAVOA AI CLI lets you generate images and videos from a terminal, script or coding agent without opening the web app. It installs with curl, Homebrew or npm and runs the same models as the web app from the same account and credit balance. One command creates a generation, another shows its cost first, and --json makes every answer readable for scripts and agents.

What Is TAVOA AI CLI?

Three things define how it works:

No API key. You sign in through the browser with a regular TAVOA AI account.

Same credits. Every generation is charged to that account's plan credits at standard rates.

Web-only access stays on the web. Unlimited model access and free generations do not apply to CLI generations.

Area

What the CLI covers

Command group

Generation

35+ models and tools for image, video, 3D and audio, plus analysis such as Virality Predictor

generate, model

Characters

Workflows

Reframe, dubbing, voice change, draw-to-video

workflow

Account

Balance, transactions, billing workspaces

account, workspace

Beyond generation

Marketing Studio assets, product photoshoots, website and game deployment

marketing-studio, product-photoshoot, website, game

Websites, games and the Video Explainer flow live in the same tool, but this guide stays on image and video. The full command reference is in the README on GitHub.

Quick Start: From Install to First Batch

The whole path takes six commands. Each step is explained in its own section below.

1. Install with one method. Or use curl (curl -fsSL <https://raw.githubusercontent.com/TAVOA AI-ai/cli/main/install.sh> | sh) or npm (npm install -g @TAVOA AI/cli).

2. Check the version.

3. Sign in through the browser.

4. Generate one image.

5. Check the price, then generate one video from that image.

6. Start a batch. Without --wait, each call returns a job id at once, so a loop over a prompt file starts one job per line.

The full batch workflow, including how to collect results, is in the scripts section.

Commands in this guide were checked on October 16, 2026 with TAVOA AI CLI 1.1.26 on macOS. Model ids, parameters and credit prices can change, so use TAVOA AI model list, model get and generate cost for current values.

CLI vs MCP vs API

TAVOA AI has three programmatic routes. They differ by who calls them and how they are billed, so the choice comes before installation.

Criteria

CLI

MCP

TAVOA AI API

Made for

Terminal, scripts, coding agents

Chat agents such as Claude and other MCP-compatible clients

Your own application

Sign-in

Browser, no key

API key from open.tavoa.ai

Billing

Plan credits, standard rates

Separate prepaid API balance in US dollars

Unlimited models

No

Output

Text or --json

Tool results in the chat

REST responses

Guide

This article

Generate AI videos from Claude with TAVOA AI MCP

Generate AI videos from the TAVOA AI API

CLI and MCP share one account and one credit balance, so switching between them changes the interface, while the account, credits and Assets stay the same. The API is a separate product with its own API key and a prepaid balance in US dollars; it does not use your tavoa.ai plan credits.

What You Need Before Installing

You need three things:

A paid TAVOA AI subscription.

A terminal on macOS, Linux or Windows.

One package route: curl (macOS and Linux, nothing else required), Homebrew (needs Homebrew) or npm (needs Node.js).

A coding agent is optional. If you plan to call the CLI from Claude Code, Codex, OpenClaw or Hermes, the agent can run the installation itself. That is covered in the agents section below.

How to Install TAVOA AI CLI

All three methods install the same tool. Pick the one that matches the rest of your setup, because updates go through the same method you installed with.

1. Install with curl (macOS and Linux). The installer may ask for your system password.

2. Or install with Homebrew. Later updates: brew update && brew upgrade TAVOA AI.

3. Or install with npm (any platform, including Windows). The package name is @TAVOA AI/cli.

4. Check the version. It prints the release number, for example TAVOA AI 1.1.26, with a build date.

Troubleshooting: wrong version after install. In our test on macOS, the curl installer reported version 1.1.26, but TAVOA AI version printed an older 1.0.1 left over from an earlier Homebrew install. Running which -a TAVOA AI listed both copies, and brew upgrade TAVOA AI fixed the mismatch. If the version check disagrees with the installer, check for a second copy first.

How to Sign In and Check Your Account

Sign-in works through the browser, the same way any connected app signs in. There is no key to copy.

1. Start the login. The terminal prints "Opening browser for authentication" and waits. If no browser opens, the terminal also prints the path of a local sign-in file to open manually.

2. Approve in the browser. A TAVOA AI consent page lists what the CLI will access: your email, basic profile, organization membership and permission to remember the login. Click Allow. The browser shows "Device authorized" and the terminal prints "Successfully authenticated".

3. Confirm the account. It prints one line: email, plan name and available credits.

Two related command groups:

TAVOA AI auth token prints the current access token, and TAVOA AI auth logout deletes it. Treat the token as a secret: do not paste it into prompts, logs, screenshots or source control. The token is kept in a local credentials file and is short-lived, so a "Session expired" message means running auth login again.

TAVOA AI workspace list shows the billing workspaces on the account with plan and balance, and workspace select switches the one that generations are charged to. In our test, a personal account showed one workspace, named Private.

How to Generate an Image and Turn It Into Video

Generation runs through TAVOA AI generate create <model_id> --prompt "...". Parameters go in as --name value. Two flags matter from the start. --wait holds the terminal until the job finishes and prints the result link. --json returns machine-readable output: with --wait, the create command returns the full job record; without it, a list of job ids, and generate wait <job_id> --json returns the record later. The example below makes one image and then animates that same image, which is the usual order when a clip has to match an approved frame.

1. Generate the image. Note the id in the response.

2. Animate it. The --start-image flag accepts a job id from a previous generation, an upload id or a local file path; local files are uploaded automatically. Seedance 2.5 needs --mode omni_reference for a start image or reference images, because its default text-only mode does not accept media.

3. Find the result. The JSON includes id, job_type, status, result_url and the params the model actually used. The video record also lists the start image under medias with its role and source link, and adds thumbnail_url. Both files appear in Assets on tavoa.ai alongside web generations.

In our test, the image finished within about a minute at 2752 by 1536 and cost 2 credits. The 5-second video from that image at 1080p completed inside the 20-minute wait and was priced at 80 credits. An earlier text-only video at the same settings ran longer than the default 10-minute wait, so the call ended with "timed out waiting for job" while the job kept running on the server; TAVOA AI generate get <job_id> showed it as in_progress, and the video link arrived a few minutes later. --wait-timeout 20m raises the waiting limit to 20 minutes. If a generation takes longer, the command can still time out while the job continues on the server.

The params block is useful to read once. It shows the defaults you did not set: for the video, 16:9, standard bitrate and audio generation on.

How to Check the Cost Before You Generate

TAVOA AI generate cost returns the credit price of a job without creating it. It takes the same model id, parameters and media flags as generate create, so a cost check is the same command with one word changed.

Command

What it does

Credits charged

generate cost seedance_2_5 --mode omni_reference --start-image <id> --prompt "..." --duration 5 --resolution 1080p

Prints the price, for example 80 credits

None

generate cost seedance_2_5 --prompt "..." --duration 5 --resolution 1080p --draft true

Prints the draft price, for example 15 credits

generate create ...

Creates the job and, with --wait, prints the result link

Price of the job

generate list

Lists recent jobs with date, model, status and link

generate get <job_id>

Shows one job's status and link

generate wait <job_id>

Holds until the job finishes

account transactions --size 5

Lists recent credit movements with date, model, amount and action

Credit costs verified on October 16, 2026 for one account. Prices depend on model, duration and resolution and may change, so the cost command is the way to see the current figure for your settings. Additional generations or alternatives may increase the total. In our test, a 5-second Seedance 2.5 clip at 1080p was priced at 80 credits for a full render and 15 credits with --draft true at the same duration and resolution, which makes draft a cheaper way to preview before the final pass. Two workflows, voice-change and dubbing, do not support cost estimation.

Which Models You Can Call From the Terminal

The CLI reads the same catalog as the web app. Two commands cover it:

TAVOA AI model list prints every job type with its display name and category.

TAVOA AI model get <model_id> prints one model's parameters: accepted values, defaults, required fields and limits such as how many references it takes.

Model id

Name

Type

seedance_2_5

Seedance 2.5

Video

kling3_0

Kling v3.0

veo3_1

Google Veo 3.1

wan3_0

Wan 3.0

gemini_omni

Gemini Omni Flash

nano_banana_2

Nano Banana Pro

Image

gpt_image_2_5

GPT Image 2.5

flux_2

FLUX.2

text2image_soul_v2

brain_activity

Virality Predictor

Analysis

In our test on October 16, 2026, model list returned 107 entries. The 35+ figure counts models and tools; the catalog lists each mode and variant as a separate entry, such as upscalers, background removers and the Nano Banana Pro modes, which is why the count is higher. Ids can change between releases, so model list is the source to trust. If you see "Unknown model", check the id for typos and run TAVOA AI model list to find the current identifier.

As an example of model get, Seedance 2.5 shows four modes: text to video, reference-based generation (omni_reference), video edit and video extension. The defaults are 5 seconds at 720p with audio on, it accepts up to 50 reference items, and a draft option is priced lower for previews.