Yollomi CLI

Command-line interface for Yollomi AI image and video generation.

Install

# From repo (development)
pnpm yollomi --help

# Run without installing (when published to npm)
npx yollomi-cli image "a cat"

# Global install (then use: yollomi xx)
npm install -g yollomi-cli

Setup

Set YOLLOMI_API_KEY in your environment (required for image/video generation):

export YOLLOMI_API_KEY=your_api_key

Optional: YOLLOMI_BASE_URL to override API host (default: https://yollomi.com)

Commands

List models (no API key needed)

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

Generate image

yollomi image "a cute cat wearing a hat"
yollomi image "sunset over mountains" --model flux-2-pro --aspect 16:9
yollomi image "make it look like oil painting" --model flux-kontext-pro --image https://example.com/photo.jpg

Generate video

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

Unified generate (advanced)

yollomi generate --type image --model flux-schnell --prompt "a dog"
yollomi generate --type video --model kling-2-1 --prompt "a bird flying" --json

Options

| Option | Description | |--------|-------------| | -m, --model <id> | Model ID (default: flux-schnell for image, google-veo-3-fast for video) | | -a, --aspect <ratio> | Aspect ratio (1:1, 16:9, 9:16, etc.) | | -i, --image <url> | Reference image URL (for img2img, i2v, remove-bg) | | -n, --num <n> | Number of images (1-4, image only) | | -d, --duration <sec> | Video duration in seconds | | --json | Output raw JSON (generate command) |