> ## 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-учётные данные, затем используйте только что скопированный 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.