Доступно

Первое подключение к API Токенмоста

Первый запрос к API Токенмоста: пополнение, API-ключ, выбор модели, cURL и проверка списания без лишних настроек.

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

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

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

Для первого ответа нужны положительный баланс, отдельный API-ключ и точный ID модели. Базовый адрес API — https://tokenmost.ru/v1. Начните с короткого непотокового запроса, проверьте результат и расход, а затем подключайте SDK, streaming и инструменты.

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

Подтверждённый аккаунт Токенмоста и положительный доступный баланс.
API-ключ с небольшим тестовым бюджетом и ограничением RPM.
Точный ID текстовой модели из каталога.

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

Пополните баланс, откройте раздел API-ключей и создайте отдельный ключ для теста.
Скопируйте полный ID модели из каталога и сохраните ключ и ID в переменных окружения.
Выполните короткий запрос Chat Completions с уникальным Idempotency-Key.
Убедитесь, что HTTP-статус равен 200, текст находится в choices[0].message.content, а операция появилась в кабинете.
После проверки перенесите запрос в серверную часть приложения и установите таймаут.

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

Переменные окружения — macOS и Linux

export TOKENMOST_API_KEY="sk-tm-..."
export TOKENMOST_MODEL="полный-id-из-каталога"

Первый запрос

curl "https://tokenmost.ru/v1/chat/completions" \
  -H "Authorization: Bearer $TOKENMOST_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: first-request-0001" \
  -d '{
    "model": "'"$TOKENMOST_MODEL"'",
    "messages": [{"role": "user", "content": "Ответь одним словом: работает"}],
    "max_tokens": 16
  }'

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

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

curl "$TOKENMOST_BASE_URL/chat/completions" \
  -H "Authorization: Bearer $TOKENMOST_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: example-request-0001" \
  -d '{
    "model": "MODEL_ID_FROM_CATALOG",
    "messages": [{"role": "user", "content": "Объясни API в двух предложениях."}],
    "max_tokens": 128
  }'

Что учесть

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

Как понять, что всё работает

Успешный ответ имеет HTTP 200 и содержит choices[0].message.content. Запрос и итоговое списание должны появиться в истории. HTTP 200 без ожидаемого поля ответа означает, что клиент разбирает не тот контракт.

Что переносить в приложение

Базовый адрес равен https://tokenmost.ru/v1. Ключ храните только на сервере. Для каждого логического POST создавайте новый Idempotency-Key, а сетевой повтор выполняйте с тем же ключом и неизменным телом.

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

HTTP 401

Ключ отсутствует, отозван или передан без префикса Bearer.

HTTP 402

Недостаточно доступного баланса или бюджета ключа. Пополните счёт либо измените лимит ключа.

HTTP 404

Проверьте путь /v1/chat/completions и полный ID модели из каталога.

HTTP 409

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

HTTP 429

Превышен RPM ключа. Дождитесь следующего окна или измените лимит осознанно.

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

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

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