Клиенты, совместимые с OpenAI
Настольные клиенты, такие как Cherry Studio, можно настроить как общий OpenAI-compatible provider, если их текущая версия поддерживает пользовательские Base URL и Key. Это ручной путь совместимости, а не сертификация поставщика: используйте /v1, синхронизируйте или добавляйте только видимые ID и сначала проверьте короткий чат.
Перед началом
Устанавливайте текущую версию клиента только от официального издателя. Перед изменением локальной конфигурации создайте отдельный 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 является источником истины; старая конфигурация, статья или выбор клиента не гарантирует доступ.
Настройка
from openai import OpenAI
client = OpenAI(api_key="sk-your-own-key", base_url="https://ai.tavonilo.com/v1")
print(client.chat.completions.create(
model="your-console-model",
messages=[{"role": "user", "content": "Reply with connected."}],
).choices[0].message.content)Проверка
Проверьте 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.