Hermes Agent 可以把 RunAPI 作为自定义端点使用吗？

可以。Hermes Agent 支持模型选择和自定义端点。为命名 custom provider 配置 RunAPI 的 /v1 base URL，把 API key 放进 RUNAPI_API_KEY，并选择 gpt-5.2 这样的 RunAPI 模型。

应该用 hermes model，还是直接编辑配置文件？

想走引导式选择时用 hermes model。需要服务器或共享环境中的可重复配置时，直接编辑配置文件。两种方式都建议之后运行 hermes doctor 验证。

Hermes Agent 的 RUNAPI_API_KEY 应该在哪里设置？

把 RUNAPI_API_KEY 设置在启动 Hermes Agent 的同一个 shell、service unit 或 gateway 环境中。GUI 或 daemon 启动时不一定继承交互式 shell 变量。

添加 RunAPI 后 Hermes Agent 还能用其他 provider 吗？

可以。把 RunAPI 加为 custom:runapi 不会移除其他 Hermes Agent 模型选项。需要切换模型时使用 hermes model 或 /model 命令。

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

粘贴 setup prompt

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

复制 prompt

核对生成的配置

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

provider: custom:runapi

运行诊断

编辑配置后运行 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 命令、参数说明和常见问题。

Hermes Agent 配置问题

在 Hermes Agent 中用一把 RunAPI key。

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

浏览模型 →

在 Hermes Agent 中使用 RunAPI。

用 prompt 在 Hermes Agent 中安装 RunAPI

粘贴 setup prompt

核对生成的配置

运行诊断

配置字段

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

图像生成

视频生成

音乐生成

在爱马仕中使用任何模型

Claude

DeepSeek

ElevenLabs

Embedding

Fish Audio

Flux

Flux 2

Flux Kontext

Gemini

Gemini Omni

Gemini TTS

GLM

GPT

GPT Image

GPT Image 2

GPT-4o Image

Grok

Grok Imagine

Hailuo

HappyHorse

Ideogram V3

Imagen 4

InfiniteTalk

Kimi

Kling

Luma

Midjourney

MiMo

MiniMax

MiniMax H3

Nano Banana

OmniHuman

OpenAI Transcription

OpenAI TTS

PixVerse

Producer

Qwen 2

Qwen 3

Qwen Image

Recraft

Runway

Runway Aleph

Seedance

Seedream

Suno

Topaz

Veo 3.1

Volcengine Lip Sync

Wan