Доступно

Справочник публичного API Токенмоста

Базовый адрес, открытые методы, авторизация, Idempotency-Key, форматы ответов и статусы доступности публичного API.

API Токенмоста работает

Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.

Как это устроено

Публичный API доступен по HTTPS. OpenAI-совместимые методы используют базовый адрес https://tokenmost.ru/v1 и Bearer-ключ; Anthropic-совместимый Messages использует x-api-key. POST-запросы требуют Idempotency-Key.

Что потребуется

Для генерации: активный API-ключ, положительный баланс и разрешение на нужный тип API. Каталог GET /v1/models можно читать без ключа.
Точный ID модели и опубликованный тариф для выбранного метода.
Серверный HTTP-клиент с таймаутом, отменой и безопасным хранением секрета.

Порядок работы

Выберите контракт: Chat Completions, Responses, Messages или Images.
Сверьте базовый URL, путь, метод авторизации и обязательные поля.
Для POST создайте Idempotency-Key длиной 8–128 символов.
Начните с короткого непотокового запроса и проверьте структуру ответа.
Добавляйте streaming, tools и мультимодальные поля только после базовой проверки.

Готовая конфигурация

Доступные публичные методы

GET  /v1/models
GET  /v1/balance
POST /v1/chat/completions
POST /v1/responses
POST /v1/messages
POST /v1/images/generations

Общие заголовки OpenAI-совместимого POST

Authorization: Bearer <TOKENMOST_API_KEY>
Content-Type: application/json
Idempotency-Key: <уникальный ключ операции>

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

Укажите TOKENMOST_BASE_URL=https://tokenmost.ru/v1, ключ проекта и точный ID модели из каталога. Пример отправляет запрос в публичный API и может списать средства с баланса по тарифу модели.

curl "https://tokenmost.ru/v1/models" \
  -H "Authorization: Bearer $TOKENMOST_API_KEY"

Что учесть

STT, Speech, Embeddings, Rerank, Moderation и Video могут быть видны в песочнице как подготовленные контракты. Считать их доступными можно только при активном статусе метода.

Каталог и поля возможностей

GET /v1/models доступен без ключа и возвращает страницы моделей. output_modalities описывает модель, а chat_completions отмечает её наличие в текстовом списке; эти поля не подтверждают успешную генерацию. Объект capabilities относится к текущему текстовому адаптеру: images:false не закрывает отдельный POST /v1/images/generations.

Статус метода и модели

Наличие страницы или модели в каталоге не открывает метод автоматически. Запрос выполняется только при активном production-маршруте, опубликованном тарифе и совместимом формате модели.

Форматы ошибок

Ошибки возвращают HTTP-статус и безопасное машинно-читаемое описание без закупочных данных поставщика. Не показывайте пользователю сырой внутренний ответ внешней модели.

Повторы

После таймаута повторяйте то же тело с тем же Idempotency-Key. Новый ключ создаёт новую логическую операцию и может привести к дополнительному резерву и списанию.

Ошибки и диагностика

404

Проверьте базовый URL и путь. Не добавляйте /v1 или имя метода дважды.

405

Маршрут существует, но выбран неправильный HTTP-метод.

401

Проверьте схему авторизации: Bearer для OpenAI-форматов, x-api-key для Messages.

402

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

503

Для модели нет безопасного активного маршрута или актуального тарифа. Не повторяйте запрос циклом.

Источники и связанные инструкции

Читайте дальше

← Все инструкции