Skip to main content

Провайдер OpenAI

💡TL;DR

OpenAI использует общий транспорт, совместимый с OpenAI. Текущий предустановленный режим по умолчанию — gpt-4o, https://api.openai.com/v1, temperature: 0.5 и тест подключения models-then-chat. Используйте эту страницу, когда вам нужна точная семантика полей; для выбора по категориям используйте обзор LLM Провайдеры.

Это часть Obsidian Руководства по управлению знаниями с ИИ.

Настройка

Создайте ключ OpenAI API, добавьте профиль провайдера OpenAI в настройках Notemd и оставьте значение Base URL по умолчанию, если только вы не намеренно не указываете на шлюз, совместимый с OpenAI. Поле модели может оставаться gpt-4o для общей работы или быть заменено другим идентификатором модели OpenAI, доступным в вашем аккаунте.

Для контроля затрат используйте модели, предназначенные для конкретных задач: храните более мощные модели для исследований, извлечения концепций и структурирования длинных текстов; используйте более дешевые или быстрые модели для перевода, предложений ссылок и кратких резюме.

Конец и аутентификация

ПолеТекущий предустановленный режим
Транспортopenai-compatible
Ключ APIТребуется
Base URLhttps://api.openai.com/v1
По умолчанию модельgpt-4o
Температура0.5
Тест подключения/models, затем /chat/completions

Notemd нормализует базовые URL, совместимые с OpenAI, перед добавлением chat/completions или models. Не включайте завершающий /chat/completions в Base URL; это приводит к дублированию пути.

Обнаружение моделей

OpenAI использует универсальный путь обнаружения моделей, совместимый с OpenAI. Настройки UI сначала запрашивают /v1/models, затем проверяют выбранную модель с помощью легкого запроса в чате. Если обнаружение не удалось, но чат продолжает работать, проверьте, есть ли у вашего ключа разрешение на список моделей или блокирует ли шлюз отображение списка моделей.

Модели для рассуждений рассматриваются как особый случай протокола: Notemd объединяет содержимое системных и пользовательских запросов для получения идентификаторов рассуждений OpenAI, которые отклоняют отдельную роль system, и они отображаются reasoningEffort только там, где это поддерживается определением провайдера.

Устранение неполадок

  • 401 или 403: проверьте ключ, доступ к проекту, статус оплаты и то, включена ли выбранная модель для этого ключа.
  • 404 в чате: Base URL обычно неверен или уже содержит /chat/completions.
  • Модель указана в документации, но отсутствует в списке: доступ к списку моделей и доступ к чату — это разные причины сбоя; вручную проверьте точный идентификатор модели в профиле провайдера.
  • Модель для рассуждений отклоняет сообщения: используйте идентификатор модели, охватываемый путем обработки рассуждений OpenAI, или переключитесь на модель чата без рассуждений.

Когда использовать

Используйте OpenAI, когда вам нужен наиболее предсказуемый стандартный хостинговый путь, когда важно обнаружение /v1/models или когда рабочий процесс зависит от семантики модели рассуждений OpenAI. Предпочтите шлюз или локального провайдера, когда важнее маршрутизация, конфиденциальность или контроль затрат, чем прямое поведение OpenAI API.


Следующие шаги

  • LLM Providers -- Полная конфигурация, модели для каждой задачи и логика повторных попыток
  • Устранение неполадок -- Исправление ошибок 401/403 и ограничений по скорости