Claude 访客：新账户可在 30 天内获得 $1.00 API 赠送额度。每人限领一次，仅用于 API 用量。
在 Hermes Agent 中使用 RunAPI
Hermes Agent 可以使用自定义 OpenAI 兼容端点调用聊天模型。把 prompt 复制进 Hermes Agent，让它创建 custom provider；需要精确 YAML 时再看配置 tab。
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.5export RUNAPI_API_KEY="runapi_xxx"
hermes model
hermes doctor
hermes用 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。
浏览图像模型在爱马仕中使用任何模型
每份指南包含在 Hermes Agent 中通过 RunAPI 调用特定模型所需的提示词、curl 命令、参数说明和常见问题。
Claude
文本 · Anthropic
DeepSeek
文本 · DeepSeek
ElevenLabs
音频与音乐 · ElevenLabs
Embedding
文本 · OpenAI
Fish Audio
音频与音乐 · Fish Audio
Flux
图像 · Black Forest Labs
Flux 2
图像 · Black Forest Labs
Flux Kontext
图像 · Black Forest Labs
Gemini
文本 · Google
Gemini Omni
视频 · Google
Gemini TTS
音频与音乐 · Google
GLM
文本 · Z.ai
GPT
文本 · OpenAI
GPT Image
图像 · OpenAI
GPT Image 2
图像 · OpenAI
GPT-4o Image
图像 · OpenAI
Grok
文本 · xAI
Grok Imagine
视频 · xAI
Hailuo
视频 · MiniMax
HappyHorse
视频 · Alibaba
HeyGen Video
视频 · HeyGen
Ideogram V3
图像 · Ideogram
Imagen 4
图像 · Google
InfiniteTalk
视频 · MeiGen-AI
Jev
工具 · TypeSafe
Kimi
文本 · Moonshot AI
Kling
视频 · Kuaishou
Midjourney
工具 · Midjourney
MiMo
文本 · Xiaomi
MiniMax
文本 · MiniMax
MiniMax H3
视频 · MiniMax
Nano Banana
图像 · Google
OmniHuman
工具 · Bytedance
OpenAI Transcription
音频与音乐 · OpenAI
OpenAI TTS
音频与音乐 · OpenAI
PixVerse
视频 · PixVerse
Producer
音频与音乐 · Producer
Qwen
文本 · Alibaba
Qwen 2
图像 · Alibaba
Qwen 3
图像 · Alibaba
Qwen Image
图像 · Alibaba
Recraft
工具 · Recraft
Runway
视频 · Runway
Seedance
视频 · Bytedance
Seedream
图像 · Bytedance
Suno
音频与音乐 · Suno
Topaz
工具 · Topaz
Veo 3.1
视频 · Google
Volcengine Lip Sync
视频 · Bytedance
Wan
视频 · Alibaba
Z Image
图像 · Alibaba
Hermes Agent 配置问题
可以。Hermes Agent 支持模型选择和自定义端点。为命名 custom provider 配置 RunAPI 的 /v1 base URL，把 API key 放进 RUNAPI_API_KEY，并选择 gpt-5.2 这样的 RunAPI 模型。
想走引导式选择时用 hermes model。需要服务器或共享环境中的可重复配置时，直接编辑配置文件。两种方式都建议之后运行 hermes doctor 验证。
把 RUNAPI_API_KEY 设置在启动 Hermes Agent 的同一个 shell、service unit 或 gateway 环境中。GUI 或 daemon 启动时不一定继承交互式 shell 变量。
可以。把 RunAPI 加为 custom:runapi 不会移除其他 Hermes Agent 模型选项。需要切换模型时使用 hermes model 或 /model 命令。
可以。RunAPI 通过同一个 /v1 端点提供 Flux Kontext、Imagen 4 和 GPT Image 等图片模型。无需 ComfyUI 云实例或租用 GPU：Hermes Agent 直接调用 RunAPI，并在响应中收到图片 URL。
支持。RunAPI 提供 Suno v4 至 v5.5 的直接访问，用于生成音乐。同一个 RUNAPI_API_KEY 和 custom:runapi 提供商可同时处理音乐、聊天、图片和视频请求，无需独立的桥接服务或 API 密钥。