Аутентификация
Где взять Base URL и как проходит аутентификация в каждом протоколе — Bearer, x-api-key, x-goog-api-key.
Каждый вызов требует двух вещей: API-ключа (подтверждает, кто вы) и Base URL (куда направляется запрос). И то, и другое доступно в консоли.
Получение Base URL
Войдите в консоль и откройте диалог «Быстрый старт» на любой карточке модели (или из обзора учётной записи). Выберите свой протокол в раскрывающемся списке и скопируйте соответствующий Base URL.
- Префиксы путей различаются между протоколами — всегда копируйте из диалога;
- В примерах в документации используется
https://<your-base-url>; замените его на ваш фактический адрес.
Аутентификация по протоколам
| Протокол | Заголовки аутентификации | Примечания |
|---|---|---|
| Совместимый с OpenAI | Authorization: Bearer YOUR_API_KEY | Работает с официальным SDK OpenAI — задайте api_key + base_url |
| Anthropic | x-api-key: YOUR_API_KEY + anthropic-version: 2023-06-01 | Заголовок версии обязателен; SDK отправляет его автоматически |
| Gemini | x-goog-api-key: YOUR_API_KEY | ID модели помещается прямо в путь URL |
Частые ошибки аутентификации
- 401 Unauthorized: ключ неверен, удалён или истёк. Проверьте, что используете полный ключ, сохранённый при создании, без лишних пробелов или переводов строки.
- Ключ раскрыт во фронтенд-коде: всё, что находится в браузерном коде, видно всем — ключи должны храниться на вашем сервере или в локальных переменных окружения.
- Перепутанные ключи: у каждого ключа свой лимит расходов; убедитесь, что используете правильный ключ для среды (продакшен / тестирование).
Информацию о создании и хранении ключей см. в разделе Создание API-ключа.