Как подключить Cherry Studio к API429

Создайте отдельного провайдера

В существующей установке откройте Settings, затем Model Provider и Add Provider. Укажите понятное имя API429, чтобы не смешать соединение с другими ключами и моделями. В разделе Endpoint settings выберите OpenAI и введите корень https://gateway.api429.com без завершающего слеша. Для этой задачи нужен обычный текстовый протокол Chat Completions; дополнительные протоколы в диалоге создания провайдера не надо заполнять по аналогии.

Секрет внесите в предусмотренное приложение поле API Key и сохраните его. Лист ниже показывает только заглушку YOUR_API429_KEY, которую необходимо заменить своим значением при настройке. Не помещайте ключ в заметку с инструкцией, общий экспорт или снимок экрана. Если рабочее место доступно нескольким людям, отдельно определите, кто сможет пользоваться этим подключением: один сохранённый ключ не становится автоматически персональным для каждого пользователя компьютера.

Сверьте правила добавления пути

Для обычного корня справочник Cherry Studio описывает добавление /v1/chat/completions. Поэтому в этой инструкции поле OpenAI endpoint содержит https://gateway.api429.com, а итоговый предпросмотр должен показывать https://gateway.api429.com/v1/chat/completions. Не переносите сюда base URL с /v1 из инструкций для других клиентов без проверки результата. Ошибка в этом поле может выглядеть как неисправность модели, хотя запрос идёт на другой маршрут.

У завершающих символов есть особое значение: адрес с / дополняется только chat/completions; адрес с # используется как полный путь без добавления суффикса. Сравнение ниже показывает три документированных способа получить один итоговый URL. Для первого подключения используйте вариант с корнем. Не добавляйте # к неполному адресу и не считайте одиночный завершающий слеш косметическим: он меняет правило построения запроса.

Добавьте модель вручную и включите провайдера

В разделе Models выберите ручное добавление через кнопку + и задайте Model ID gemini-3.8-flash. Model Name и Group Name служат для отображения: используйте узнаваемые подписи, не изменяя отправляемый идентификатор. На первом этапе достаточно одной модели, чтобы случайно не проверить другой пункт. Автоматическая синхронизация списка — отдельное действие; ручная запись сама по себе не подтверждает доступ вашего ключа.

После сохранения включите переключатель провайдера: отключённое подключение может не показываться при выборе модели чата. Сверьте публичный каталог и отдельно авторизованный GET /v1/models для своего ключа. Если модель не видна, сначала проверьте включение, сохранение ручной записи и выбранного провайдера. Не повторяйте платную генерацию, пока не понятно, какая именно модель выбрана и какой адрес получится у запроса.

Начните с обычного короткого сообщения

Откройте новый чат без вложений, инструментов и поиска, выберите добавленный ID и задайте небольшой предел ответа max_tokens:256, если ваша версия позволяет выставить это поле. Для начальной проверки отключите потоковую выдачу. Контрольный JSON ниже описывает обычное тело API429 и не является импортируемым пресетом Cherry Studio. Подписи полей в листе настройки тоже являются памяткой для ручного ввода, а не внутренним форматом приложения.

Кнопка Model Check проверяет соединение на выбранной клиентом модели; документация указывает последнюю добавленную разговорную модель. Учитывайте такую проверку как потенциально платную генерацию и сначала проверьте её выбор. Не запускайте её многократно после ошибки. Отдельно сравните ответ и расход в кабинете API429. Дополнительные функции клиента могут вызывать другие обращения; без проверки вашей версии нельзя гарантировать одно обращение на одно действие.

Отделите чат от агентного сценария и бюджета

Cherry Agent — отдельный сценарий, который не подтверждается этим OpenAI-совместимым чат-подключением. Проверка текста также не доказывает инструменты, схемы ответа, медиа или расширенные режимы. max_tokens ограничивает длину ответа, но не устанавливает общий бюджет и не ограничивает общую стоимость всех сообщений. Входной контекст и дополнительные обращения тоже оплачиваются по действующим правилам. За точными ставками и единицами оплаты переходите к карточке модели и сравнению тарифов, сохраняя эту страницу владельцем настройки клиента.

Лист ручного ввода; не формат импорта Cherry Studio

{
  "provider_name": "API429",
  "openai_endpoint": "https://gateway.api429.com",
  "api_key": "YOUR_API429_KEY",
  "model_id": "gemini-3.8-flash",
  "model_name": "Gemini 3.8 Flash",
  "group_name": "API429",
  "enabled": true
}

Три правила построения маршрута по справочнику

[
  {
    "input": "https://gateway.api429.com",
    "final_url": "https://gateway.api429.com/v1/chat/completions"
  },
  {
    "input": "https://gateway.api429.com/v1/",
    "final_url": "https://gateway.api429.com/v1/chat/completions"
  },
  {
    "input": "https://gateway.api429.com/v1/chat/completions#",
    "final_url": "https://gateway.api429.com/v1/chat/completions"
  }
]

Контрольный текстовый контракт; не пресет Cherry Studio

{
  "model": "gemini-3.8-flash",
  "messages": [
    {
      "role": "user",
      "content": "Ответь одним предложением: что такое API?"
    }
  ],
  "max_tokens": 256,
  "stream": false
}

Оплата и тест $10

• Карта российского банка. Пополнение баланса в личном кабинете.
• Счёт для юрлиц. Безналичная оплата с закрывающими документами.
• USDT и TON. Пополнение криптовалютой.

Тест $10. Подпишитесь на наш Telegram-канал через бота — получите $10 на баланс для первых запросов. Получить $10 в боте