CLI

First in Industry

Yollomi is the first comprehensive AI media platform with native CLI support. Generate images and videos directly from your terminal — no browser, no API calls to write.

Why CLI matters

Script your creative workflow. Chain Yollomi with other tools. Integrate into CI/CD, automation, or AI agents. One command, one result — yollomi image "a cat".

Install

Install globally to use yollomi from anywhere

npm (recommended)

npm install -g yollomi-cli

# If using Bytedance internal registry, use public npm:
npm install -g yollomi-cli --registry https://registry.npmjs.org/

Run without installing

npx yollomi-cli image "a cute cat"

Setup

Set your API key. Create one inDashboard → API Keys.

export YOLLOMI_API_KEY=your_api_key

# Optional: override API host (default: https://yollomi.com)
export YOLLOMI_BASE_URL=https://yollomi.com

Commands

All image and video models, one CLI

List models (no API key needed)

yollomi models
yollomi models --type image
yollomi models --type video

Generate image

yollomi image "a magical forest with glowing mushrooms"
yollomi image "sunset over mountains" --model flux-2-pro --aspect 16:9
yollomi image "make it oil painting style" --model flux-kontext-pro --image https://example.com/photo.jpg

Generate video

yollomi video "a cat walking in the rain"
yollomi video "ocean waves at sunset" --model google-veo-3-fast
yollomi video "animate this scene" --model wan-2-5-i2v --image https://example.com/frame.jpg

Options

Option	Description
`-m, --model`	Model ID (default: flux-schnell / google-veo-3-fast)
`-a, --aspect`	Aspect ratio (1:1, 16:9, 9:16)
`-i, --image`	Reference image URL (img2img, i2v, remove-bg)
`-n, --num`	Number of images (1-4)
`-d, --duration`	Video duration in seconds

Output

URLs are printed to stdout for piping or scripting

$ yollomi image "a cat"
Generating…
https://r2.yollomi.com/v1/flux-schnell/...
Remaining credits: 98