官方 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 密鑰查看定價