Аутентификация

Безопасно аутентифицируйте каждый поддерживаемый API-протокол с помощью ключа API AnyInt.

Каждый запрос к Developer API требует активного ключа API AnyInt. Используйте заголовок, ожидаемый вашим клиентским протоколом, чтобы существующие SDK OpenAI, Anthropic и Gemini продолжали работать.

Рекомендуемая аутентификация по протоколу

ПротоколРекомендуемый вводКанонический базовый URL API
Совместимо с OpenAIAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/openai/v1
Сообщения Anthropicx-api-key: <AnyInt API Key>https://api.anyint.ai/anthropic/v1
Gemini Developer APIx-goog-api-key: <AnyInt API Key>https://api.anyint.ai/gemini/v1beta
Асинхронные медиаAuthorization: Bearer <AnyInt API Key>https://api.anyint.ai/v1/async-tasks

Для совместимости с клиентами шлюз также принимает заголовки ключей AnyInt, поддерживаемые всеми семействами протоколов, и принимает параметр запроса Gemini key в маршрутах Gemini. Предпочитайте заголовки, чтобы учетные данные не отображались в URL-адресах или промежуточных журналах.

Шлюз потребляет учетные данные AnyInt перед маршрутизацией к поставщику. Он никогда не пересылает эти учетные данные в качестве ключа поставщика вышестоящему поставщику. Недействительные, истекшие или отозванные ключи завершаются с ошибкой.

Создание ключа

Создайте ключ API в Console, затем сохраните его в менеджер секретов на стороне сервера или в переменной окружения.

Недавно выданные ключи AnyInt используют префикс sk-, за которым следуют 52 символа Base64URL (всего 55 символов). Существующие ключи ak_ остаются действительными до тех пор, пока вы их не замените или не отключите. Всегда копируйте полное значение, показанное в Console; не добавляйте и не удаляйте префикс самостоятельно.

bash
export ANYINT_API_KEY="your_api_key"

Рекомендации по безопасности

  • Храните ключи в менеджере секретов на стороне сервера или в переменной окружения.
  • Никогда не помещайте ключ в клиентский JavaScript, систему контроля версий, журналы или URL-адреса.
  • Используйте отдельный ключ для каждого приложения и окружения.
  • Немедленно замените ключ, если он мог быть скомпрометирован.
  • Не пересылайте ключи AnyInt вышестоящим поставщикам.

Тестирование аутентификации

Перечислите модели, чтобы проверить ключ перед отправкой запроса на вывод.

bash
curl "https://api.anyint.ai/openai/v1/models" \
  --header "Authorization: Bearer $ANYINT_API_KEY"

Ошибка аутентификации возвращает HTTP 401 с ошибкой в формате протокола. Действительный ключ все еще может получить 402 из-за недостаточного баланса или 503, когда нет доступных подходящих поставщиков.