官方 Agent 技能

ZOOOP Skill：让你的 AI Agent 生成图片、视频和音频

装上一个技能包，你的 Agent 就能调用 70+ 顶级 AI 模型创作——Flux、Veo、Kling、Seedance、ElevenLabs 等等，全程不用离开终端。选模型、算价格、提交任务、等结果、把文件交给你，全部由它完成。

安装
npx skills add zooopai/skill-zooop
查看安装指南在 GitHub 上查看

支持 Claude Code、Codex、Cursor、OpenCode 等 70 多种 Agent。

所有顶级模型，一个技能搞定

技能在运行时实时读取 ZOOOP 模型目录，你的 Agent 因此能用上平台上的每一个图片、视频、音频模型——包括你装好之后才上架的那些。

就在你的 Agent 里运行

不用装新应用，也不用开控制台。用大白话说需求，Agent 会读 SKILL.md、调用 REST API，然后把链接或下载好的文件交给你。

用你已有的积分付费

生成消耗的是你现有的 ZOOOP 积分余额。不需要另外订阅，积分也永不过期。

你的 Agent 能做什么

技能覆盖 ZOOOP 公开 API 暴露的全部生成类别，另外还包括抠图、超分这类光靠提示词做不到的专用工具。

图片

文生图、图生图、一句话直接改图、带蒙版的局部重绘、SVG 矢量输出、超分和背景移除。

视频

文生视频、让静图动起来、首尾帧插值、从参考视频迁移动作、对口型、续写和视频改风格。

音频

指定音色的语音合成、用样本克隆声音、单次音效生成，以及完整的音乐生成。

模型可用性在请求时实时读取，今天上架的模型当天就能用。浏览完整模型库。

三步装好

大约两分钟。你需要一个有积分的 ZOOOP 账号和一个终端。

  1. 1安装技能包

    技能包是一个公开的 GitHub 仓库，里面有 SKILL.md、API 参考和辅助脚本。挑一条跟你环境匹配的命令即可。

    npx skills add zooopai/skill-zooop

    会自动识别你机器上的 Agent 并逐个安装。加上 -g 就装到全局，而不是只装到当前项目。

  2. 2创建 API 密钥

    生成任务用个人访问令牌（zpk_live_…）鉴权。令牌只显示一次，关掉弹窗前记得复制。

    去创建令牌

    请在你自己的终端里设置这个值，不要粘贴进 Agent 对话——对话内容可能进入日志，或者被分享出去。

    echo 'export ZOOOP_API_KEY=zpk_live_xxxxxxxxxxxx' >> ~/.zshrc
    source ~/.zshrc

    用的是 bash 而不是 zsh？把同样这行写进 ~/.bashrc。

  3. 3重启 Agent，然后开口

    Agent 在启动时继承环境变量，所以第 2 步之后要重启它。先确认令牌能读到，然后直接描述你想要什么就行。

    验证令牌
    curl -fsS https://api.zooop.ai/v1/me \
      -H "Authorization: Bearer $ZOOOP_API_KEY"

    试试这几句

    • ›生成一张 1:1 的霓虹雨夜东京小巷海报，电影感。
    • ›把这张照片做成 5 秒短片，镜头缓慢推进。./portrait.jpg
    • ›用沉稳的英式男声把这段话读出来。

Agent 帮你做了这些

每一次请求都走同样的五步。技能会全部处理好，你不需要去学 API。

  1. 01

    挑模型

    按类别读取实时模型目录，匹配你提到的模型名；没指定就用推荐默认值。

  2. 02

    上传素材

    本地的图片、视频、音频会先传到 ZOOOP 存储——模型只接受 ZOOOP 托管的 URL。

  3. 03

    先报价

    免费的报价接口会给出准确的积分消耗和预计耗时，此时还没有任何扣费。

  4. 04

    安全提交

    每次提交都带幂等键，请求超时后重试也不会重复扣费。

  5. 05

    等待并交付

    轮询到任务完成，打印输出链接，并询问要不要保存到本地。

花费与安全控制

技能花的是真金白银的积分，所以你签发的每个令牌都带着自己的限制。

每个令牌有单日消耗上限
创建密钥时就能设定积分上限。会突破上限的任务在执行前就被拒绝，Agent 就算跑飞了也掏不空余额。
绑定到单个项目
每个令牌在创建时锁定一个项目。它产生的所有任务和上传都落在那里，和你手动创作的内容分得干干净净。
不报价就不扣费
报价免费，且没有任何副作用。生成失败会自动退还积分。
令牌不会出现在对话里
技能明确要求 Agent 从环境变量读取该值，绝不让你把它粘贴出来。密钥可以在创建它的那个页面随时吊销或轮换。

常见问题

支持哪些 Agent？
任何能读 Markdown 指令、能执行 Shell 命令的 Agent 都可以。我们实测过 Claude Code、Codex、Cursor 和 OpenCode；skills CLI 另外还支持 70 多种。
技能本身收费吗？
不收费。技能包采用 MIT 许可、完全免费。你只需要为 Agent 实际跑的生成任务付积分，费率和网页端一致。
一次生成要多少积分？
取决于模型和产出——主要看分辨率和时长。Agent 会在提交前报出准确价格，各模型的费率也可以在定价页查到。
API 密钥在哪里拿？
在个人中心的 API 密钥标签页。个人令牌花你自己的积分；团队的所有者或管理员也可以签发团队令牌，花的是团队共享余额。
Agent 能用我的画布和模板吗？
不能。技能只做单次生成，不管理项目、画布或团队。结果会落在令牌绑定的那个项目里，你可以在网页端打开。
怎么更新技能？
重新跑一遍安装命令，或者在克隆目录里 git pull。模型目录是实时读取的，所以新模型上架根本不需要更新。

文档与源码

GitHub 上的 skill-zooop

完整技能包——SKILL.md、辅助脚本和 API 参考。MIT 许可，欢迎提 issue 和 PR。

SKILL.md

Agent 真正读的那份指令文件：模型选择规则、工作流程和错误处理。

API 文档

技能背后的 REST API，每个接口都配了 cURL、JavaScript 和 Python 示例。

完整 v1 参考

所有请求与响应结构、错误码和限流规则，都在这一份 Markdown 里。

技能上手教程

带真实提示词和结果的完整走查：该怎么问，以及会拿到什么。

不装技能包，Agent 也能自己发现 ZOOOP： /llms.txt · /llms-full.txt

把它交给你的 Agent 吧

创建一个令牌、导出到环境变量，下一句提示词就能产出成品图片、片段或音轨。

创建 API 密钥查看定价