Быстрый старт: выберите способ использования Flatkey

Flatkey даёт вам один ключ и четыре способа его использовать. Все четыре варианта используют один и тот же аккаунт, один баланс и один каталог моделей — так что остаётся только выбрать, что подходит именно вам.

Четыре способа использования Flatkey, показанные в Flatkey Console

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

Прежде чем начать

Создайте ключ на console.flatkey.ai/keys. Ключи Flatkey начинаются с sk-. Каждый из вариантов ниже использует один и тот же ключ, поэтому храните его в переменной окружения и не добавляйте в систему контроля версий. Каждая панель в Console также позволяет выбрать существующий ключ вместо создания нового и сразу подставляет его в показанный фрагмент кода.

API для разработчиков

Вызывайте любую модель через обычный HTTP-запрос, совместимый с OpenAI. Никаких SDK, никаких зависимостей — если у вас есть HTTP-клиент, вы уже готовы.

Console формирует запрос за вас: выберите ключ, выберите модель и скопируйте фрагмент кода на cURL, Node.js или Python.

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

Доступ к API

Базовый URL, аутентификация, доступные эндпоинты и обработка ошибок.

SDK для разработчиков

Оставьте тот OpenAI SDK, которым вы уже пользуетесь, и направьте его на Flatkey. Код запросов не меняется — меняется только базовый URL.

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

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["FLATKEY_API_KEY"],
    base_url="https://router.flatkey.ai/v1",
)

OpenAI SDK

Настройка для Python и Node.js, потоковая передача и вызов инструментов.

Anthropic SDK

Направляйте запросы к Claude через Flatkey таким же образом.

Flatkey CLI

Генерируйте изображения и видео прямо из терминала или позвольте AI-ассистенту управлять CLI за вас.

Установка

npm i -g @flatkey-ai/cli

Вход в систему

flatkey login

Начните создавать

Попросите своего AI-ассистента о том, что вам нужно, и позвольте ему запустить CLI:

Use Flatkey CLI to generate a "beautiful sunrise" picture.

Flatkey CLI с AI-агентом

Команды, вывод в формате JSON для агентов и восстановление после ошибок.

Codex и Claude Code

Подключите своего кодинг-агента один раз, а затем используйте Flatkey в уже открытых проектах.

Console предоставляет единую команду установки для macOS, Linux или Windows. Она устанавливает агента, если его у вас ещё нет, запрашивает ваш ключ и записывает конфигурацию за вас.

Установщик интерактивный. Он спрашивает, хотите ли вы использовать Claude Code или Codex CLI, и требует, чтобы Node.js уже был установлен.

Claude Code

Ручная настройка или CC Switch.

Codex CLI

Направьте Codex CLI через Flatkey.

Codex Desktop

Настройте настольное приложение.

Проверьте, что всё сработало

Какой бы вариант вы ни выбрали, откройте Usage Logs в Console после первого запроса. Вы должны увидеть его в списке с указанием модели, количества токенов, задержки и стоимости.

Используйте фильтр по названию модели в журналах использования Flatkey

Если ничего не появилось, подождите несколько секунд и выполните поиск снова, а затем проверьте, какой API-ключ и базовый URL фактически использовались в запросе.

Дальнейшие шаги

Каталог моделей

Все поддерживаемые модели с актуальными ценами и статусом работоспособности.

Ошибки API

Коды состояния, форматы ответов и что с ними делать.

Генерация текста

Потоковая передача, вызов инструментов и структурированный вывод.

Генерация видео

Отправьте задачу, отслеживайте её статус и скачайте MP4.