> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# Посібник з ручного налаштування Hermes Agent

> AceDataCloud Coding Plan API guide - Ace Data Cloud

## 1. Отримання API Key

Відкрийте [список застосунків Ace Data Cloud](https://platform.acedata.cloud/console/applications), перейдіть до доступного застосунку та скопіюйте API Key.

![Отримання Ace Data Cloud API Key](https://cdn.acedata.cloud/dvc3cg.jpg)

## 2. Збереження Key

У `~/.hermes/.env` запишіть:

```dotenv theme={null}
ACEDATACLOUD_API_KEY=ваш API Key
```

## 3. Налаштування Provider

Додайте до `~/.hermes/config.yaml`:

```yaml theme={null}
providers:
  acedatacloud:
    api: https://api.acedata.cloud/v1
    key_env: ACEDATACLOUD_API_KEY
    transport: chat_completions
    default_model: MODEL_ID

model:
  provider: custom:acedatacloud
  default: MODEL_ID
```

Перейдіть до [каталогу моделей](https://platform.acedata.cloud/models), щоб переглянути назви моделей (наприклад, `claude-opus-5`, `gpt-6-sol`), і замініть усі `MODEL_ID` на одну й ту саму назву; для точної перевірки орієнтуйтеся на значення `id` у відповіді `/v1/models`. Це значення є назвою моделі, яку використовує параметр API `model`, а не UUID сервісу чи API. Не записуйте справжній Key у YAML і не додавайте `.env` до комітів.

## 4. Перевірка

```bash theme={null}
hermes config check
hermes -z "Reply only OK" --provider custom:acedatacloud --model MODEL_ID --ignore-rules
```

Якщо повертається 401, перевірте `~/.hermes/.env`; якщо конфігурація не застосувалася, повністю вийдіть і перезапустіть Hermes.

## Офіційні посилання

* [Налаштування Hermes](https://hermes-agent.nousresearch.com/docs/user-guide/configuration/)
* [Hermes Providers](https://hermes-agent.nousresearch.com/docs/integrations/providers/)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.