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, чтобы вывести компактное описание протокола, которое агент может прочитать во время выполнения.
Сначала получите список моделей, затем выполните генерацию. Жёстко заданный идентификатор модели — наиболее распространённая причина неудачного запуска.
Восстановление после ошибок
Повторяйте попытку только после изменения запроса. Эти ошибки детерминированы, поэтому повторение идентичных аргументов тратит время, не меняя результата.