官方命令行工具
ZOOOP AI CLI：在终端里生成图片、视频和音频
装一个 npm 包，终端就能用上 70 多个 AI 模型，包括 GPT Image、Nano Banana、Seedance、Kling 和 ElevenLabs。通过浏览器登录后，一条命令就能报价、生成并下载结果，也可以写进脚本或 CI。
npx zooop login支持 macOS、Linux 和 Windows · Node.js 18 及以上 · 无其他依赖
直接调用你熟悉的主流模型
- GPT Image 2.5
- Nano Banana 2.1
- Seedream 5.0
- Midjourney V8.2
- Seedance 2.5
- Kling
- Wan 3.0
- Vidu Q4
- MiniMax H3
- Gemini Omni
- Grok Imagine
- ElevenLabs
- 个 AI 模型
- 70+
- 种媒体类型
- 3
- 条命令完成登录
- 1
- 个额外依赖
- 0
所有热门模型，一条命令
CLI 实时读取 ZOOOP 模型目录，新上线的图片、视频、音频模型当天就能用，不用更新 CLI。
$zooop models --type video为终端和脚本而生
每条命令都支持 --json，stdout 干净可接管道，进度写到 stderr，退出码有明确含义。可以直接放进 shell 脚本、Makefile 或 CI 任务。
$zooop tasks --json | jq .tasks[0].status按量付费的积分
生成从你的 ZOOOP 积分余额扣除。不用订阅，积分永不过期，运行前就能看到确切价格。
$zooop quote --template claymation-me能生成什么
ZOOOP 公开 API 提供的全部能力，加上模板库里的一键模板，以及去背景、超分辨率这类专用 AI 工具。
图片
文生图、图生图、按提示词修图、局部重绘、SVG 矢量图、超分辨率和去背景。
视频
文生视频、让静态图动起来、首尾帧插帧、动作迁移、对口型、续写和风格重绘。
音频
指定音色的文本转语音、根据样本克隆声音、音效和完整的音乐。
模型列表实时读取模型目录，今天上架的模型今天就能用。浏览全部模型。
每个模板，一条命令
模板库里的一键模板同样能在终端里跑。zooop templates show 列出模板需要的输入，zooop run --template 用你的照片直接生成。
三步开始
大约两分钟。你需要一个终端和一个 ZOOOP 账号。
- 1
安装 CLI
用包管理器全局安装，或者用 npx 直接运行。只需要 Node.js 18 及以上，不需要别的。
npm install -g zooopzooop --help为当前用户安装 zooop 命令。
- 2
通过浏览器登录
运行 zooop login 会显示一个短确认码并打开 zooop.ai/cli/login。确认浏览器里显示的是同一串码，选好账户和项目，点“授权”即可，不用复制粘贴任何 key。
为 CI 创建 API key只授权你自己发起的登录。随时可以在 API 密钥页或用 zooop logout 撤销这把 key。
zooop login会打开你的默认浏览器。key 只保存在这台电脑上，存放的文件只有你本人可读。
- 3
第一次生成
先找模型、看价格，再运行。CLI 会等待结果，并保存到当前目录。
第一次运行zooop models --type image --subtype defaultzooop quote --model <model-id> --version <version-id> -p prompt="a red panda eating noodles"zooop run --model <model-id> --version <version-id> -p prompt="a red panda eating noodles"
用浏览器登录，不用粘贴密钥
zooop login 会显示一个短码并打开 zooop.ai/cli/login。核对两边的码一致后点授权，CLI 就登录好了。密钥全程不经过你的剪贴板。
终端显示一次性登录码
浏览器显示同一个码，点授权
CLI 已登录，密钥只保存在本机
命令一览
每条命令都支持 --json 和 -h。在任意命令后加 --help 可查看它的全部选项。
- zooop login
通过浏览器登录，为这台电脑保存一把 key。
zooop login- zooop whoami
查看账户、项目、积分余额和 key 过期时间。
zooop whoami- zooop models
列出模型及其版本、输入参数和参考价格。
zooop models --type video --subtype text-ref- zooop templates
浏览模板库，查看每个模板需要哪些输入。
zooop templates show <slug>- zooop tools
列出去背景、超分辨率等 AI 工具。
zooop tools- zooop quote
只报价，不运行。
zooop quote --model <id> --version <id> -p prompt="..."- zooop run
提交请求、等待结果并下载。本地文件会自动上传。
zooop run --template <slug> -p image_url=@photo.jpg- zooop tasks
列出最近的任务、查看或等待某个任务，也能取消排队中的任务。
zooop tasks get <task-id> --wait- zooop upload
上传图片、视频或音频文件，并输出它的地址。
zooop upload ./clip.mp4- zooop describe
把一张图转成可复用的提示词（1 积分）。
zooop describe @./reference.jpg- zooop logout
在服务器上撤销已保存的 key，并删除本地凭据。
zooop logout
示例
复制一条，把模型 ID 换成 zooop models 里的，直接运行。
文生图
生成一张宽屏画面，保存到 ./renders。
zooop run --model <model-id> --version <version-id> \ -p prompt="a neon-lit rainy Tokyo alley, cinematic" \ -p aspect_ratio=16:9 --out ./renders图生视频
让本地照片动起来。文件会先上传；参数名以 zooop models 显示的为准。
zooop run --model <model-id> --version <version-id> \ -p prompt="slow push-in, hair moving in the wind" \ -p image_url=@./portrait.jpg -p duration=5运行模板
选一个模板，传入你的照片。
zooop templates --type videozooop run --template <slug> -p 'image_urls=["@./me.jpg"]' --out ./results脚本批量生成
一次提交多个提示词，用 jq 收集任务 ID。
for subject in "red fox" "snow owl" "arctic hare"; do zooop run --model <model-id> --version <version-id> \ -p prompt="$subject, studio photo" --no-wait --json | jq -r .taskIddonezooop tasks --status running默认就安全
CLI 花的是真积分，所以在 key 和费用上都很谨慎。
- key 不进命令历史
- 浏览器登录直接把 key 交给 CLI，不需要粘贴，key 存放的文件只有你本人可读。
- 每把 key 都有限制
- 每把 CLI key 会在 30、90 或 365 天后过期，只绑定一个项目，授权时还可以设置每日积分上限。
- 先知道价格
- zooop quote 会在运行前告诉你确切的积分花费和预计耗时。
- 重试不会重复扣费
- 每次运行都带幂等键，24 小时内重复运行同一条命令会返回已有任务，不会再次扣费。
常见问题
ZOOOP AI CLI 是什么？
ZOOOP 的免费命令行客户端。你可以在终端或脚本里生成 AI 图片、视频和音频，用的模型和积分与网页版完全一样。
运行它需要什么？
macOS、Linux 或 Windows 上的 Node.js 18.17 及以上，再加一个 ZOOOP 账号。这个包没有其他依赖。
能用哪些模型？
ZOOOP 公开 API 上的所有模型：GPT Image、Nano Banana 等图片模型，Seedance、Kling、Wan 等视频模型，以及语音、声音克隆、音效和音乐等音频模型。运行 zooop models 查看最新列表。
要花多少钱？
CLI 本身免费。每次生成花的积分和网站上一样，运行前用 zooop quote 就能看到确切价格。
能在 CI 或脚本里用吗？
可以。设置 ZOOOP_API_KEY 代替登录，加上 --json 获得机器可读的输出，再检查退出码：0 表示成功，1 表示接口或任务失败，2 表示用法错误。
怎么退出登录或撤销授权？
运行 zooop logout 撤销 key 并从电脑上删除，或者在 API 密钥页撤销。撤销后的 key 在所有地方都会失效。
它和 ZOOOP 智能体技能有什么区别？
CLI 是给你自己用的：可以亲手敲命令，也可以在自己的脚本里调用；技能则是教 Claude Code、Codex 这类 AI 智能体在对话里调用 ZOOOP。