---
title: "Use RunAPI no Hermes Agent - Guia de endpoint personalizado"
url: "https://runapi.ai/pt-BR/hermes-agent.md"
canonical: "https://runapi.ai/pt-BR/hermes-agent"
locale: "pt-BR"
---

# RunAPI in Hermes Agent

Hermes Agent pode usar um endpoint personalizado compatível com OpenAI para modelos de chat. Copie o prompt no Hermes Agent, deixe ele criar o custom provider e use a aba de configuração só quando precisar do YAML exato.

## Install prompt

Copy this prompt into Hermes Agent:

```text
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.
```

## Configuration

```yaml
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
```

## Steps

1. **Cole o prompt de setup** — Copie o prompt da primeira aba para o Hermes Agent. Ele orienta o Hermes Agent a ler RUNAPI_API_KEY e adicionar RunAPI como provider personalizado nomeado.
2. **Revise a configuração gerada** — Hermes Agent deve definir provider como custom:runapi e usar gpt-5.2 como padrão, com key_env apontando para RUNAPI_API_KEY.
3. **Execute diagnósticos** — Execute hermes doctor depois de editar a configuração, então abra Hermes Agent e envie um prompt curto de teste antes de usar em uma tarefa maior.

## FAQ

### Hermes Agent pode usar RunAPI como endpoint personalizado?

Sim. Hermes Agent suporta seleção de modelos e endpoints personalizados. Configure o provider personalizado nomeado com a base URL /v1 da RunAPI, mantenha a API key em RUNAPI_API_KEY e selecione um modelo RunAPI como gpt-5.2.

### Devo usar hermes model ou editar o arquivo de configuração?

Use hermes model quando quiser o seletor guiado. Edite o arquivo de configuração quando precisar de um setup repetível para servidor ou ambiente compartilhado. Nos dois casos, verifique depois com hermes doctor.

### Onde RUNAPI_API_KEY deve ser definida para Hermes Agent?

Defina RUNAPI_API_KEY no mesmo shell, service unit ou ambiente gateway que inicia Hermes Agent. Inicializações via GUI ou daemon nem sempre herdam variáveis do shell interativo.

### Hermes Agent ainda pode usar outros providers depois de adicionar RunAPI?

Sim. Adicionar RunAPI como custom:runapi não remove outras opções de modelo do Hermes Agent. Use hermes model ou o comando /model quando quiser alternar entre modelos configurados.


## Links

- [Model catalog](https://runapi.ai/pt-BR/models)
- [CLI](https://runapi.ai/pt-BR/cli)
- [MCP Server](https://runapi.ai/pt-BR/mcp)
- [Pricing](https://runapi.ai/pt-BR/pricing)
- [API docs](https://runapi.ai/pt-BR/docs)
- [OpenClaw setup](https://runapi.ai/pt-BR/openclaw)