Прямой вызов API Flatkey

Базовый URL: https://router.flatkey.ai Flatkey предоставляет REST API, совместимый с OpenAI. Если у вас уже есть HTTP-клиент, SDK не нужен. Эта страница — кратчайший путь от ключа к рабочему запросу.

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

Каждый запрос передаёт ваш ключ в виде bearer-токена:

Authorization: Bearer YOUR_FLATKEY_API_KEY

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

export FLATKEY_API_KEY="sk-fk-..."

Отправка запроса

curl --fail-with-body -sS https://router.flatkey.ai/v1/chat/completions \
  -H "Authorization: Bearer $FLATKEY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{ "role": "user", "content": "Hello!" }]
  }'

Успешный вызов возвращает стандартный объект chat completion с полями choices и usage.

Доступные эндпоинты

Эндпоинт	Назначение
`POST /v1/chat/completions`	Генерация текста и чат
`POST /v1/responses`	Responses API, для моделей OpenAI
`POST /v1/images/generations`	Генерация и редактирование изображений
`POST /v1/videos`	Генерация видео, асинхронно
`GET /v1/videos/{task_id}`	Опрос задачи генерации видео
`GET /v1/models`	Список доступных моделей
`GET /v1/credits`	Остаток баланса

POST /v1/responses в настоящее время работает с моделями OpenAI. Для других семейств этот эндпоинт возвращает ошибку — используйте для них POST /v1/chat/completions.

Проверка баланса

curl --fail-with-body -sS https://router.flatkey.ai/v1/credits \
  -H "Authorization: Bearer $FLATKEY_API_KEY"

{ "remaining": 34.18, "used": 185.13 }

Обработка ошибок

Ошибки возвращают тело JSON с сообщением, по которому можно понять, что делать дальше:

{ "error": { "message": "No available channel for model ..." } }

Статус	Значение	Что делать
`400`	Некорректный запрос	Прочитайте сообщение — в нём указано проблемное поле
`401`	Недействительный ключ	Проверьте заголовок `Authorization` и значение ключа
`429`	Слишком много запросов	Сделайте паузу и повторите попытку
`500`, `503`	Модель или маршрут недоступны	Смените модель. Повторный запрос к той же модели редко помогает

Полный список — в справочнике по ошибкам.

Следующие шаги

Справочник API

Все эндпоинты, параметры и поля ответов.

Использовать SDK

Оставьте свой клиент OpenAI или Anthropic и измените одну строку.

Быстрый старт

Код

Популярные ИИ-инструменты

Генерация медиа

Популярные модели

Панель управления

Справочник

Прямой вызов API Flatkey

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

Отправка запроса

Доступные эндпоинты

Проверка баланса

Обработка ошибок

Следующие шаги

Справочник API

Использовать SDK

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

​Отправка запроса

​Доступные эндпоинты

​Проверка баланса

​Обработка ошибок

​Следующие шаги

Справочник API

Использовать SDK

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

Отправка запроса

Доступные эндпоинты

Проверка баланса

Обработка ошибок

Следующие шаги