Hermes Agent에서 RunAPI를 사용자 지정 endpoint로 사용할 수 있나요?

네. Hermes Agent는 모델 선택과 사용자 지정 endpoint를 지원합니다. 이름 있는 custom provider에 RunAPI /v1 base URL을 설정하고, API key는 RUNAPI_API_KEY에 두고, gpt-5.2 같은 RunAPI 모델을 선택하세요.

hermes model을 사용해야 하나요, 아니면 config 파일을 편집해야 하나요?

안내형 선택기를 원하면 hermes model을 사용하세요. 서버나 공유 환경에서 반복 가능한 설정이 필요하면 config 파일을 편집하세요. 두 경우 모두 이후 hermes doctor로 확인하는 것이 좋습니다.

Hermes Agent용 RUNAPI_API_KEY는 어디에 설정해야 하나요?

Hermes Agent를 실행하는 같은 shell, service unit 또는 gateway 환경에 RUNAPI_API_KEY를 설정하세요. GUI 또는 daemon 실행은 대화형 shell 변수를 항상 상속하지는 않습니다.

RunAPI를 추가한 뒤에도 Hermes Agent에서 다른 provider를 사용할 수 있나요?

네. RunAPI를 custom:runapi로 추가해도 다른 Hermes Agent 모델 옵션은 제거되지 않습니다. 설정된 모델 사이를 전환하려면 hermes model 또는 /model 명령을 사용하세요.

Hermes Agent가 ComfyUI 대신 RunAPI로 이미지를 생성할 수 있나요?

네. RunAPI는 같은 /v1 엔드포인트에서 Flux Kontext, Imagen 4, GPT Image 등의 이미지 모델을 제공합니다. ComfyUI 클라우드 인스턴스나 GPU 대여가 필요 없습니다. Hermes Agent가 RunAPI를 직접 호출하고 응답으로 이미지 URL을 받습니다.

RunAPI는 Hermes Agent의 음악 생성을 지원하나요?

네. RunAPI는 음악 생성을 위한 Suno v4부터 v5.5까지의 직접 접근을 제공합니다. 같은 RUNAPI_API_KEY와 custom:runapi 공급자가 채팅, 이미지, 동영상과 함께 음악 요청도 처리하므로 별도의 중계 서비스나 API 키가 필요 없습니다.

Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

HERMES AGENT 가이드

Hermes Agent에서 RunAPI를 사용하세요.

Hermes Agent는 채팅 모델용 OpenAI 호환 사용자 지정 endpoint를 사용할 수 있습니다. Prompt를 Hermes Agent에 붙여넣고 custom provider 생성을 맡기세요. 정확한 YAML이 필요할 때만 config 탭을 사용하면 됩니다.

무료 API Key 받기 문서 읽기

Prompt 복사 · 하나의 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

설정

Prompt로 Hermes Agent에 RunAPI 설치

설정 Prompt 붙여넣기

첫 번째 탭의 Prompt를 Hermes Agent에 복사하세요. 이 Prompt는 Hermes Agent가 RUNAPI_API_KEY를 읽고 RunAPI를 이름 있는 custom provider로 추가하도록 지시합니다.

Prompt 복사

생성된 config 확인

Hermes Agent는 provider를 custom:runapi로 설정하고 기본값을 gpt-5.2로 두며 key_env가 RUNAPI_API_KEY를 가리키게 해야 합니다.

provider: custom:runapi

진단 실행

config를 수정한 뒤 hermes doctor를 실행하고, Hermes Agent를 열어 짧은 테스트 Prompt를 보낸 다음 더 큰 작업에 사용하세요.

hermes doctor

참고

설정 필드

필드	값	목적
`custom_providers.name`	`runapi`	Hermes Agent가 custom:runapi로 선택할 수 있는 이름 있는 사용자 지정 endpoint를 만듭니다.
`base_url`	`https://runapi.ai/v1`	Hermes Agent가 RunAPI의 OpenAI 호환 API 표면을 바라보게 합니다.
`key_env`	`RUNAPI_API_KEY`	RunAPI key를 하드코딩하지 않고 환경 변수에서 읽습니다.
`api_mode`	`chat_completions`	OpenAI 호환 chat request 형식을 사용합니다.

LLM 그 이상

하나의 엔드포인트로 이미지, 영상, 음악까지.

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에서 모든 모델 사용하기

각 가이드는 Hermes Agent에서 RunAPI를 통해 특정 모델을 호출하는 데 필요한 프롬프트, curl 명령, 파라미터, FAQ를 제공합니다.

Hermes Agent 설정 질문

Hermes Agent 안에서 하나의 RunAPI key를 사용하세요.

카탈로그에서 모델을 선택하고 사용자 지정 endpoint를 설정한 뒤 다음 agent 실행 전에 Hermes Agent를 확인하세요.

모델 보기 →

Hermes Agent에서 RunAPI를 사용하세요.

Prompt로 Hermes Agent에 RunAPI 설치

설정 Prompt 붙여넣기

생성된 config 확인

진단 실행

설정 필드

하나의 엔드포인트로 이미지, 영상, 음악까지.

이미지 생성

영상 생성

음악 생성

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

HeyGen Video

Ideogram V3

Imagen 4

InfiniteTalk

Jev

Kimi

Kling

Midjourney

MiMo

MiniMax

MiniMax H3

Nano Banana

OmniHuman

OpenAI Transcription

OpenAI TTS

PixVerse

Producer

Qwen

Qwen 2

Qwen 3

Qwen Image

Recraft

Runway

Seedance

Seedream

Suno

Topaz

Veo 3.1

Volcengine Lip Sync

Wan

Z Image