Can Hermes Agent use RunAPI as a custom endpoint?

Yes. Hermes Agent supports model selection and custom endpoints. Configure the named custom provider with the RunAPI /v1 base URL, keep the API key in RUNAPI_API_KEY, and select a RunAPI model such as gpt-5.5.

Should I use hermes model or edit the config file?

Use hermes model when you want the guided picker. Edit the config file when you need a repeatable setup for a server or shared environment. In both cases, verify with hermes doctor afterward.

Where should RUNAPI_API_KEY be set for Hermes Agent?

Set RUNAPI_API_KEY in the same shell, service unit, or gateway environment that launches Hermes Agent. GUI or daemon launches do not always inherit your interactive shell variables.

Can Hermes Agent still use other providers after adding RunAPI?

Yes. Adding RunAPI as custom:runapi does not remove other Hermes Agent model options. Use hermes model or the /model command when you want to switch between configured models.

Can Hermes Agent generate images through RunAPI instead of ComfyUI?

Yes. RunAPI exposes image models like Flux Kontext, Imagen 4, and GPT Image through the same /v1 endpoint. You do not need a ComfyUI cloud instance or GPU rental — Hermes Agent calls RunAPI directly and receives image URLs in the response.

Does RunAPI support music generation from Hermes Agent?

Yes. RunAPI provides direct access to Suno v4 through v5.5 for music generation. The same RUNAPI_API_KEY and custom:runapi provider handle music requests alongside chat, image, and video — no separate bridge service or API key required.

HERMES AGENT GUIDE

Use RunAPI in Hermes Agent.

Hermes Agent can use a custom OpenAI-compatible endpoint for chat models. Paste the setup prompt and Hermes creates the provider — key goes in RUNAPI_API_KEY, base URL points to /v1, and run hermes doctor before a long session.

Get Free API Key Read the docs

Copy prompt · one RunAPI key · Hermes CLI workflow

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

SETUP

Install RunAPI in Hermes Agent with a prompt

Paste the setup prompt

Copy the prompt from the first tab into Hermes Agent. It tells Hermes Agent to read RUNAPI_API_KEY and add RunAPI as a named custom provider.

Copy prompt

Review the generated config

Hermes Agent should set provider to custom:runapi and default to gpt-5.5, with key_env pointing at RUNAPI_API_KEY.

provider: custom:runapi

Run diagnostics

Run hermes doctor after editing config, then open Hermes Agent and send a short test prompt before using it for a larger task.

hermes doctor

REFERENCE

Configuration fields

Field	Value	Purpose
`custom_providers.name`	`runapi`	Creates a named custom endpoint that Hermes Agent can select as custom:runapi.
`base_url`	`https://runapi.ai/v1`	Points Hermes Agent at RunAPI's OpenAI-compatible API surface.
`key_env`	`RUNAPI_API_KEY`	Reads the RunAPI key from the environment instead of hardcoding it.
`api_mode`	`chat_completions`	Uses the OpenAI-compatible chat request shape.

BEYOND LLMS

One endpoint for images, video, and music.

Hermes Agent users often set up a ComfyUI cloud instance at $20/month for image and video generation, or build a custom bridge for music. RunAPI replaces all of that — the same custom:runapi provider and RUNAPI_API_KEY handle image, video, and music requests alongside chat, with no extra plugins or GPU rentals.

Image Generation

Call Flux Kontext, Imagen 4, Seedream, GPT Image, and Nano Banana through the RunAPI endpoint. No ComfyUI setup, no cloud GPU, no workflow graphs — send a prompt and receive an image URL.

Browse image models

Video Generation

Generate video from text or images with Kling 3.0, Seedance 2.0, Veo 3, and Wan 2.7. RunAPI handles async polling and callbacks with the same task format across all video models.

Browse video models

Music Generation

Access Suno v4 through v5.5 directly through RunAPI. No third-party bridge service needed — pass lyrics, style, and duration, and poll for the finished audio.

Browse music models

MODEL GUIDES

Use any model in Hermes Agent

Each guide shows the prompt, curl command, parameters, and FAQ for calling a specific model through RunAPI inside Hermes Agent.

Hermes Agent setup questions

Use one RunAPI key inside Hermes Agent.

Pick a model from the catalog, set the custom endpoint, and verify Hermes Agent before your next agent run.

Browse models →

Use RunAPI in Hermes Agent.

Install RunAPI in Hermes Agent with a prompt

Paste the setup prompt

Review the generated config

Run diagnostics

Configuration fields

One endpoint for images, video, and music.

Image Generation

Video Generation

Music Generation

Use any model in Hermes Agent

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

Z Image