Skip to main content
Flatkey CLI обеспечивает генерацию медиаконтента в вашем терминале с единым балансом. Каждая команда принимает --json, что делает её безопасной для вызова из скрипта, задания CI или ИИ-агента, который разбирает stdout.

Установка и аутентификация

Требуется Node.js версии 18 или новее. Для CI установите переменную окружения вместо входа в систему:
Проверьте, что использует CLI:

Сгенерируйте первый файл

Всегда передавайте --model. Встроенная модель изображений по умолчанию в настоящее время недоступна для маршрутизации и возвращает No available channel.

Команды

Глобальные параметры

Размещайте -o перед --json. Краткая форма отклоняется как неожиданный аргумент, если она стоит после --json. --output работает в любой позиции.

Параметры видео

--ratio принимает значения 16:9, 9:16, 4:3, 3:4, 21:9 и 1:1. --resolution принимает значения 480p, 720p и 1080p, однако каждая модель поддерживает лишь часть этого диапазона — см. Генерация видео.

Параметры аудио

Запустите flatkey audio voices --json и передайте указанный voice_id в --voice-id.

Управление с помощью агента

В режиме --json stdout содержит ровно один JSON-объект, а stderr — JSON-ошибку. Запустите flatkey help --ai, чтобы вывести компактное описание протокола, которое агент может прочитать во время выполнения.
Сначала получите список моделей, затем выполните генерацию. Жёстко заданный идентификатор модели — наиболее распространённая причина неудачного запуска.

Восстановление после ошибок

Повторяйте попытку только после изменения запроса. Эти ошибки детерминированы, поэтому повторение идентичных аргументов тратит время, не меняя результата.