HERMES AGENT 指南

在 Hermes Agent 中使用 RunAPI。

Hermes Agent 可以使用自定义 OpenAI 兼容端点调用聊天模型。把 prompt 复制进 Hermes Agent，让它创建 custom provider；需要精确 YAML 时再看配置 tab。

免费获取 API Key 阅读文档
复制 prompt · 一把 RunAPI key · Hermes CLI 工作流 
Configure this Hermes Agent install to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a custom provider named runapi.
- Use base_url "https://runapi.ai/v1".
- Use key_env RUNAPI_API_KEY.
- Use api_mode chat_completions.
- Set model.provider to custom:runapi.
- Set the default model to gpt-5.5.
- Run `hermes doctor` and report any config problems before starting a session.
- If RUNAPI_API_KEY is missing, ask me to set it before starting Hermes Agent.
custom_providers:
  - name: runapi
    base_url: "https://runapi.ai/v1"
    key_env: RUNAPI_API_KEY
    api_mode: chat_completions

model:
  provider: custom:runapi
  default: gpt-5.5
export RUNAPI_API_KEY="runapi_xxx"
hermes model
hermes doctor
hermes
Copy prompt first /v1
配置步骤

用 prompt 在 Hermes Agent 中安装 RunAPI

1

粘贴 setup prompt

复制第一个 tab 里的 prompt 给 Hermes Agent。它会要求 Hermes Agent 读取 RUNAPI_API_KEY，并把 RunAPI 添加为命名 custom provider。

复制 prompt
2

核对生成的配置

Hermes Agent 应该把 provider 设为 custom:runapi，default 设为 gpt-5.2，并用 key_env 指向 RUNAPI_API_KEY。

provider: custom:runapi
3

运行诊断

编辑配置后运行 hermes doctor，然后打开 Hermes Agent 并发送一条短测试提示，再用于更大的任务。

hermes doctor
参考

配置字段

字段 值 作用
custom_providers.name runapi 创建一个 Hermes Agent 可以按 custom:runapi 选择的命名自定义端点。
base_url https://runapi.ai/v1 让 Hermes Agent 指向 RunAPI 的 OpenAI 兼容 API 接口。
key_env RUNAPI_API_KEY 从环境变量读取 RunAPI key，避免硬编码。
api_mode chat_completions 使用 OpenAI 兼容聊天请求形态。
不止大模型

一个端点，图像、视频、音乐全支持。

Hermes Agent 用户通常需要花每月约 $20 搭建 ComfyUI 云实例来处理图像和视频，或者自建音乐桥接服务。RunAPI 替代了所有这些——同一个 custom:runapi provider 和 RUNAPI_API_KEY，聊天、图像、视频、音乐请求全部搞定，无需额外插件或 GPU 租用。

图像生成

通过 RunAPI 端点调用 Flux Kontext、Imagen 4、Seedream、GPT Image 和 Nano Banana。无需 ComfyUI 配置、无需云 GPU、无需工作流图——发送提示词，接收图像 URL。

浏览图像模型

视频生成

用 Kling 3.0、Seedance 2.0、Veo 3 和 Wan 2.7 从文字或图像生成视频。RunAPI 以统一的任务格式处理所有视频模型的异步轮询和回调。

浏览视频模型

音乐生成

直接通过 RunAPI 访问 Suno v4 到 v5.5。无需第三方桥接服务——传入歌词、风格和时长，然后轮询已完成的音频。

浏览音乐模型
模型指南

在爱马仕中使用任何模型

每份指南包含在 Hermes Agent 中通过 RunAPI 调用特定模型所需的提示词、curl 命令、参数说明和常见问题。

InfiniteTalk

从音频生成数字人口播视频

Grok Imagine

xAI 文生图与文生视频

Flux Kontext

提示词引导的图像编辑

Z Image

双语快速文生图

Topaz

AI 图像与视频超分

Imagen 4

Google 文生图

Seedream

字节跳动 4K 文生图

Qwen 2 Image

阿里巴巴图像生成与编辑

Kling

带动感控制和原声音频的视频生成

Veo 3

Google 影视级视频，原生音频

Seedance

字节跳动低成本视频生成

Hailuo

MiniMax 视频，每日免费额度

Wan

开源视频与图像生成

Runway

带镜头控制的创意视频生成

Luma

空间感知视频生成

Suno

文字转 AI 音乐

ElevenLabs

文字转语音与语音 AI

GPT

OpenAI 对话与响应 API

Claude

Anthropic 消息 API

DeepSeek

低成本推理大模型

Gemini

Google AI 模型，无需 GCP

Nano Banana

Google 图像生成，支持文字排版

Midjourney

Midjourney AI 绘画、图片编辑和图生视频

Ideogram V3

专注排版的图像生成

Recraft

矢量艺术与图像超分

Flux 2

BFL 图像生成，Pro 和 Flex 档

GPT Image

OpenAI 图像生成与编辑
常见问题

Hermes Agent 配置问题

在 Hermes Agent 中用一把 RunAPI key。

从模型目录选择模型，设置自定义端点，并在下一次 agent run 前验证 Hermes Agent。

浏览模型 →