Регистрация

Документация

TokenDock отдаёт OpenAI-совместимый API. Один base URL, один ключ, один баланс — и 500+ моделей за ними.

Три шага до первого запроса

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

01 Пополните баланс и создайте ключ Пополнение — картой, через СБП или по счёту для юрлица. Ключ создаётся в консоли, секрет показывается один раз. API-ключи 02 Укажите base URL и ключ В любом OpenAI-совместимом SDK подставьте адрес TokenDock вместо адреса вендора. Остальной код остаётся прежним. Первый запрос 03 Отправьте запрос POST на /chat/completions с id модели из каталога. Ответ приходит целиком или потоком по SSE. Chat Completions

Базовый URL и авторизация

Все запросы идут на один домен по HTTPS. Ключ передаётся в заголовке Authorization, тело запроса — JSON. Ни отдельного домена под streaming, ни вебсокетов, ни второго ключа не требуется.

base URL
https://api.tokendock.cloud/v1
Заголовок авторизации
Authorization: Bearer sk-td-…
Формат ключа
Префикс sk-td- и 32 символа. Секрет виден один раз — в момент создания.
Content-Type
application/json
Протокол
Только HTTPS, TLS 1.2 и выше. Запросы по HTTP отклоняются.

Быстрая проверка ключа — запросите каталог моделей. Ответ 200 означает, что ключ принят и аккаунт активен.

bash 
curl https://api.tokendock.cloud/v1/models \
  -H "Authorization: Bearer $TOKENDOCK_API_KEY"

Что поддерживается

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

Эндпоинт Назначение Статус Раздел
POST /chat/completions Чат и генерация текста: system-промпты, tools, vision, streaming Доступен Chat Completions
POST /embeddings Векторные представления текста для поиска и классификации Доступен Эмбеддинги
GET /models Каталог моделей: id, длина контекста, цены Доступен Каталог моделей

Пути указаны относительно base URL: полный адрес чата — https://api.tokendock.cloud/v1/chat/completions. Коды ответов и тела ошибок описаны в разделе коды ошибок.

Каталог: GET /models

Актуальный список моделей отдаёт сам API. Эндпоинт возвращает идентификаторы, длину контекста и цены. Запрос требует ключа, но не тратит токены и не тарифицируется.

json · ответ 
{
  "object": "list",
  "data": [
    {
      "id": "openai/gpt-4.1-mini",
      "object": "model",
      "owned_by": "openai",
      "context_length": 1000000,
      "pricing": { "prompt": 34, "completion": 134 }
    },
    {
      "id": "deepseek/deepseek-flash-0731",
      "object": "model",
      "owned_by": "deepseek",
      "context_length": 131072,
      "pricing": { "prompt": 1, "completion": 3 }
    }
  ]
}

Идентификатор всегда состоит из вендора и имени модели через слэш — openai/gpt-4.1-mini, anthropic/claude-4.5-sonnet, deepseek/deepseek-flash-0731. Короткое имя без вендора не принимается: запрос вернёт 404 с типом model_not_found.

Поле Тип Что означает
id string Полный идентификатор модели вместе с вендором. Его и передают в поле model запроса.
object string Всегда model. Тип элемента списка — поле есть ради совместимости с OpenAI.
owned_by string Вендор модели: openai, anthropic, google, xai, deepseek, qwen, meta, mistral.
context_length integer Максимум токенов на запрос и ответ вместе. Превышение возвращает 422.
pricing.prompt number Цена входных токенов в рублях за 1M токенов.
pricing.completion number Цена выходных токенов в рублях за 1M токенов. У эмбеддингов — 0.

Цены в pricing указаны в рублях за 1M токенов и меняются вместе с каталогом. Кэшировать ответ можно, но перечитывайте его хотя бы раз в сутки — новые модели появляются в день релиза у вендора. Как из этих чисел получается сумма списания, разобрано в разделе баланс и тарификация.

Витрина моделей и цен

Совместимость

API повторяет формат OpenAI: те же поля запроса, те же поля ответа, тот же формат SSE-потока. Клиент, который умеет менять base URL, работает без правок кода — меняются две настройки, адрес и ключ.

  • Официальные SDK — openai-python, openai-node и обёртки поверх них.
  • Фреймворки — LangChain, LlamaIndex, Vercel AI SDK.
  • Инструменты разработчика — Cursor, Continue, Open WebUI и любой клиент с настраиваемым OpenAI-эндпоинтом.

Чего не будет: эндпоинтов, специфичных для конкретного вендора — Assistants, Batch, Files, Fine-tuning, генерация изображений и звука. Всё, что относится к chat completions и эмбеддингам, работает как у OpenAI.

Смотреть примеры интеграций

Дальше

Разделы документации в порядке, в котором они обычно нужны.

Справочники под рукой: лимиты и квоты и коды ошибок.