跳到主要内容

将 Hermes AI API 接入你的 AI 智能体

在 Claude Code、Codex、Cursor 或任何其他智能体中使用 Hermes AI API。从三种接入方式中选一种,或复制一段提示词让智能体自行完成配置。

三种接入方式

三者可以同时使用:MCP 服务器负责运行任务,文档和 Skill 让智能体学会使用 API。

AI 文档

无需安装

给智能体一个 URL。它会读到 Hermes AI API 的介绍、全部模型和完整的任务流程,然后用你的 API 密钥调用 REST API。

需要: 运行任务需要 API 密钥

https://api.hermes-ai.net/llms.txt

MCP 服务器

推荐

任何 MCP 客户端都能通过 HTTP 连接同一个远程地址。在浏览器中登录一次,智能体即可搜索模型、运行任务并获取结果。

需要: 你的 Hermes AI 账号,无需 API 密钥

https://api.hermes-ai.net/mcp

Agent Skill

本地

把含 SKILL.md 的文件夹下载到智能体的 skills 目录,教会它通过 REST API 完成任务流程。

需要: 在 HERMES_API_KEY 中设置 API 密钥

https://api.hermes-ai.net/skills

把这段提示词复制给你的智能体

适用于能执行命令的智能体,例如 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

这段提示词会添加 MCP 服务器、安装 Agent Skill,并说明如何登录。 登录流程

直接说出你的需求

用自然语言告诉智能体,它会选择模型、显示价格并运行任务。

  • “用 Hermes AI API 生成一张日出时灯塔的 16:9 图片。”
  • “用 Hermes AI API 把这张图片做成 10 秒视频。”
  • “用 Hermes AI API 写一首关于周一早晨的轻快短歌。”
  • “我的 Hermes AI API 额度还剩多少?”

配置指定客户端

每个客户端的分步指南,附带确切的命令或配置文件。