前言¶
调用 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
