使用 OpenArt CLI 在终端中生成图像和视频

什么是 OpenArt CLI

OpenArt CLI 是一个单一的二进制文件，可让你的终端访问 OpenArt 账户，支持 macOS、Linux 和 Windows。你只需通过浏览器登录一次，使用 openart login。OAuth 流程免去了安装 Python 或 Node、创建 API 密钥或在脚本中存储长期密钥的麻烦。

登录命令使用带 PKCE 的标准 OAuth 流程，与桌面应用避免直接处理密码所采用的浏览器重定向模式相同。CLI 会将生成的凭证存储在 ~/.openart/cli-credentials.json （模式 0600，因此只有你的用户账户才能读取；Windows 将其存储在 %USERPROFILE%\.openart\cli-credentials.json），并自动刷新它。 openart logout 撤销该凭证并清除本地状态。

OpenArt 把 CLI 打造为一个独立的产品界面，而非一个替你在网页应用中点来点去的脚本。它的命令直接暴露了 图片 和 视频生成、模型信息、创建状态、上传、项目和工作区，直接对接到 shell 脚本和编程智能体。机器可读输出、请求预览、异步任务以及有界轮询，共同支持可重复的自动化。

CLI 消耗的是你 OpenArt 账户自身的积分，与网页应用共用同一额度池。它并不是一个拥有独立密钥和计费的单独 API 产品。 OpenArt CLI GitHub 代码仓库 提供了权威的安装说明、命令参考以及当前版本的详细信息。

如何安装 OpenArt CLI

OpenArt CLI 以单个预编译二进制文件的形式支持 macOS、Linux 和 Windows。在 macOS 或 Linux 上，运行官方安装程序。

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

在 Windows 上，打开 PowerShell 并运行一行式安装程序。

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

安装程序会为你的设备选择合适的构建版本，根据发布校验和进行验证，并放置 openart 放到标准可执行文件目录中。在 macOS 和 Linux 上，它会使用 /usr/local/bin 当该位置可写入时，或 ~/.local/bin 进行用户级安装，而不是提示输入 sudo 意外地。如果安装程序使用 ~/.local/bin，请确保该目录已在你 shell 的 PATH。在 Windows 上，它会安装到 %LOCALAPPDATA%\Programs\openart\bin 并将该文件夹添加到你的用户 PATH 自动完成，因此无需管理员权限。

两个安装脚本都接受自定义安装位置或固定的版本。在 macOS 或 Linux 上，在脚本后添加标志。

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh -s -- --prefix "$HOME/.local" --version 0.1.0

通过管道运行的 PowerShell 脚本无法直接接收参数，因此请先将版本号设置为环境变量。

$env:OPENART_VERSION = '0.1.0'
irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

不想把脚本直接管道输入到 shell？请从以下位置下载适用于你平台的压缩包： 最新版本 （macOS Apple 芯片或 Intel、Linux x86-64 或 arm64、Windows x86-64 或 arm64），解压后放入 openart 在你的 PATH。每个版本都会发布一个 checksums.txt 你可以用以下方式验证 shasum -a 256 -c checksums.txt --ignore-missing.

日后如需升级，重新运行同一个安装程序即可。它会就地覆盖现有的二进制文件。

在新的终端窗口中确认安装。

openart --help

然后将 CLI 连接到你的 OpenArt 账户。

openart login

登录命令会打开浏览器进行 OAuth 身份验证。你批准访问后，CLI 即可使用你的账户，无需 API 密钥，也无需 Python 或 Node 等语言运行时。

核心命令速览

核心命令集

身份验证与账户访问

OpenArt 使用浏览器 OAuth 进行账户访问。用以下命令开始一个会话 openart login，以以下命令结束 openart logout，并用以下命令查看你的套餐或积分余额 openart account.

openart login
openart account
openart logout

图像和视频生成

OpenArt 在每条生成命令中都会明确指定媒体类型。分离 image 和 video 命令意味着脚本不会意外地把请求路由到错误的模型类型。

对于 文生图生成 或 图生图编辑，请使用 image 命令并附上 prompt 和模型 ID。添加 --image 当提供本地文件或 URL 作为参考时。

openart generate image "A ceramic mug on a studio table" \
  --model nano-banana-2 \
  -o ./out/

上面的示例使用了 nano-banana-2；换用任意模型 openart model list 为你展示。

对于 文本转视频 或 图生视频，请使用视频命令。支持的选项可能包括时长、宽高比和分辨率，具体取决于模型。

openart generate video "Slow camera orbit around the product" \
  --model kling-3-omni \
  --image ./start-frame.png \
  --duration 8

模型选择与请求参数

模型命令让你可以查看当前选项，而不必硬编码各种假设。 openart model list 会显示可用模型及其支持的模式。随着 OpenArt 新增选项，模型名称可能会变化。

openart model list
openart model cost
openart model cost --model nano-banana-2 --mode text2image
openart model form nano-banana-2 text2image

openart model cost 单独使用时会列出每个模型的报价，从最便宜的开始，且不消耗积分。加上 --model 和 --mode 为某个特定组合定价。 form 命令会返回特定模型和模式所接受的确切参数。如果你要在两者之间做选择，可以看看 GPT Image 2 与 Nano Banana 2 的对比 再决定用哪个来跑批处理任务。

创作与已存储的素材

创建命令让脚本得以查看生成历史并管理已提交的任务。使用 list 对于以往的创作， get 用于某一个任务，而 wait 当脚本必须暂停等待异步任务完成时。

openart creation list --type video --limit 10
openart creation get <creation-id>
openart creation wait <creation-id>

项目和工作空间命令用于控制新工作的归属位置。

openart project list
openart project create --name "<name>"
openart workspace list
openart workspace select <workspace-id>
openart workspace select

workspace select 不带参数时会切换回你的个人工作区，而 workspace list 用星号标记出当前活动的那一个。

对于可复用的参考文件， openart upload add <file> 将素材上传一次并打印出一个 URL，供后续命令使用，而 openart upload list --type image 显示你已经上传的内容。 官方 CLI 代码仓库 随着操作界面不断演进，提供最新的命令参考。

卸载需要手动操作，因为 CLI 没有内置的卸载命令。在 macOS 或 Linux 上，用以下命令删除二进制文件及其存储的凭证 rm "$(command -v openart)" 和 rm -rf ~/.openart。在 Windows 上，删除 %LOCALAPPDATA%\Programs\openart，将其从你的用户中移除 PATH，然后删除 %USERPROFILE%\.openart。如果你遇到值得反馈的 bug，请附上以下命令的输出 openart version 到你的问题中。它会报告确切的构建版本、平台和提交。

为脚本而非点击打造的参数标志

OpenArt CLI 提供了多项控制项，让脚本中的生成过程更可预测。每一项都针对一个常见的自动化难题：结构化解析、意外消耗、长时间运行的任务，以及卡住的进程。

这份 --json 标志会将机器可读的结果写入标准输出。进度和分页消息则输出到标准错误，因此 CI 任务或智能体工具调用可以将干净的 JSON 通过管道传给另一条命令，而无需抓取人类可读的文本。脚本可以可靠地提取创建 ID、状态和结果 URL。

这份 --dry-run 标志会打印出 OpenArt 将要发送的确切请求（适用于任何会写入或消耗积分的命令），但不会真正发送。你可以用它在启动批量循环前检查模型选择和参数，或让智能体在获得执行写入或消耗操作的权限前，预览生成的命令。

这份 --async 标志会提交一个生成任务并立即返回其创建 ID，而不必等待。批量脚本可以提交多个任务、去做其他工作，稍后再用以下命令 openart creation wait 或 openart creation get 以收集结果。因为 --async 会在文件生成可供下载之前就返回，因此无法与以下命令搭配使用 -o 或 --output.

如果没有 --async，OpenArt CLI 会提交任务并持续轮询直至完成。轮询会在配置的以下时限处停止 --timeout，默认为五分钟。有边界的等待可避免失败的生成任务或网络故障让 CI 作业无限运行下去，而明确设置的超时时间则可让你为较慢的视频任务留出空间。

为什么用 CLI，而不只是浏览器

命令行界面比鼠标出现得更早。第一个命令行解释器于 1961 年运行在 MIT 的 CTSS 系统上，它开创的 shell 脚本传统，历经 1971 年的第一个 Unix shell 和 1977 年的 Bourne shell 传承至今，至今仍是大多数服务器、CI 流水线和开发者工具实现自动化的方式（维基百科). GitHub 官方说明 直白地道出了实际应用场景：CLI 只需敲几下键盘就能完成任务，而不必点击一连串按钮；它所占用的资源仅是图形界面的一小部分；还能把可重复的工作变成脚本，而非一系列手动步骤。

一旦发出命令的是 AI 智能体而非真人，这一点就更有说服力了。大语言模型天生以文本为本，因此 CLI 的文本输入、文本输出格式意味着智能体永远不必解析一张截图来判断某次点击是否成功。 Parallel 的工程团队 曾指出，CLI 操作同样具有确定性，而且比等效的浏览器自动化便宜得多，因为无需渲染页面、无需解析布局，命令运行后发生了什么也不会含糊不清。 Claude 本身无法生成图像或视频，这正是智能体需要一种途径来调用能够生成内容的模型的原因。这也正是 Claude Code 和 Codex 把终端当作工作空间的原因，同样也是 openart generate image ... 比驱动一个浏览器会话更契合这些智能体。

这个术语本身在日常使用它的人当中至今仍有争议。在 r/AskProgramming 上，开发者们厘清了 CLI 和全屏终端程序（即 TUI）之间的区别：CLI 是基于行的，你输入一条命令并得到响应，然后进入下一行；而像 vim 或 htop 这样的程序则会重绘整个屏幕，让你在其中自由导航（r/AskProgramming). openart 正是这种更狭义上的 CLI。每条命令都是一行输入、一个结果输出，这恰恰是脚本或智能体所期待的形式，也正因如此，它并不试图成为一个交互式仪表盘。

CLI 与 MCP：选择合适的操作界面

OpenArt CLI 适合那些本就运行在终端里的工作流：脚本、批量生成、CI 任务，以及命令与机器可读输出为下一步提供输入的基于 shell 的自动化。

Claude Code 和 Codex 等编码代理可以通过其现有的 shell 访问权限调用 CLI。你无需再添加一层集成，代理使用的命令与你手动运行的完全相同。

OpenArt's MCP 服务器 让对话式创意工作可以在 Claude 内进行（参见 一个从 Claude 生成视频的示例), ChatGPT或 Cursor。MCP 让智能体在对话过程中调用 OpenArt 工具，这适合迭代式的需求——你描述一张图像或一段视频，并通过对话而非脚本来不断优化它。如果你想更全面地比较各种选择，下面看看它与 其他用于图像和视频生成的 MCP 服务器.

两者都无法取代 OpenArt 网页应用。当你需要可视化控件和直接检查时，网页应用仍是最佳选择；CLI 适合可重复的终端工作，MCP 适合基于聊天的交互。选择你现有工作流程所在的界面：如果你在为正在构建的代理在 CLI 和 MCP 之间做决定，不妨想想该代理是通过聊天窗口与你对话（MCP），还是在 shell 或流水线中无人值守地运行（CLI）。

快速上手：安装、登录、生成

在 macOS 或 Linux 上，运行安装程序。

curl -fsSL https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.sh | sh

Windows 用户可改用 PowerShell 安装程序。

irm https://raw.githubusercontent.com/OpenArt-AI/cli/main/install.ps1 | iex

接下来，通过登录命令打开的浏览器窗口完成身份验证。

openart login

找一个当前的图像模型并复制它的标识符。

openart model list

将下方命令中的模型替换为该列表中的标识符，例如 nano-banana-2。先用以下命令预览你的首次请求 --dry-run 这样 OpenArt 就不会消耗积分。

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2 \
  --dry-run

检查完预览后，移除 --dry-run 以提交生成任务。

openart generate image "A small red sailboat on a calm lake at sunrise" \
  --model nano-banana-2

常见问题

什么是 OpenArt CLI？

OpenArt CLI 是一个用于在终端中生成图像和视频的单一二进制文件。它通过基于浏览器的 OAuth 连接到你的 OpenArt 账户，你可以在脚本、批处理作业、CI 任务以及具备 shell 访问权限的编码代理中使用它。

OpenArt CLI 安装是免费的吗？

安装 CLI 本身不收取任何费用。图像和视频生成会消耗你 OpenArt 账户和套餐中可用的积分，与通过网页应用生成一样。运行 openart model cost 以在生成前查看某个模型的收费情况。

OpenArt CLI 需要 API 密钥吗？

不需要。 openart login 会为你的 OpenArt 账户打开基于浏览器的 OAuth 登录，因此你无需在本地配置中存储或轮换单独的密钥。

哪些平台支持 OpenArt CLI？

macOS、Linux 和 Windows，作为独立二进制文件通过 官方 GitHub 仓库。你无需安装 Python 或 Node。

CLI 还是 MCP：我该用哪个？

当工作本身就在终端中进行时使用 CLI：shell 脚本、CI 流水线，或像 Claude Code、Codex 这类具备 shell 访问权限的编码代理。使用 OpenArt 的 MCP 服务器 当你希望在 Claude、ChatGPT 或 Cursor 中使用基于聊天的代理，在对话中途生成和优化图像或视频时，就像你会 直接从 Claude 生成产品广告。二者并不互斥；有些团队用 CLI 编写可重复的部分脚本，用 MCP 处理探索性的部分。

OpenArt CLI 与网页应用有何不同？

CLI 将生成和账户操作以命令形式呈现，具备结构化输出、试运行和异步作业处理。网页应用则为交互式创作和编辑提供可视化界面。当你需要可重复的 shell 命令或自动化，而非在 UI 中点来点去时，就选择 CLI。

如何卸载 OpenArt CLI？

没有内置的卸载命令，因此需要手动删除二进制文件及其存储的凭据。运行 rm "$(command -v openart)" 和 rm -rf ~/.openart 在 macOS 或 Linux 上，或删除 %LOCALAPPDATA%\Programs\openart 和 %USERPROFILE%\.openart 在 Windows 上。