Utiliser RunAPI dans Hermes Agent.
Hermes Agent peut utiliser un endpoint personnalisé compatible OpenAI pour les modèles de chat. Copiez le prompt dans Hermes Agent, laissez-le créer le fournisseur personnalisé, puis utilisez l’onglet configuration seulement si vous avez besoin du YAML exact.
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
Installer RunAPI dans Hermes Agent avec un prompt
Coller le prompt de configuration
Copiez le prompt du premier onglet dans Hermes Agent. Il demande à Hermes Agent de lire RUNAPI_API_KEY et d’ajouter RunAPI comme fournisseur personnalisé nommé.
Copier le prompt
Vérifier la configuration générée
Hermes Agent doit définir provider sur custom:runapi et utiliser gpt-5.2 par défaut, avec key_env pointant vers RUNAPI_API_KEY.
provider: custom:runapi
Exécuter les diagnostics
Exécutez hermes doctor après avoir modifié la configuration, puis ouvrez Hermes Agent et envoyez un court prompt de test avant de l’utiliser pour une tâche plus importante.
hermes doctor
Champs de configuration
| Champ | Valeur | Objectif |
|---|---|---|
custom_providers.name |
runapi |
Crée un endpoint personnalisé nommé que Hermes Agent peut sélectionner comme custom:runapi. |
base_url |
https://runapi.ai/v1 |
Dirige Hermes Agent vers la surface API compatible OpenAI de RunAPI. |
key_env |
RUNAPI_API_KEY |
Lit la clé RunAPI depuis l’environnement au lieu de la coder en dur. |
api_mode |
chat_completions |
Utilise le format de requête chat compatible OpenAI. |
Un seul endpoint pour les images, la vidéo et la musique.
Les utilisateurs de Hermes Agent configurent souvent une instance ComfyUI à ~20 $/mois pour la génération d’images et de vidéos, ou construisent un bridge personnalisé pour la musique. RunAPI remplace tout cela — le même fournisseur custom:runapi et la même RUNAPI_API_KEY gèrent les requêtes d’images, de vidéo et de musique en plus du chat, sans plugins supplémentaires ni location de GPU.
Génération d’images
Appelez Flux Kontext, Imagen 4, Seedream, GPT Image et Nano Banana via l’endpoint RunAPI. Pas de configuration ComfyUI, pas de GPU cloud, pas de graphes de workflow — envoyez un prompt et recevez une URL d’image.
Parcourir les modèles d’imagesGénération de vidéos
Générez des vidéos à partir de texte ou d’images avec Kling 3.0, Seedance 2.0, Veo 3 et Wan 2.7. RunAPI gère le polling asynchrone et les callbacks avec le même format de tâche pour tous les modèles vidéo.
Parcourir les modèles vidéoGénération musicale
Accédez directement à Suno v4 jusqu’à v5.5 via RunAPI. Aucun service bridge tiers requis — transmettez paroles, style et durée, puis interrogez l’audio terminé.
Parcourir les modèles musicauxUtiliser n’importe quel modèle dans Hermes Agent
Chaque guide présente le prompt, la commande curl, les paramètres et la FAQ pour appeler un modèle spécifique via RunAPI dans Hermes Agent.
Claude
Text · Anthropic
DeepSeek
Text · DeepSeek
ElevenLabs
Audio & Music · ElevenLabs
Embedding
Text · OpenAI
Fish Audio
Audio & Music · Fish Audio
Flux
Image · Black Forest Labs
Flux 2
Image · Black Forest Labs
Flux Kontext
Image · Black Forest Labs
Gemini
Text · Google
Gemini Omni
Video · Google
Gemini TTS
Audio & Music · Google
GLM
Text · Z.ai
GPT
Text · OpenAI
GPT Image
Image · OpenAI
GPT Image 2
Image · OpenAI
GPT-4o Image
Image · OpenAI
Grok
Text · xAI
Grok Imagine
Video · xAI
Hailuo
Video · MiniMax
HappyHorse
Video · Alibaba
Ideogram V3
Image · Ideogram
Imagen 4
Image · Google
InfiniteTalk
Video · MeiGen-AI
Kimi
Text · Moonshot AI
Kling
Video · Kuaishou
Luma
Video · Luma
Midjourney
Utility · Midjourney
MiMo
Text · Xiaomi
MiniMax
Text · MiniMax
MiniMax H3
Video · MiniMax
Nano Banana
Image · Google
OmniHuman
Utility · Bytedance
OpenAI Transcription
Audio & Music · OpenAI
OpenAI TTS
Audio & Music · OpenAI
PixVerse
Video · PixVerse
Producer
Audio & Music · Producer
Qwen 2
Image · Alibaba
Qwen 3
Image · Alibaba
Qwen Image
Image · Alibaba
Recraft
Utility · Recraft
Runway
Video · Runway
Runway Aleph
Video · Runway
Seedance
Video · Bytedance
Seedream
Image · Bytedance
Suno
Audio & Music · Suno
Topaz
Utility · Topaz
Veo 3.1
Video · Google
Volcengine Lip Sync
Video · Bytedance
Wan
Video · Alibaba
Z Image
Image · Alibaba
Questions sur la configuration Hermes Agent
Oui. Hermes Agent prend en charge la sélection de modèles et les endpoints personnalisés. Configurez le fournisseur personnalisé nommé avec la base URL RunAPI /v1, gardez l’API key dans RUNAPI_API_KEY et sélectionnez un modèle RunAPI comme gpt-5.2.
Utilisez hermes model si vous voulez le sélecteur guidé. Modifiez le fichier de configuration si vous avez besoin d’un setup répétable pour un serveur ou un environnement partagé. Dans les deux cas, vérifiez ensuite avec hermes doctor.
Définissez RUNAPI_API_KEY dans le même shell, service unit ou environnement gateway qui lance Hermes Agent. Les lancements via GUI ou daemon n’héritent pas toujours des variables de votre shell interactif.
Oui. Ajouter RunAPI comme custom:runapi ne supprime pas les autres options de modèles Hermes Agent. Utilisez hermes model ou la commande /model pour changer entre les modèles configurés.
Une seule clé RunAPI dans Hermes Agent.
Choisissez un modèle dans le catalogue, définissez l’endpoint personnalisé et vérifiez Hermes Agent avant votre prochaine exécution d’agent.