Hermes Agent에서 RunAPI를 사용하세요.
Hermes Agent는 채팅 모델용 OpenAI 호환 사용자 지정 endpoint를 사용할 수 있습니다. Prompt를 Hermes Agent에 붙여넣고 custom provider 생성을 맡기세요. 정확한 YAML이 필요할 때만 config 탭을 사용하면 됩니다.
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
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 형식을 사용합니다. |
하나의 엔드포인트로 이미지, 영상, 음악까지.
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를 제공합니다.
InfiniteTalk
오디오로 디지털 휴먼 영상 생성
Grok Imagine
xAI 이미지 및 영상 생성
Flux Kontext
텍스트 기반 이미지 편집
Z Image
빠른 이중 언어 이미지 생성
Topaz
AI 이미지 및 영상 초고해상도
Imagen 4
Google 이미지 생성
Seedream
Bytedance 4K 이미지 생성
Qwen 2 Image
알리바바 이미지 생성 및 편집
Kling
모션 제어와 사운드가 있는 비디오 생성
Veo 3
네이티브 오디오가 있는 Google 시네마틱 비디오
Seedance
Bytedance의 저비용 비디오 생성
Hailuo
무료 일일 할당량이 있는 MiniMax 비디오
Wan
오픈소스 비디오 및 이미지 생성
Runway
카메라 제어가 있는 크리에이티브 비디오
Luma
공간 인식 비디오 변환
Suno
텍스트로 AI 음악 생성
ElevenLabs
텍스트 음성 변환 및 음성 AI
GPT
OpenAI 채팅 및 응답 API
Claude
Anthropic 메시지 API
DeepSeek
추론 기능이 있는 저비용 LLM
Gemini
GCP 없이 Google AI 모델 사용
Nano Banana
텍스트 렌더링이 뛰어난 Google 이미지 생성
Midjourney
Midjourney AI 이미지 생성, 이미지 편집, 이미지 투 비디오
Ideogram V3
타이포그래피 중심 이미지 생성
Recraft
벡터 아트 및 이미지 화질 개선
Flux 2
BFL 이미지 생성, Pro 및 Flex
GPT Image
OpenAI 이미지 생성 및 편집
Hermes Agent 설정 질문
네. Hermes Agent는 모델 선택과 사용자 지정 endpoint를 지원합니다. 이름 있는 custom provider에 RunAPI /v1 base URL을 설정하고, API key는 RUNAPI_API_KEY에 두고, gpt-5.2 같은 RunAPI 모델을 선택하세요.
안내형 선택기를 원하면 hermes model을 사용하세요. 서버나 공유 환경에서 반복 가능한 설정이 필요하면 config 파일을 편집하세요. 두 경우 모두 이후 hermes doctor로 확인하는 것이 좋습니다.
Hermes Agent를 실행하는 같은 shell, service unit 또는 gateway 환경에 RUNAPI_API_KEY를 설정하세요. GUI 또는 daemon 실행은 대화형 shell 변수를 항상 상속하지는 않습니다.
네. RunAPI를 custom:runapi로 추가해도 다른 Hermes Agent 모델 옵션은 제거되지 않습니다. 설정된 모델 사이를 전환하려면 hermes model 또는 /model 명령을 사용하세요.
Hermes Agent 안에서 하나의 RunAPI key를 사용하세요.
카탈로그에서 모델을 선택하고 사용자 지정 endpoint를 설정한 뒤 다음 agent 실행 전에 Hermes Agent를 확인하세요.