Подключение собственного ключа модели
Используйте ключ поставщика модели или шлюза. Для успешного подключения должны совпадать поставщик, конечная точка, ID модели и разрешения аккаунта.
Соберите данные для подключения
Вам понадобятся API-ключ сервиса, к которому вы планируете обращаться, его базовый URL API, доступный ID модели и совместимый протокол или предустановка. Наличие аккаунта на пользовательском сайте с чатом само по себе не предоставляет доступ к API или кредиты API.
Все тарифы, включая Free, поддерживают BYOK. Для ключа поставщика используются тарифы и лимиты этого поставщика, а не баланс OpenDesign.
Добавьте поставщика
- Откройте Settings (Настройки) → Models & providers (Модели и поставщики) → API providers (Поставщики API).
- Выберите предустановку сервиса, выпустившего ваш ключ. Для Custom provider (Пользовательский поставщик) укажите протокол, задокументированный этим сервисом.
- Вставьте в API Key только секретный ключ. Не добавляйте Bearer, кавычки или обёртку конфигурации JSON.
- Проверьте Base URL. Если адрес в предустановке заблокирован для редактирования, выберите вариант с пользовательским URL, прежде чем вводить другую конечную точку.
- Выберите модель из списка доступных или введите точный ID модели API в разделе Custom. Загрузка моделей зависит от сервиса и аккаунта.
- Запустите Test (Проверка). Прочитайте ответ: успешная проверка подтверждает выполнение этого небольшого запроса, а не работу всех инструментов, моделей для медиаконтента или будущих запросов.
- Дождитесь подтверждения сохранения. Снова откройте настройки, чтобы проверить поставщика, адрес и модель, затем вернитесь в проект и выберите это подключение перед отправкой небольшой задачи.
Храните ключ в секрете. Для локальной проверки содержимое поля можно показать с помощью Show (Показать); скройте ключ перед публикацией снимка экрана.
Пример: DeepSeek
Создайте ключ на платформе DeepSeek. Используйте https://api.deepseek.com в качестве базового URL и выберите модель, которую может вызывать ваш аккаунт. Используйте ID из актуального списка моделей поставщика, например deepseek-flash; снимок экрана установленного клиента всё ещё содержит более старый псевдоним предустановки. При необходимости введите текущий ID как пользовательскую модель. В установленной версии 0.25.0 кнопка Get key (Получить ключ) может открыть страницу не того поставщика. Используйте собственную консоль поставщика, а не создавайте не связанный с ним ключ OpenAI.
| Поле | Пример прямого подключения DeepSeek |
|---|---|
| Поставщик / протокол | Предустановка DeepSeek или пользовательская предустановка, совместимая с протоколом OpenAI |
| API Key | Ключ, выпущенный для вашего аккаунта DeepSeek Platform |
| Base URL | https://api.deepseek.com |
| ID модели | deepseek-flash, если эта модель включена для вашего аккаунта |
Скопируйте точный ID из актуальной документации DeepSeek API, а не отображаемое имя со старого снимка экрана. В этом примере с протоколом OpenAI не используйте отдельную конечную точку /anthropic.
Пример: OpenRouter
Создайте ключ в настройках ключей OpenRouter. Используйте https://openrouter.ai/api/v1. Скопируйте ID модели из списка доступных моделей OpenRouter вместе с префиксом поставщика. Не вставляйте прямой ключ Anthropic или OpenAI в предустановку OpenRouter. Ключ должен принадлежать шлюзу, который получает запрос.
- Выберите OpenRouter в API providers и вставьте ключ, выпущенный OpenRouter.
- Используйте https://openrouter.ai/api/v1 в качестве Base URL.
- Скопируйте точный ID модели из каталога моделей OpenRouter вместе с префиксом поставщика.
- Проверьте подключение, дождитесь сохранения и выберите его в проекте перед выполнением запроса.
Проверка другого поставщика
| Параметр | Что проверить |
|---|---|
| Протокол | Предустановка должна соответствовать задокументированному протоколу API. |
| Base URL | Используйте корневой адрес API, ожидаемый предустановкой, без пути к панели управления или повторяющегося сегмента версии. |
| Модель | Используйте ID модели API, а не её маркетинговое название. |
| Разрешение | Проверьте в аккаунте поставщика доступ к модели, региональную доступность, квоту и оплату. |
Одного ключа недостаточно для среды выполнения
Для задач BYOK по-прежнему требуется поддерживаемая среда выполнения, которая обеспечивает операции агента с файлами и инструментами. Если приложение сообщает, что среда выполнения недоступна, следуйте инструкциям по её установке или повторному сканированию. Замена ключа не установит исполняемый файл.
Как работает оплата
Запросы BYOK оплачиваются через поставщика или шлюз, ключ которого вы ввели. Подписка OpenDesign и баланс внешнего поставщика не связаны друг с другом. Если с действительным ключом по-прежнему не удаётся выполнить задачу, см. разделы Оплата и Устранение неполадок подключения.
Изучите результат проверки и устраните проблему
| Результат | Следующее действие |
|---|---|
| 401 / недействительный ключ | Проверьте сервис, выпустивший ключ, и вставьте ключ полностью без дополнительного форматирования. Замените отозванный ключ в сервисе, где он был создан. |
| 403 / доступ запрещён | Проверьте у поставщика разрешение на модель, регион и доступ аккаунта. Одного действительного секретного ключа недостаточно для получения доступа к модели. |
| 404 / модель не найдена | Проверьте корневой адрес API и точный ID модели. Удалите пути к панели управления и повторяющиеся сегменты /v1. |
| 429 / квота или ограничение частоты запросов | Прочитайте сообщение об ошибке поставщика, чтобы отличить исчерпанный баланс от временного ограничения частоты запросов. Перед повторной попыткой проверьте консоль аккаунта. |
| Тайм-аут / сетевая ошибка | Проверьте, доступна ли эта конечная точка из среды клиента. После устранения сетевой проблемы повторите небольшой запрос. |
После успешной проверки отправьте один небольшой запрос в существующем проекте и проверьте ответ и все созданные файлы. Если проверка проходит успешно, но операции с файлами завершаются с ошибкой, проверьте среду выполнения, описанную в соответствующем разделе; не заменяйте повторно рабочий ключ.