Developer Kit · RU/CIS

API TokenTool для интеграторов

Подключите каталог моделей и текстовые ответы к своему продукту. Первая версия фиксирует ровно два публично документированных HTTP-маршрута.

TokenTool — инфраструктурный слой с проектами, отдельными API-ключами, лимитами и журналом использования. Developer Kit сознательно уже всей платформы.

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

Контракт: v0.1
Формат: OpenAPI 3.1

Короткий ответ

Какой публичный API TokenTool документирован сейчас?

Контракт v0.1 документирует ровно два маршрута на https://api.tokentool.ru/api/v1: GET /models без ключа и POST /chat/completions с Bearer-ключом.

Кому: Backend-разработчики и интеграторы, которым нужен проверяемый минимальный контракт.
Что решает: Позволяет получить актуальные model ID и тарифные поля, затем выполнить один текстовый chat-запрос.
Подтверждено: Developer Kit публикует OpenAPI 3.1, Postman и примеры curl, Python и JavaScript для двух документированных маршрутов.
Граница: Функции интерфейса не означают публичные HTTP endpoint; embeddings, voice, media, streaming и tools вне контракта, пока не опубликованы отдельно.

Проверено 23.08.2026

Открыть контракт v0.1

Start 01–05

От нуля до первого ответа

Вам нужны аккаунт, положительный баланс, обычный API-ключ и актуальный ID текстовой модели.

Проект не обязателен для первого API-запроса; он нужен позже, чтобы разделять клиентов, команды и расходы.

01
Создайте аккаунт
Зарегистрироваться и перейдите в быстрый старт личного кабинета.
02
Проверьте баланс
Перед запросом откройте «Баланс и оплата». При нулевом балансе API вернёт HTTP 402 с кодом INSUFFICIENT_BALANCE.
03
Создайте обычный ключ
Откройте «API-ключи», создайте ключ и сохраните его: полное значение показывается один раз.
04
Скопируйте model ID
В каталоге моделей выберите доступную текстовую модель и скопируйте её ID.
05
Выполните запрос
Замените два плейсхолдера в готовом шаблоне. Успех — HTTP 200 и текст в choices[0].message.content.

Contract 02

Маршруты первой версии

https://api.tokentool.ru/api/v1

Метод	Путь	Доступ	Назначение
GET	/models	Без API-ключа	Актуальный каталог моделей и рублёвых тарифов. Состав каталога меняется.
POST	/chat/completions	Bearer API key	Минимальный текстовый запрос с полями model и messages; один JSON-ответ.

Quick start

Один текстовый запрос

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

Не сохраняйте API-ключ в Git, общем Postman workspace, переписке или клиентском коде.

curlBash · macOS / Linux / WSL

export TOKEN_TOOL_API_KEY=sk-tt-REPLACE_ME
export TOKEN_TOOL_MODEL_ID=provider/model-id

curl --fail-with-body \
  https://api.tokentool.ru/api/v1/chat/completions \
  -H "Authorization: Bearer ${TOKEN_TOOL_API_KEY}" \
  -H "Content-Type: application/json" \
  --data '{"model":"'"${TOKEN_TOOL_MODEL_ID}"'","messages":[{"role":"user","content":"Ответьте одним предложением: что такое API?"}],"stream":false}'

Публичный плейсхолдер sk-tt-REPLACE_ME инертен. Полные примеры останавливаются до сетевого запроса, пока оба плейсхолдера не заменены.

Windows PowerShell

$env:TOKEN_TOOL_API_KEY = "sk-tt-REPLACE_ME"
$env:TOKEN_TOOL_MODEL_ID = "provider/model-id"

$headers = @{ Authorization = "Bearer $env:TOKEN_TOOL_API_KEY" }
$body = @{
  model = $env:TOKEN_TOOL_MODEL_ID
  messages = @(@{ role = "user"; content = "Ответьте одним предложением: что такое API?" })
  stream = $false
} | ConvertTo-Json -Depth 4

Invoke-RestMethod -Method Post -Uri "https://api.tokentool.ru/api/v1/chat/completions" -Headers $headers -ContentType "application/json" -Body $body

Как выглядит успех

Статус HTTP 200, а текст ответа находится в choices[0].message.content.

{
  "choices": [
    {
      "message": {
        "content": "Текст ответа модели"
      }
    }
  ]
}

Ready workflow

Обращение клиента → JSON

Безопасный неактивный шаблон для n8n: Manual Trigger → Edit Fields → HTTP Request к документированному маршруту POST /chat/completions.

Скачать workflow JSON

SHA-256: 2324b5f9caf1e3e27b6ee3de3fb9eed54ca2e475b3c7ee949d9eb384edab4116

01
Импортируйте файл
В n8n выберите импорт workflow из файла. Шаблон проверен через CLI import/export n8n 2.35.7 и изначально выключен.
02
Создайте credential локально
Замените REPLACE_WITH_LOCAL_CREDENTIAL_ID, выбрав в HTTP-ноду свой Simplified Custom Auth credential. Значение ключа в скачиваемом JSON отсутствует.
03
Укажите актуальную модель
Скопируйте доступный ID из каталога моделей и замените REPLACE_WITH_CURRENT_MODEL_ID.
04
Проверьте баланс и запустите
Для запроса нужен положительный баланс. При нулевом балансе API вернёт HTTP 402 иINSUFFICIENT_BALANCE.

В файле нет API-ключа, значения credential или данных выполнений. Есть только синтетическое обращение и две явные заглушки. Подробная настройка — в инструкции n8n.

Artifacts 09

Спецификация и примеры

Девять публичных файлов зафиксированы по составу и SHA-256. Внутренние файлы продукта в набор не входят.

Evaluation

Что проверить перед внедрением

Публичного набора достаточно для первого технического теста, но не для вывода о production-готовности вашего сценария.

Проверяется самостоятельно

Base URL, Bearer-авторизация и форма текстового запроса.
Актуальный каталог моделей, доступность и опубликованные тарифные поля.
Раздельные ключи, проекты, лимиты и фактическое использование в кабинете.

Требует отдельного пилота

Задержка, пропускная способность и поведение под вашей нагрузкой.
Функции вне публичного контракта и особенности конкретного SDK.
SLA, режим поддержки и коммерческие или юридические условия.

Для команд Документация и поддержка

Scope lock

Граница контракта

В эту публикацию входят только GET /models и POST /chat/completions. Наличие других возможностей в интерфейсе TokenTool не означает наличия соответствующего публичного HTTP API.

Расширения будут добавляться только после отдельной проверки контракта, авторизации и ошибок.

Готовы подключить API?

Начните с каталога без ключа, затем создайте ключ для вашей интеграции.

Создать аккаунт

Какой публичный API TokenTool документирован сейчас?

От нуля до первого ответа

Создайте аккаунт

Проверьте баланс

Создайте обычный ключ

Скопируйте model ID

Выполните запрос