npm install -g @polza-ai/ai-cli
ai login
ai text "Объясни квантовые вычисления одним предложением"

Зачем

• Один инструмент для текста, картинок и видео — без жонглирования API
• 400+ моделей — GPT, Claude, Gemini, Flux, Kling, Sora и другие
• Стриминг — текст появляется по мере генерации
• Дружит с пайпами — работает со stdin, stdout, --json
• Динамические параметры — подтягиваются из API, кешируются локально, валидируются до отправки

Быстрый старт

# Установка
npm install -g @polza-ai/ai-cli

# Авторизация (откроется браузер, OAuth PKCE)
ai login

# Генерация текста
ai text "Напиши хайку про TypeScript"

# Генерация изображения
ai image "Киберпанк-кот хакает терминал" -o cat.png

# Генерация видео
ai video "Закат над океаном, кинематографично" --aspect-ratio 16:9

Команды

ai text

# Базовое использование
ai text "Переведи на японский: привет мир"

# С выбором модели и температуры
ai text "Напиши стихотворение" -m anthropic/claude-sonnet-4 --temperature 0.9

# Системный промпт
ai text "Проверь этот код" --system-prompt "Ты senior Go-разработчик"

# Пайп из stdin
cat error.log | ai text "Объясни эту ошибку и предложи исправление"
git diff | ai text "Напиши коммит-сообщение для этого диффа"

# JSON-вывод для скриптов
ai text "Перечисли 5 цветов" --json --no-stream

Опции:

| Флаг | Описание | |------|----------| | -m, --model | Модель (по умолчанию: google/gemini-3.1-flash-lite-preview) | | --temperature | Креативность 0–2 | | --max-tokens | Максимальная длина ответа | | --system-prompt | Системное сообщение | | --no-stream | Дождаться полного ответа | | --json | Машиночитаемый вывод |

ai image

# Базовое — aspect ratio и quality подставятся из дефолтов модели
ai image "Минималистичный логотип кофейни"

# С параметрами
ai image "Северное сияние" --aspect-ratio 3:2 --quality high -o aurora.png

# 4 картинки параллельно
ai image "Абстрактное искусство" -n 4 -p 4

# Любой параметр модели через --set
ai image "Пейзаж" -m black-forest-labs/flux.2-pro -s image_resolution=2K

# Посмотреть параметры модели
ai image --params
ai image --params -m black-forest-labs/flux.2-pro

Опции:

| Флаг | Описание | |------|----------| | -m, --model | Модель (по умолчанию: google/gemini-3.1-flash-image-preview) | | -o, --output | Путь для сохранения файла | | -n, --count | Количество изображений | | --aspect-ratio | Соотношение сторон (1:1, 16:9, ...) | | --quality | Качество | | --size | Размер (1024x1024, ...) | | -s, --set | Любой параметр модели (key=value) | | -p, --concurrency | Параллельная генерация | | --params | Показать доступные параметры модели | | --json | Машиночитаемый вывод |

ai video

# Базовое
ai video "Таймлапс распускающегося цветка"

# С параметрами
ai video "Погоня на машинах" -m kling/v3 --duration 10 --aspect-ratio 16:9

# Любой параметр
ai video "Танец" -m kling/v3 -s mode=pro -s sound=true

# Посмотреть параметры
ai video --params -m kling/v3

Опции:

| Флаг | Описание | |------|----------| | -m, --model | Модель (по умолчанию: google/veo3_fast) | | -o, --output | Путь для сохранения файла | | -n, --count | Количество видео | | --aspect-ratio | Соотношение сторон | | --duration | Длительность | | --resolution | Разрешение (480p, 720p, 1080p) | | -s, --set | Любой параметр модели (key=value) | | -p, --concurrency | Параллельная генерация | | --params | Показать доступные параметры модели | | --json | Машиночитаемый вывод |

ai models

# Все модели
ai models

# Фильтр по типу
ai models --type image
ai models --type video
ai models --type chat

# JSON для скриптов
ai models --type image --json

ai login / ai logout

# Вход — откроется браузер, OAuth PKCE, никаких секретов в терминале
ai login

# Выход — удаление токена
ai logout

Пайпы и скрипты

ai спроектирован для Unix-пайплайнов:

# Резюмировать файл
cat README.md | ai text "Сделай краткое саммари в 3 пунктах"

# Описать и сгенерировать
ai text "Опиши фэнтези-пейзаж" | ai image

# Цепочка с другими инструментами
ai text "Сгенерируй 10 тестовых email в виде JSON-массива" --no-stream --json | jq '.data.text'

# Пакетная генерация изображений из файла
while read prompt; do
  ai image "$prompt" -o "$(echo $prompt | tr ' ' '_').png"
done < prompts.txt

Динамические параметры моделей

У каждой модели свои параметры. Вместо угадывания ai подтягивает их из API и кеширует локально:

$ ai image --params -m openai/gpt-image-1.5
Параметры модели openai/gpt-image-1.5:
  aspect_ratio (обязательный) [1:1, 2:3, 3:2]
  images — URL изображений для редактирования (до 16 шт.)
  quality (обязательный) [medium, high] default: medium

$ ai video --params -m kling/v3
Параметры модели kling/v3:
  aspect_ratio [16:9, 9:16, 1:1] default: 1:1
  duration (обязательный) — Длительность видео 3-15 секунд
  mode (обязательный) [std, pro] default: std
  sound (обязательный) [true, false] default: false

• Дефолты подставляются автоматически — обязательные параметры с дефолтами просто работают
• Валидация до запроса — неверные значения ловятся локально, а не на стороне API
• Кеш на 1 час в ~/.ai-cli/models-cache.json
• Именованные флаги маппятся автоматически — --aspect-ratio 16:9 → aspect_ratio=16:9
• Запасной выход — -s key=value для любого параметра

JSON-режим

Каждая команда поддерживает --json для машиночитаемого вывода:

{
  "ok": true,
  "data": {
    "text": "TypeScript — это типизированное надмножество JavaScript.",
    "model": "openai/gpt-4o",
    "usage": { "prompt_tokens": 12, "completion_tokens": 15, "total_tokens": 27 }
  }
}

Ошибки тоже в едином формате:

{
  "ok": false,
  "error": { "code": "AUTH_ERROR", "message": "Неверный токен авторизации." }
}

Коды выхода

| Код | Значение | |-----|----------| | 0 | Успех | | 1 | Ошибка | | 2 | Частичный успех (часть генераций не удалась) |

Стоимость и баланс

После каждой генерации выводится стоимость и оставшийся баланс:

✔ Сгенерировано 1 изображений
✓ image-1234.png
  стоимость: 1.50 ₽ · баланс: 7741.98 ₽

Использование в AI-агентах

Файл SKILL.md описывает возможности CLI в формате, понятном AI-агентам (Claude Code, Cursor, Cline и др.). Агент может читать этот файл и использовать ai как инструмент для генерации контента.

Конфигурация

Конфиг хранится в ~/.ai-cli/config.json:

{
  "token": "pza_...",
  "userId": "...",
  "defaultModel": {
    "text": "anthropic/claude-sonnet-4",
    "image": "black-forest-labs/flux.2-pro",
    "video": "kling/v3"
  },
  "apiBaseUrl": "https://polza.ai/api/v1"
}

Укажите модели по умолчанию, чтобы не писать -m каждый раз.

Доступные модели

331 текстовая модель — GPT-4o, GPT-5.5, Claude Sonnet/Opus, Gemini, Qwen, DeepSeek, Llama, Mistral и другие

19 моделей изображений — GPT Image, DALL-E, Flux, Seedream, YandexArt, Grok Imagine, Qwen Image

15 моделей видео — Sora, Kling, Veo, Seedance, Wan

Полный список: polza.ai/models или ai models

Требования

• Node.js ≥ 20
• Аккаунт на Polza AI

Лицензия

MIT