前言¶
調用 Agnes AI 的三組能力，通常意味着要分別查三份文檔：文本模型走 Chat Completions，生圖走 images/generations，生視頻是異步任務，還得自己輪詢 video_id。接口風格、鑑權方式、錯誤碼各不相同，接入成本主要花在格式對齊上。
下面介紹的 Agnes ai（AI指揮官）是一個基於 Agnes AI 官方文檔構建的 API 調用 Skill，把這三組調用收進一個 SKILL.md 裏，按統一格式描述端點、參數和排錯方式。
這是什麼¶
Skill 名稱是 Agnes ai（AI指揮官），座標 @user_02952367/agnes-ai-aizhihuiguan，發佈者 user_02952367，來源 community，分類 ai-agent，當前版本 1.0.1。它解決的問題是：把 Agnes AI 多模型、多端點的調用方式固化爲一份技能說明，讓 Agent 在需要對話、生圖、生視頻、圖像理解或工具調用時按統一格式發起請求，而不是臨場拼參數。
注意一點：該 Skill 標籤爲 requires_api_key=true，即調用前需要自行準備 Agnes AI 的 API Key。
核心功能¶
Skill 覆蓋三個模型，能力與端點的對應關係如下表（來自 Skill 頁的模型表）：
| 模型 | 能力 | 端點 |
|---|---|---|
| agnes-2.5-flash | 對話 / 代碼 / Agent / 工具調用 / 圖像理解 | /v1/chat/completions |
| agnes-image-2.1-flash | 文生圖 / 圖生圖 | /v1/images/generations |
| agnes-video-v2.0 | 文生視頻 / 圖生視頻 / 關鍵幀 | /v1/videos |
幾個要點：
- agnes-2.5-flash 走 OpenAI 兼容的 Chat Completions 接口，文本對話、代碼、Agent、工具調用、圖像理解共用這一個端點。
- agnes-image-2.1-flash 支持文生圖和圖生圖，強調高信息密度與構圖保留。
- agnes-video-v2.0 走
/v1/videos，文生視頻、圖生視頻、關鍵幀動畫都是異步任務模式：先提交任務，再拿 task_id / video_id 查詢結果。
安裝與啓用¶
先說明可覈實的部分。Skill 頁給出的部署信息只有：分類 ai-agent，標籤 requires_api_key=true，版本 1.0.1。頁面未提供具體的安裝命令、SKILL.md 文件內容或配置字段。
因此 Cursor、Codex CLI、Claude Code 各自的安裝方式，本次未能從可訪問的資料中核實，不在此臆測。按通用 SKILL.md Skill 的慣例，啓用後通常需要把 API Key 配置爲環境變量，具體變量名與獲取方式以 Skill 包內的說明爲準。
典型用法¶
Skill 的設計意圖是：當用戶提出下列需求時觸發——調用 Agnes AI 生圖、生視頻、對話、圖像理解、工具調用、Thinking 模式、流式輸出，或排查 400 / 401 / 429 / 503、video_id 查詢等問題。
需要說明的是，本次未能打開官方頁面覈對 SKILL.md 全文，因此完整的必填 / 可選參數表、curl 與 Python 示例、提示詞結構、錯誤碼清單無法逐條複述。可以確認的調用骨架是：文本類請求指向 /v1/chat/completions，圖像請求指向 /v1/images/generations，視頻請求指向 /v1/videos 並以異步任務方式提交和輪詢。Base URL 的具體值同樣未在可覈實資料中出現，以 SKILL.md 爲準。
適用場景與注意¶
適合的場景：
- 已經在用 Agnes AI，想把三類調用統一交給一個 Skill 描述，減少文檔切換。
- 需要文生圖 / 圖生圖、文生視頻 / 圖生視頻 / 關鍵幀動畫的 Agent 工作流。
- 需要在對話鏈路中使用工具調用、Thinking 模式或流式輸出。
需要注意的限制：
- 該 Skill 要求自備 API Key，且頁面標註了
requires_api_key=true，無 Key 無法調用。 - 視頻接口是異步任務，拿到 video_id 後需要輪詢，異步失敗與超時需要自己處理。
- Skill 頁顯示安裝數爲 0、評分 100000、下載 1192（截至本次抓取），社區來源，使用前建議先通讀包內 SKILL.md 覈對參數。
- 本次撰寫時官方頁面無法訪問，上文所有參數細節均未展開，接入前請以 Skill 包內文檔爲準。
結尾¶
這個 Skill 的價值在於把 Agnes AI 三個模型、三類端點的調用方式收斂成一份技能說明，參數格式和排錯路徑有統一齣處，而不是散落在三份文檔裏。如果你的 Agent 需要 Agnes AI 的對話、生圖或生視頻能力，可以從下面的地址開始覈對。
官方地址：https://api.skillhub.cn/user_02952367/agnes-ai-aizhihuiguan
SkillHub 頁面：https://www.skillhub.cn/skills/user_02952367/agnes-ai-aizhihuiguan
