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.
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
hermesInstall 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
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. |
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 modelsVideo 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 modelsMusic 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 modelsUse 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.
InfiniteTalk
Talking avatar video from audio
Grok Imagine
xAI image and video generation
Flux Kontext
Text-guided image editing
Z Image
Fast bilingual image generation
Topaz
AI image and video upscaling
Imagen 4
Google image generation
Seedream
Bytedance 4K image generation
Qwen 2 Image
Alibaba image generation and editing
Kling
Video generation with motion control and sound
Veo 3
Google cinematic video with native audio
Seedance
Budget video generation by Bytedance
Hailuo
MiniMax video with free daily quota
Wan
Open-source video and image generation
Runway
Creative video with camera control
Luma
Spatial-aware video generation
Suno
AI music generation from text
ElevenLabs
Text-to-speech and voice AI
GPT
OpenAI chat and responses API
Claude
Anthropic messages API
DeepSeek
Budget LLM with reasoning
Gemini
Google AI models, no GCP needed
Nano Banana
Google image generation with text rendering
Midjourney
Midjourney image generation, editing, and image-to-video
Ideogram V3
Typography-focused image generation
Recraft
Vector art and image upscaling
Flux 2
BFL image generation, pro and flex
GPT Image
OpenAI image generation and editing
Hermes Agent setup questions
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.
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.
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.
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.
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.
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.
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.