Аутентификация Flatkey API: Bearer-токены и ключи API - Flatkey

Каждый запрос к Flatkey API должен содержать действительный ключ API в заголовке Authorization в виде Bearer-токена. Создавать ключи и управлять ими можно в консоли Flatkey.

Формат заголовка

Authorization: Bearer sk-fk-your-api-key

Ключи Flatkey API начинаются с sk-fk-. Ключи чувствительны к регистру и должны передаваться точно в том виде, в котором были созданы.

Пример запроса

curl https://router.flatkey.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

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

Войдите в console.flatkey.ai
Нажмите Keys в левой панели навигации
Нажмите Create Key и введите название
Скопируйте ключ — он отображается только один раз

Если вы потеряли ключ, необходимо создать новый. Старые ключи остаются активными до явного отзыва.

Ошибки аутентификации

HTTP-статус	Условие	Решение
`401 Unauthorized`	Ключ отсутствует в запросе	Добавьте заголовок `Authorization: Bearer sk-fk-...`
`401 Unauthorized`	Ключ недействителен или отозван	Создайте новый ключ в консоли
`401 Unauthorized`	Баланс равен $0.00	Пополните баланс на console.flatkey.ai
`403 Forbidden`	Ключ не имеет доступа к модели	Проверьте разрешения ключа в консоли

Формат ответа об ошибке

{
  "error": {
    "message": "Invalid API key provided.",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Лучшие практики безопасности

Храните ключи в переменных окружения, а не в исходном коде
Используйте отдельный ключ для каждой среды развёртывания
Немедленно отзывайте ключи при их компрометации
Периодически меняйте ключи для производственных рабочих нагрузок

Никогда не включайте ключи API в клиентский JavaScript, сборки мобильных приложений или публичные репозитории. Ключи могут быть использованы злоумышленниками для исчерпания вашего баланса.