开源工具2 分钟读完Hacker News
OpenAI 发布官方命令行工具,终端直连 REST API
速览
OpenAI 推出官方命令行工具 openai-cli,用户可在终端直接调用其 REST API。该工具支持生成图片、上传文件、提交批量请求等操作,无需编写应用程序。开发者可将 API 操作写入脚本,实现自动化工作流。
OpenAI CLI 与 Codex CLI 的定位不同:前者用于调用特定 API 或将其集成到脚本中,后者则作为编码代理,帮助读取和修改代码、运行命令。用户需使用 API key 进行认证,支持通过环境变量或密钥管理器设置 OPENAI_API_KEY。
安装方式有三种:
- 从 GitHub Releases 下载预编译二进制文件(支持 macOS、Linux、Windows)
- 通过 Homebrew 安装(brew install openai/tools/openai)
- 使用 Go 1.26+ 编译安装(go install github.com/openai/openai-cli/cmd/openai@latest)
命令结构遵循 API 资源层级,如 openai images generate、openai files upload。默认输出为可读文本,也可指定 --format json 或 --format jsonl 以便脚本解析。错误信息默认输出到 stderr,可通过 --format-error json 获取 API 错误详情。
工具支持 --transform 参数提取特定字段,并提供 --debug 和 --debug-body 进行 HTTP 调试。二进制上传直接使用文件路径,JSON 输入可通过 @ 前缀从本地文件读取。设置 OPENAI_UNTRUSTED_STDIN=1 可防止不可信输入导致本地文件读取。Shell 补全支持 Bash、zsh 和 fish,PowerShell 用户可按 Enter 打开图片选择器。