kosareva.cloud

Настройка: ключ, base URL, прокси и VPN

Три вещи, которые вписывают чаще всего и чаще всего вписывают не туда: ключ, адрес и сеть, через которую идёт запрос.

/ Коротко

Три поля, которые чинят почти всё

Почти любая настройка нейросетевого API сводится к трём полям. Ключ: строка вида sk-…, которую инструмент передаёт в заголовке Authorization. Base URL: адрес сервера, у OpenAI это https://api.openai.com/v1, у совместимых сервисов свой, и ошибка чаще всего в том, есть ли в конце /v1. Имя модели: точная строка из каталога провайдера, любая опечатка даёт 404 или model not found.

Четвёртое поле, о котором забывают, это сеть, и именно она даёт самые непонятные ошибки. Если запрос идёт через VPN или прокси, провайдер видит чужой IP и может ответить 403, а SDK, не найдя настроек прокси, отдаёт connection error. На страницах раздела: где эти поля лежат в каждом инструменте, как проверить их одной командой curl, что делать, если ключ верный, а ответ всё равно 401, и когда VPN мешает, а не помогает. Порядок проверки один и тот же: сначала curl с ключом напрямую, потом тот же ключ в инструменте.

/ FAQ

Частые вопросы

Ключ верный, адрес верный, всё равно 401, что ещё?

Пробел или перенос строки в конце ключа, ключ от другого сервиса, переменная окружения OPENAI_API_KEY, которая перекрывает поле в настройках. Проверьте curl с тем же ключом.

Нужен ли /v1 в base URL?

Зависит от инструмента: одни добавляют /v1 сами, другие нет. Если после смены адреса пришёл 404, попробуйте с /v1 и без.

Можно ли хранить ключ в файле проекта?

Лучше в переменной окружения или в хранилище секретов редактора. Ключ в репозитории рано или поздно утечёт, и провайдер его отзовёт.

Ключ, который работает из России

OpenAI-совместимый адрес, оплата в рублях, ключ сразу после регистрации. Пополнение картой от 50 ₽.

Получить ключ