Официалният CLI на OpenAI: автоматизации с една команда

Накратко

OpenAI има официален команден инструмент за API-то си с отворен код (Apache 2.0), който стигна до Hacker News на 22 октомври
Една команда вика текст, изображения, реч, файлове и пакетни задачи, а броенето на токени работи локално и без пари
Автоматизирането на една ръчна дневна проверка и един скрипт от фрийлансър важи около €735 за първата година (мои допускания)

Не ти трябват приложение, no-code инструмент или разработчик, за да извикаш API-то на OpenAI. Ти трябва една команда. OpenAI публикува официален CLI: малка програма, която пускаш в терминал. Старият начин беше фрийлансър, който пише скрипт, или човек, който всяка сутрин клика по таблото. Новият е един ред, който слагаш в cron задача.

Какво е този инструмент

`openai` CLI е официалният команден инструмент за API-то на OpenAI. Написан е на Go, с отворен код под лиценз Apache 2.0, и не е Codex CLI, агентът за кодиране. Вика ендпойнтите директно, така че ползваш API-то от терминал или скрипт, без да строиш приложение.

Какво покрива:

Responses: текст, структуриран изход, търсене в уеб и файлови входове
Изображения: генериране и редакция
Аудио: генериране на реч и транскрипция
Файлове и пакети: качване, сваляне, подаване и изчакване на пакетни задачи
Тест на webhook-ове и локално броене на токени
Админ ендпойнти: проекти, служебни акаунти и използване, с отделен админ ключ

Изходът може да е обикновен текст, JSON, JSONL или YAML, така че лесно го предаваш на други скриптове.

Колко струва? Самият инструмент е безплатен. Използването на API-то се тарифира по обичайните цени на OpenAI, а страниците на CLI не показват цени, така че провери страницата с цени, преди да планираш голяма задача.

Настройка за 10 минути

Не съм пускал всяка команда от по-долу с жив акаунт. Името на модела в примерите може да не съвпада с това, което предлага твоят акаунт, така че първо изпълни `openai models list`.

Инсталирай го. На macOS или Linux с Homebrew:

brew install openai/tools/openai

Или свали готов бинарен файл за macOS, Linux или Windows от GitHub Releases. Или, с актуална версия на Go (README иска 1.26 или по-нова):

go install 'github.com/openai/openai-cli/cmd/openai@latest'

Ако си ползвал стария Python SDK, неговата стара команда `openai` може да вземе предимство в терминала. Провери коя се пуска.

Задай ключа си.

export OPENAI_API_KEY="sk-..."
openai help setup

Направи първата заявка.

openai responses create --model gpt-5.5 --input "Say this is a test"

Чети промпт от файл. Префиксът `@` зарежда съдържанието на файла.

openai responses create --model gpt-5.5 --input @prompt.txt

Вземи изход за машини. Добави `–format json` или `–format jsonl`, когато резултатът ще го чете друг скрипт.
Преброй токените преди голяма задача. Това работи локално, без мрежова заявка и без разход за API.

openai tokens count --model gpt-5.5 "your text here"

Генерирай изображение. CLI декодира резултата и записва PNG за теб.

openai images generate --prompt "A tiny orange robot"

Извади дневен доклад за използването. Тук се иска админ ключ. Редът по-долу е илюстрация: маркерите за време са примерни, а истинската задача ще смята вчерашния интервал в малък скрипт.

0 6 * * * OPENAI_ADMIN_KEY="$ADMIN_KEY" openai admin organization usage completions --start-time 1735689600 --end-time 1735776000 --bucket-width 1d --format json >> /var/log/openai-usage.jsonl

Държи админ ключа само в задачата, която го изисква, а не на всеки лаптоп.

Реални случаи

Пакетни задачи. Качи JSONL файл и създай пакет с 24-часов прозорец за изпълнение. Подходящо за масови описания, преводи и тагове.
Планирани доклади. Дневната проверка за използване отгоре, записана в лог файл, който четеш или графикираш.
Бързи тестове. Опитай промпт в един ред, преди да вградиш същата стъпка в Make или n8n.
Прости автоматизации. Всичко, което един shell скрипт може да задейства, вече вика API-то с един ред.

Как бих го ползвал в GiantParts: чернови на описания на продукти от CSV в пакетна задача, с предварително броене на токените, за да няма изненада в сметката. Това е план, не резултат.

Сметката: това са мои допускания. Фрийлансър пише малък скрипт: 3 часа по €25 са €75, веднъж. Някой проверява ръчно използването на API 10 минути на ден, 22 работни дни на месец: 220 минути, около 3,7 часа, по €15 на час са около €55 на месец, или €660 на година. С CLI и cron задача ръчната проверка изчезва. Първа година: €75 плюс €660 са €735 спестени. Инструментът струва €0, а използването на API са пари, които ще харчиш така или така.

Ограничения и слаби места

Липсващи функции. Още няма отчитане на разхода по команда, конфиг файлове на ниво проект и автоматизация на процеси.
Версия на Go. Пътят с `go install` иска актуална версия на Go.
Мрежова настройка. Mutual TLS е в бета и иска записване. HTTPS проксита са отхвърлени. Произволен base URL трябва да е HTTPS, само localhost може без.
Ненадежден вход. Ако предаваш текст, който не контролираш, включи режима за ненадежден stdin (`OPENAI_UNTRUSTED_STDIN=1`), за да се блокира четенето на локални файлове от предадени данни.
Умения с терминал. Това е за хора, които са си леко в терминала. Ако не си, започни с Make или n8n.

Алтернативи

curl: работи навсякъде, но пишеш повече.
Официалните Python и JavaScript SDK: правилният избор, когато строиш истинско приложение.
Make или n8n: no-code процеси, когато предпочиташ да кликаш, вместо да пишеш.

Какво означава това

Моето четене: стабилен команден инструмент е чист начин за скриптове и AI агенти да викат API-то, защото агентите вече могат да пускат shell команди. OpenAI прави API-то лесно за ползване отвсякъде. Anthropic и Google ще трябва да отговорят със същото, или ще загубят хората, които живеят в терминала.

Мнението на Иван

Харесвам малки инструменти, които махат ежедневна рутина. Този маха ръчната проверка на използването и дава скриптов начин за пакетни задачи. Безплатен е, така че тестът струва само един час. Ще го инсталирам днес, ще пусна брояча на токени и една пакетна задача и али тогава ще реша, дали заслужава място в стека ми.

Източник: OpenAI

За автора

Ivan Ivanov

Основател на