Аутентификация
Безопасно аутентифицируйте каждый поддерживаемый API-протокол с помощью ключа API AnyInt.
Каждый запрос к Developer API требует активного ключа API AnyInt. Используйте заголовок, ожидаемый вашим клиентским протоколом, чтобы существующие SDK OpenAI, Anthropic и Gemini продолжали работать.
Рекомендуемая аутентификация по протоколу
| Протокол | Рекомендуемый ввод | Канонический базовый URL API |
|---|---|---|
| Совместимо с OpenAI | Authorization: Bearer <AnyInt API Key> | https://api.anyint.ai/openai/v1 |
| Сообщения Anthropic | x-api-key: <AnyInt API Key> | https://api.anyint.ai/anthropic/v1 |
| Gemini Developer API | x-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; не добавляйте и не удаляйте префикс самостоятельно.
export ANYINT_API_KEY="your_api_key"Рекомендации по безопасности
- Храните ключи в менеджере секретов на стороне сервера или в переменной окружения.
- Никогда не помещайте ключ в клиентский JavaScript, систему контроля версий, журналы или URL-адреса.
- Используйте отдельный ключ для каждого приложения и окружения.
- Немедленно замените ключ, если он мог быть скомпрометирован.
- Не пересылайте ключи AnyInt вышестоящим поставщикам.
Тестирование аутентификации
Перечислите модели, чтобы проверить ключ перед отправкой запроса на вывод.
curl "https://api.anyint.ai/openai/v1/models" \
--header "Authorization: Bearer $ANYINT_API_KEY"Ошибка аутентификации возвращает HTTP 401 с ошибкой в формате протокола. Действительный ключ все еще может получить 402 из-за недостаточного баланса или 503, когда нет доступных подходящих поставщиков.
Устранение распространенных ошибок
Если запрос к API завершился сбоем, используйте эту таблицу для быстрого выявления причины и решения:
| HTTP-статус | Распространенная причина | Диагностика и решение |
|---|---|---|
| 401 Unauthorized | Недействительный или просроченный ключ API, либо отсутствует заголовок | Проверьте токен Bearer или заголовок x-api-key; убедитесь, что ключ активен в Ключи API в консоли. |
| 402 Payment Required | Недостаточный баланс или исчерпан месячный лимит бюджета | Пополните баланс в консоли или увеличьте месячный бюджетный лимит для ключа API. |
| 403 Forbidden | Ограничение по IP, несовпадение окружения или недостаточные права | Проверьте область действия ключа API и проверьте IP-адрес клиента по списку разрешенных IP. |
| 404 Not Found | Неверный путь к конечной точке или неизвестный идентификатор модели | Проверьте путь Base URL; вызовите GET /v1/models, чтобы подтвердить активность идентификатора модели. |
| 429 Too Many Requests | Достигнут лимит скорости (RPM/TPM) или лимит параллельных запросов | Уменьшите параллелизм; настройте экспоненциальную задержку повторов; либо запросите увеличение квоты в консоли. |
| 502 Bad Gateway | Сетевая ошибка вышестоящего провайдера или некорректный ответ | Шлюз AnyInt автоматически пытается переключиться на резервные каналы; если проблема сохраняется, сообщите через логи запросов в консоли. |
| 503 Service Unavailable | Все каналы-кандидаты маршрутизации временно недоступны | Повторите попытку через некоторое время или переключитесь на эквивалентную резервную модель. |
| 504 Gateway Timeout | Истекло время ожидания ответа вышестоящего провайдера (сложные модели рассуждений) | Проверьте сложность запроса; увеличьте время ожидания на клиенте; включите потоковую передачу (stream: true) для моделей рассуждений. |