CLI Commands

Complete reference for all videotoolbox-cli commands.

Auth Commands

auth login

Login with email and password to get a session token.

videotoolbox-cli auth login --email <email> --password <password>

auth apikey create

Create a long-lived API key (valid 1 year by default).

videotoolbox-cli auth apikey create --name <name> [--expires-in <seconds>] [--prefix <prefix>]

Option	Default	Description
--name	cli	Key name for identification
--expires-in	31536000	Expiration in seconds (1 year)
--prefix	vtb	Key prefix

auth apikey list

List all your API keys.

videotoolbox-cli auth apikey list [--json] [--format csv|yaml]

auth apikey revoke

Revoke an API key permanently.

videotoolbox-cli auth apikey revoke --id <key-id>

auth set

Manually set a token (session token or API key).

videotoolbox-cli auth set <token>

auth show

Display current authentication status.

videotoolbox-cli auth show [--raw]

auth logout

Remove all saved credentials.

videotoolbox-cli auth logout

Organization Commands

org set

Set the active organization for subsequent commands.

videotoolbox-cli org set <slug>

org show

Display the current active organization.

videotoolbox-cli org show

Project Commands

projects list

List all video projects in the active organization.

videotoolbox-cli projects list [--json]

projects create

Create a new video project.

videotoolbox-cli projects create --title <title> [--description <desc>] [--youtube-url <url>]

Thumbnail Commands

thumbnails generate

Generate AI thumbnail variations.

videotoolbox-cli thumbnails generate \
  --project-id <id> \
  --prompt "A dramatic thumbnail with bold text" \
  [--variations 2] \
  [--model all|openai|gemini|nano-banana-2] \
  [--assets id1,id2] \
  [--inspirations id1,id2]

Option	Default	Description
--project-id	required	Thumbnail project ID
--prompt	required	Generation prompt (max 2000 chars)
--variations	2	Number of variations (1-4)
--model	all	AI model to use
--assets		Comma-separated global asset IDs
--inspirations		Comma-separated inspiration IDs

Script Commands

scripts generate

Generate an AI video script.

videotoolbox-cli scripts generate \
  --script-id <id> \
  --topic "How to edit videos" \
  --duration "10 minutes" \
  --tone educational \
  --video-type tutorial \
  [--model gpt-5.2|claude-opus-4-6|gemini-2.5-pro] \
  [--channel-identity "Tech reviewer"]

Option	Default	Description
--script-id	required	Script project ID
--topic	required	Script topic
--duration	required	Video duration
--tone	required	Script tone
--video-type	required	Type of video
--model	gpt-5.2	AI model (costs vary)

Credit costs per model:

• gemini-2.5-pro: 1 credit
• gpt-5.2: 2 credits
• claude-opus-4-6: 4 credits

Inspiration Commands

inspirations list

List saved YouTube inspiration thumbnails.

videotoolbox-cli inspirations list [--json]

inspirations add

Save a YouTube video thumbnail as inspiration.

videotoolbox-cli inspirations add --youtube-url "https://youtube.com/watch?v=xxx"

Credit Commands

credits balance

Show current credit balance.

videotoolbox-cli credits balance

credits transactions

List credit transaction history.

videotoolbox-cli credits transactions [--json]

Admin Commands

Admin commands require a user with the admin role.

admin credits add

Add bonus credits to an organization.

videotoolbox-cli admin credits add --org <slug> --amount <n> [--description <text>]

admin coupons create

Create a Stripe discount coupon with promo code.

videotoolbox-cli admin coupons create \
  --name "Summer Sale" \
  --percent-off 20 \
  [--duration once|repeating|forever] \
  [--max-redemptions 100]

admin coupons list

List all coupons and promotion codes.

videotoolbox-cli admin coupons list [--json]

admin organizations list

List all organizations.

videotoolbox-cli admin organizations list [--json]

admin users list

List all registered users.

videotoolbox-cli admin users list [--json]