> ## 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.

# Посібник з налаштування користувацької моделі WorkBuddy

> 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. Додавання моделі

У WorkBuddy перейдіть до **Налаштування → Моделі → Користувацькі моделі → Додати модель**, а потім заповніть:

| Поле | Значення |
| - | - |
| Provider | `Custom` |
| Адреса інтерфейсу | `https://api.acedata.cloud/v1` |
| API Key | Щойно скопійований API Key |
| Назва моделі | Перейдіть до [каталогу моделей](https://platform.acedata.cloud/models), перегляньте та без змін заповніть назву моделі, яку потрібно викликати, наприклад `claude-opus-5`、`gpt-6-sol` |
| Користувацький протокол | Вимкнено |

![Інтерфейс налаштування WorkBuddy Custom Provider](https://cdn.acedata.cloud/189027b68722.png)

> `id` тут — це назва моделі, яку використовує параметр `model` в API-запиті, а не UUID сервісу, API або Application, і не користувацька відображувана назва. Лише коли каталог у реальному часі повертає `{"id":"ds-4.0"}`, можна вказати `ds-4.0`; якщо його немає в каталозі, це означає, що він наразі недоступний, будь ласка, не вгадуйте та не скорочуйте.

Спочатку можна переглянути доступні моделі в [каталозі моделей](https://platform.acedata.cloud/models); якщо потрібно підтвердити точну назву, яку можуть викликати поточні Coding credentials, використайте щойно скопійований API Key для запиту до API-каталогу:

```bash theme={null}
curl https://api.acedata.cloud/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"
```

У масиві `data` у відповіді знайдіть цільову модель і без змін скопіюйте значення її `id`. Перемикачі можливостей налаштовуйте відповідно до фактичної підтримки цієї моделі.

Якщо залишити «Користувацький протокол» вимкненим, WorkBuddy доповнюватиме шлях відповідно до правил OpenAI Chat Completions. Перемикачі розширених можливостей (інструменти, зображення, міркування) вмикайте лише згідно з фактичними можливостями вибраної моделі; якщо не впевнені, спочатку залиште значення за замовчуванням.

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

Після збереження виберіть щойно додану модель у селекторі моделей чату та надішліть `Reply only OK`. Потім виконайте ще раз завдання лише для читання файлу або інструменту, щоб підтвердити доступність потрібних можливостей; записи викликів можна переглянути в [історії використання](https://platform.acedata.cloud/console/usages).

Якщо модель не з’являється, переконайтеся, що конфігурацію збережено й увімкнено; для 401 перевірте Key; для 404 перевірте, чи назва моделі, яку ви ввели, повністю збігається з `id` у каталозі, а також чи правильна адреса інтерфейсу. В офіційному описі WorkBuddy зазначено, що Key зберігається в локальній конфігурації, але вміст запитів усе одно надсилається до налаштованого сервісу моделі.

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

* [WorkBuddy](https://www.codebuddy.cn/workbuddy)
* [Налаштування моделі WorkBuddy](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Model)


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