OpenAI выпустила официальный CLI для своего API

OpenAI опубликовала официальный клиент командной строки для своего REST API. Утилита написана на Go (требуется версия 1.26 или новее) и устанавливается через Homebrew или командой go install. Исходники доступны на GitHub под лицензией Apache 2.0.

Как устроены команды

Интерфейс построен вокруг ресурсов: вызов выглядит как openai <ресурс> [подресурс...] <команда> [флаги]. Например, openai responses create --input "Say this is a test" --model gpt-5.5 обращается к обычному эндпоинту и требует ключа OPENAI_API_KEY. Административные запросы — скажем, статистика использования организации — работают через отдельный ключ OPENAI_ADMIN_KEY. Справка (--help или openai help COMMAND) открывается без ключа и без сети, а запуск openai без аргументов показывает группы команд по задачам.

Изображения и файлы

Команда openai images generate сохраняет результат в ~/Downloads/gpt-images/ и по умолчанию использует модель gpt-image-2.5-sunburst. Есть предпросмотр ранее сохранённых изображений без обращения к API и режим встроенного показа прямо в терминале. Файлы можно загружать, читать метаданные и скачивать обратно; для подстановки содержимого файла в JSON предусмотрен синтаксис @file:// и @data://.

Внимание к безопасности

Заметная часть документации посвящена защите данных. Значения заголовков и секретов скрываются в справке и затираются в отладочных логах; для передачи учётных данных рекомендуется переменная OPENAI_CUSTOM_HEADERS, а не аргументы командной строки, чтобы секреты не попадали в историю оболочки. Отдельный режим OPENAI_UNTRUSTED_STDIN=1 трактует данные из недоверенного потока как литералы и запрещает им читать локальные файлы. Пользовательский бэкенд через --base-url обязан работать по HTTPS (исключение — localhost), а HTTPS-прокси отклоняются, чтобы клиентский сертификат не предъявлялся при рукопожатии прокси. Взаимный TLS пока в стадии бета-программы.

Обновления без автоматики

Клиент сам проверяет наличие новых стабильных релизов, но делает это деликатно: не чаще раза в семь дней, без API-ключа, с таймаутом в 200 миллисекунд и только когда ввод-вывод подключён к терминалу. Автоматически ничего не ставится, а отключить проверки можно переменной OPENAI_CLI_NO_UPDATE_CHECK=1. Принимать правки от сторонних участников проект не готов: pull-запросы открыты только для коллабораторов репозитория.

Источник: Hacker News