> For the complete documentation index, see [llms.txt](https://docs.cherryai.com.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cherryai.com.cn/docs/russian/pre-basic/providers/zi-ding-yi-fu-wu-shang.md).
# Пользовательский провайдер
Cherry Studio не только интегрирует основные сервисы AI-моделей, но и предоставляет вам мощные возможности настройки. С помощью **Пользовательский AI‑провайдер** функции вы можете легко подключить любую нужную вам AI-модель.
## Зачем нужен пользовательский AI‑провайдер?
* **Гибкость:** Больше никаких ограничений списком предустановленных провайдеров — свободно выбирайте AI-модель, которая лучше всего подходит вашим задачам.
* **Разнообразие:** Пробуйте AI-модели с разных платформ и открывайте их уникальные преимущества.
* **Контролируемость:** Непосредственно управляйте своими API-ключами и адресами доступа, обеспечивая безопасность и конфиденциальность.
* **Настраиваемость:** Подключайте модели с приватным развертыванием, чтобы удовлетворять требованиям конкретных бизнес-сценариев.
## Как добавить пользовательского AI‑провайдера?
Всего за несколько простых шагов вы можете добавить своего пользовательского AI‑провайдера в Cherry Studio:
1. **Откройте настройки:** В левой панели навигации интерфейса Cherry Studio нажмите «Настройки» (значок шестерёнки).
2. **Перейдите в сервисы моделей:** На странице настроек выберите вкладку «Сервисы моделей».
3. **Добавьте провайдера:** На странице «Сервисы моделей» вы увидите список уже существующих провайдеров. Нажмите кнопку «+ Добавить провайдера» под списком, чтобы открыть окно «Добавить пользовательского провайдера».
4. **Заполните информацию:** В окне вам нужно заполнить следующую информацию:
* **Название провайдера:** Дайте вашему пользовательскому провайдеру легко узнаваемое название (например: MyCustomOpenAI).
* **API-ключ** API-ключ, полученный от вашего провайдера.
* **Настройка эндпоинтов** По умолчанию можно добавить **OpenAI** и **Anthropic** эндпоинты. Вы также можете нажать «Дополнительные настройки», чтобы добавить **OpenAI Responses**、**Gemini**、**Base URL для генерации изображений** и **Base URL для редактирования изображений**. Cherry Studio будет отправлять запросы на эндпоинт.
{% hint style="warning" %}
Обязательно ознакомьтесь с официальной документацией вашего AI-провайдера, чтобы получить правильные API-эндпоинты и ключи.
{% endhint %}
{% hint style="info" %}
Вы также можете в «Дополнительных настройках» выбрать создание из пресета — это подходит для подключения Coding Plan, управления несколькими аккаунтами или изоляции проектов; эндпоинт и API Key можно настраивать независимо.
{% endhint %}
6. **Сохраните конфигурацию:** После заполнения нажмите кнопку «Добавить», чтобы сохранить вашу конфигурацию.
## Настройка пользовательского AI‑провайдера
После добавления найдите только что добавленного провайдера в списке и выполните детальную настройку:
1. **Статус включения** В списке пользовательских провайдеров справа от уже включённого провайдера отображается зелёная точка. Вы можете включать или отключать этот провайдер в правом верхнем углу страницы провайдера.
2. **Управление моделями:**
* Нажмите кнопку «Получить список моделей» — Cherry Studio попытается получить список моделей от вашего провайдера; после успешного получения можно добавлять и удалять модели.
* Нажмите кнопку «+», чтобы вручную добавить ID модели, которую вы хотите использовать у этого провайдера. Например `gpt-5.6-sol`、`gemini-3.7-flash` и т. д.
* Если вы не уверены в точном названии модели, обратитесь к официальной документации вашего AI-провайдера.
* Вы можете нажать «-» справа от модели, чтобы удалить её, а также кнопку настроек, чтобы изменить название модели, тип, цену и другие данные.
## Начать использование
После завершения всех настроек вы сможете в интерфейсе чата Cherry Studio выбрать своего пользовательского AI‑провайдера и модель и начать общение с AI!
## Использование vLLM в качестве пользовательского AI‑провайдера
vLLM — это быстрый и удобный для использования библиотечный движок инференса LLM, похожий на Ollama. Ниже приведены шаги по интеграции vLLM в Cherry Studio:
1. **Установите vLLM:** Следуйте официальной документации vLLM () для установки vLLM.
```sh
pip install vllm # если вы используете pip
uv pip install vllm # если вы используете uv
```
2. **Запуск сервиса vLLM:** Запустите сервис с использованием OpenAI-совместимого интерфейса, предоставляемого vLLM. Есть два основных способа, они следующие:
* Используйте `vllm.entrypoints.openai.api_server` для запуска
```sh
python -m vllm.entrypoints.openai.api_server --model gpt2
```
* Используйте `uvicorn` для запуска
```sh
vllm --model gpt2 --served-model-name gpt2
```
Убедитесь, что сервис успешно запущен и слушает на порту по умолчанию `8000` на. Конечно, вы также можете с помощью параметра `--port` указать номер порта для сервиса vLLM.
3. **Добавление провайдера vLLM в Cherry Studio:**
* Следуя шагам, описанным выше, добавьте в Cherry Studio нового пользовательского AI‑провайдера.
* **Название провайдера:** `vLLM`
* **Тип провайдера:** Выберите `OpenAI`.
4. **Настройка провайдера vLLM:**
* **API-ключ:** Поскольку vLLM не требует API-ключа, это поле можно оставить пустым или заполнить любым содержимым.
* **API-адрес:** Укажите API-адрес сервиса vLLM. По умолчанию адрес: `http://localhost:8000/`(если вы используете другой порт, измените его соответствующим образом).
* **Управление моделями:** Добавьте название модели, загруженной в vLLM. В приведённом выше примере следует указать здесь `python -m vllm.entrypoints.openai.api_server --model gpt2` В приведённом выше примере следует указать здесь `gpt2`
5. **Начать диалог:** Теперь вы можете в Cherry Studio выбрать провайдера vLLM и `gpt2` модель и начать диалог с LLM, работающей на vLLM!
## Советы и хитрости
* **Внимательно прочитайте документацию:** Перед добавлением пользовательского провайдера обязательно внимательно прочитайте официальную документацию используемого вами AI‑провайдера, чтобы понять ключевые сведения: API-ключ, адрес доступа, название модели и т. д.
* **Проверьте API-ключ:** Кнопка «Проверить» позволяет быстро проверить действительность API-ключа и избежать невозможности использования из-за ошибки в ключе.
* **Обратите внимание на API-адрес:** У разных AI‑провайдеров и моделей API-адрес может отличаться, поэтому обязательно указывайте правильный адрес.
* **Добавляйте модели по необходимости:** Добавляйте только те модели, которые вы действительно будете использовать, чтобы избежать лишних ненужных моделей.
***
### Получить помощь и отправить отзыв
Если у вас возникнут какие-либо вопросы, ошибки или предложения по улучшению функций в процессе настройки или использования, пожалуйста, обратитесь к [Отзывы и предложения](/docs/russian/question-contact/suggestions.md) в официальные каналы, указанные там.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.cherryai.com.cn/docs/russian/pre-basic/providers/zi-ding-yi-fu-wu-shang.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
%20(5).png?alt=media)
%20(5)%20(1).png?alt=media)
%20(5).png?alt=media)