// MCP 与 Skill
将 Hermes AI API 接入你的 AI 智能体
把一段提示词复制到 Claude Code、Codex、Cursor 或其他智能体中。它会自动安装 MCP 服务器和 Agent Skill,你只需在浏览器中登录一次。
// 01
把这段提示词复制给你的智能体
适用于能执行命令的智能体,例如 Claude Code、Codex 和 Cursor。配置由智能体完成。
配置提示词
请帮我配置 Hermes AI API(https://api.hermes-ai.net),让你可以为我生成图片、视频和音乐。 1. 添加 Hermes AI API 的 MCP 服务器,名称为 hermes-ai-api,地址 https://api.hermes-ai.net/mcp(Streamable HTTP,OAuth 登录)。 - Claude Code:claude mcp add --transport http hermes-ai-api https://api.hermes-ai.net/mcp - Codex:codex mcp add hermes-ai-api --url https://api.hermes-ai.net/mcp - 其他客户端:把它加入你的 MCP 配置。 2. 安装 Hermes AI API Agent Skill:下载 https://api.hermes-ai.net/skills/hermes-ai-api.zip,解压到你的 skills 目录(Claude Code 为 ~/.claude/skills)。 3. 告诉我如何在浏览器中登录 Hermes AI API(Claude Code:运行 /mcp 并选择 hermes-ai-api;Codex:codex mcp login hermes-ai-api),然后确认工具可用。 参考:https://api.hermes-ai.net/llms.txt
// 02
只需登录一次
智能体首次使用 Hermes AI API 时会打开浏览器。用 Google 或 GitHub 登录并允许授权请求。
应用可以做什么
运行模型并使用你的预付额度,读取你的任务、结果和余额。
应用不能做什么
管理 API 密钥、账单或付款,或使用任何管理功能。
随时断开
“账户安全”会列出所有已连接的应用。断开后其访问权限立即失效。
// 03
直接说出你的需求
用自然语言告诉智能体,它会选择模型、显示价格并运行任务。
- “用 Hermes AI API 生成一张日出时灯塔的 16:9 图片。”
- “用 Hermes AI API 把这张图片做成 10 秒视频。”
- “用 Hermes AI API 写一首关于周一早晨的轻快短歌。”
- “我的 Hermes AI API 额度还剩多少?”
// 参考
手动配置
想自己动手配置?提示词完成的所有步骤都在下面。
服务器地址: https://api.hermes-ai.net/mcp
terminal
claude mcp add --transport http hermes-ai-api https://api.hermes-ai.net/mcp该 Skill 教智能体用 API 密钥通过 REST API 完成 Hermes AI API 任务流程。解压到 ~/.claude/skills(所有项目)或项目的 .claude/skills 目录,并设置 HERMES_API_KEY。
terminal
mkdir -p ~/.claude/skills
curl -L https://api.hermes-ai.net/skills/hermes-ai-api.zip -o /tmp/hermes-ai-api.zip
unzip -o /tmp/hermes-ai-api.zip -d ~/.claude/skills| 工具 | 模型能力 |
|---|---|
search_models | 按输出类型或关键词查找模型,并显示价格。 |
get_model | 读取模型的输入字段、可选值和当前价格。 |
create_task | 运行模型。仅在任务成功时扣除额度。 |
wait_for_task | 等待任务完成并返回结果。 |
get_task | 查看任务。生成的图片会直接返回。 |
list_tasks | 列出最近的任务。 |
get_balance | 显示可用、预留和已消费额度。 |
供智能体和 AI 搜索读取的机器可读摘要:Hermes AI API 是什么、全部模型以及文档位置。