Cherry Studio

Используйте точные значения протокола ниже, перезапустите клиент после сохранения и выполните один короткий приватный запрос перед включением длительной работы, tools или media.

Перед началом

Устанавливайте текущую версию клиента только от официального издателя. Перед изменением локальной конфигурации создайте отдельный API Key в консоли; не используйте повторно личный, общий или production Key.

Windows, macOS и Linux

• Windows: используйте текущий установщик Windows или процедуру PowerShell и закройте все процессы клиента после изменения конфигурации.
• macOS: используйте подписанное приложение или официальный установщик терминала для вашего CPU; настройки в домашнем каталоге принадлежат этому пользователю macOS.
• Linux / WSL: следуйте актуальным инструкциям дистрибутива или официального CLI; WSL читает домашний каталог Linux, а не профиль Windows.

Выбор модели

Вызовите GET /v1/models отдельным Key и выберите один возвращённый data[].id. Список для конкретного Key является источником истины; старая конфигурация, статья или выбор клиента не гарантирует доступ.

Настройка

Provider protocol: OpenAI-compatible
Base URL:          https://ai.tavonilo.com/v1
API key:           sk-your-own-key
Model ID:           copy one id from GET /v1/models

Проверка

Проверьте Key через /v1/models, выполните один небольшой запрос без чувствительных данных и сохраняйте для поддержки только время, маршрут, модель, HTTP-статус и request ID. Тайм-аут не доказывает, что тарифицируемая генерация не была обработана, поэтому не повторяйте вслепую длинные или графические запросы.

Безопасное восстановление

• 401: замените неполный, отозванный или неверный Key; не вставляйте его в обращение в поддержку.
• 403: проверьте группу Key, видимость модели, баланс и право на маршрут.
• 404: используйте указанный здесь Base URL, а не полный endpoint, и не добавляйте /v1 дважды.
• 429: ставьте работу в очередь и соблюдайте Retry-After, если он есть; не повторяйте пакет параллельно.
• 5xx или timeout: ограниченно повторяйте только безопасную операцию. Сохраняйте время, маршрут, модель, HTTP status и request ID в обезличенных логах.

Граница учётных данных

Используйте отдельную Key для каждого устройства или нагрузки. Никогда не отправляйте поддержке API Key, auth.json, полный закрытый prompt, пароль, код подтверждения или платежные данные; при подозрении на утечку немедленно отзовите и замените Key.

Связанная документация

• Модели и цены
• Список моделей
• undefined