Публичный API

LLMoney предоставляет открытый REST API: актуальные цены языковых моделей, история их изменения, подбор модели по бюджету и расчёт токенов и стоимости. Данные те же, что использует калькулятор на главной странице.

✓Бесплатно — без API-ключей и регистрации
✓Все ответы в формате JSON (UTF-8)
✓Цены указаны за 1 млн токенов, в валюте usd или rub

Базовый URL

https://api.llmoney.ru/api/v1

Быстрый старт

curl "https://api.llmoney.ru/api/v1/models"

GET/models

Список моделей

Возвращает все поддерживаемые модели с актуальными ценами. Цены указаны за 1 млн токенов в валюте currency (usd или rub). Поле tokenizer_type показывает способ подсчёта токенов: tiktoken (локально), api_gigachat / api_yandex (через API провайдера) или approximation (приближённая оценка).

Query-параметры

Параметр	Тип	Описание
provider	string	Фильтр по слагу провайдера: openai, anthropic, google, gigachat, yandex, deepseek, meta, mistral
free_only	boolean	Только модели с бесплатной (локальной) токенизацией. По умолчанию false

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

curl "https://api.llmoney.ru/api/v1/models?provider=openai"

Пример ответа

{
  "models": [
    {
      "id": "openai-gpt-4o",
      "provider": "openai",
      "provider_display_name": "OpenAI",
      "name": "gpt-4o",
      "display_name": "GPT-4o",
      "tokenizer_type": "tiktoken",
      "tokenizer_config": { "encoding": "o200k_base" },
      "input_price": 2.5,
      "output_price": 10.0,
      "cached_input_price": 1.25,
      "currency": "usd",
      "is_paid_api": false,
      "supports_byok": true,
      "context_window": 128000,
      "description": null,
      "knowledge_cutoff": "Oct 2023"
    }
  ]
}

GET/models/{model_id}

Модель по идентификатору

Возвращает одну модель с текущей ценой. Если модель не найдена — ответ 404 с полем detail.

Параметры пути

Параметр	Тип	Описание
model_id*	string	Идентификатор модели, например openai-gpt-4o

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

curl "https://api.llmoney.ru/api/v1/models/openai-gpt-4o"

Пример ответа

{
  "id": "openai-gpt-4o",
  "provider": "openai",
  "provider_display_name": "OpenAI",
  "name": "gpt-4o",
  "display_name": "GPT-4o",
  "tokenizer_type": "tiktoken",
  "tokenizer_config": { "encoding": "o200k_base" },
  "input_price": 2.5,
  "output_price": 10.0,
  "cached_input_price": 1.25,
  "currency": "usd",
  "is_paid_api": false,
  "supports_byok": true,
  "context_window": 128000,
  "description": null,
  "knowledge_cutoff": "Oct 2023"
}

GET/models/{model_id}/price-history

История цен модели

Возвращает историю изменения цен модели в хронологическом порядке. Поле source указывает происхождение записи: seed (начальные данные), manual (ручное обновление) или api (автоматическая синхронизация).

Параметры пути

Параметр	Тип	Описание
model_id*	string	Идентификатор модели, например openai-gpt-4o

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

curl "https://api.llmoney.ru/api/v1/models/openai-gpt-4o/price-history"

Пример ответа

{
  "model_id": "openai-gpt-4o",
  "entries": [
    {
      "date": "2025-01-01",
      "input_price": 2.5,
      "output_price": 10.0,
      "cached_input_price": 1.25,
      "source": "seed"
    },
    {
      "date": "2026-03-14",
      "input_price": 2.5,
      "output_price": 10.0,
      "cached_input_price": 1.25,
      "source": "manual"
    }
  ]
}

GET/recommend

Подбор моделей по параметрам

Возвращает упрощённый список моделей, отфильтрованный по бюджету, контекстному окну и провайдеру и отсортированный по заданному критерию. Эндпоинт рассчитан на программный выбор модели AI-агентами. Поле total_available — сколько моделей прошло фильтры до применения limit.

Query-параметры

Параметр	Тип	Описание
max_input_price	number	Максимальная цена входных токенов за 1 млн
max_output_price	number	Максимальная цена выходных токенов за 1 млн
min_context_window	integer	Минимальный размер контекстного окна в токенах
currency	string	Фильтр по валюте тарификации: usd или rub
provider	string	Фильтр по слагу провайдера, например openai или gigachat
sort_by	string	Сортировка: input_price (по умолчанию), output_price или context_window (по убыванию)
limit	integer	Максимум моделей в ответе, от 1 до 100. По умолчанию 10

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

curl "https://api.llmoney.ru/api/v1/recommend?max_input_price=5&currency=usd&sort_by=input_price&limit=3"

Пример ответа

{
  "models": [
    {
      "id": "openai-gpt-4o-mini",
      "provider": "openai",
      "name": "gpt-4o-mini",
      "display_name": "GPT-4o Mini",
      "input_price": 0.15,
      "output_price": 0.6,
      "cached_input_price": 0.075,
      "currency": "usd",
      "context_window": 128000
    }
  ],
  "total_available": 42,
  "filters_applied": {
    "max_input_price": 5.0,
    "currency": "usd",
    "sort_by": "input_price",
    "limit": 3
  }
}

GET/exchange-rate

Курс доллара

Возвращает актуальный курс USD/RUB (рублей за 1 доллар), который сервис использует для конвертации цен. Поле source: cbr (ЦБ РФ), cbr-mirror (зеркало) или fallback (резервное значение).

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

curl "https://api.llmoney.ru/api/v1/exchange-rate"

Пример ответа

{
  "rate": 78.42,
  "source": "cbr",
  "updated_at": "2026-07-06T11:30:00"
}

POST/calculate

Расчёт токенов и стоимости

Считает количество токенов в тексте и стоимость обработки для каждой модели. Без model_ids расчёт выполняется по всем моделям с бесплатной токенизацией. В results для каждой модели возвращаются input_cost, output_cost, total_cost и использованный токенизатор (tokenizer_used); символ ≈ в нём означает приближённый подсчёт.

Тело запроса (JSON)

Параметр	Тип	Описание
text*	string	Текст для подсчёта токенов
model_ids	string[]	Идентификаторы моделей. Если не указаны — все модели с бесплатной токенизацией
output_multiplier	number	Ожидаемый размер ответа относительно входа. По умолчанию 1.0
cached_input_ratio	number	Доля входных токенов из промпт-кэша, от 0 до 1. По умолчанию 0
tools	object[]	Оценка накладных расходов на инструменты: массив объектов {type: code_interpreter \| web_search \| file_search \| mcp \| function, count, calls, def_tokens, call_tokens, result_tokens}

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

curl -X POST "https://api.llmoney.ru/api/v1/calculate" \
  -H "Content-Type: application/json" \
  -d '{"text": "Привет, мир!", "model_ids": ["openai-gpt-4o"]}'

Пример ответа

{
  "input_length": 12,
  "word_count": 2,
  "results": [
    {
      "model_id": "openai-gpt-4o",
      "provider": "openai",
      "provider_display_name": "OpenAI",
      "model_name": "gpt-4o",
      "display_name": "GPT-4o",
      "tokens": 5,
      "cached_tokens": 0,
      "input_cost": 0.0000125,
      "cached_input_cost": 0.0,
      "effective_input_cost": 0.0000125,
      "output_cost": 0.00005,
      "total_cost": 0.0000625,
      "currency": "usd",
      "context_window": 128000,
      "is_available": true,
      "tokenizer_used": "o200k_base",
      "tool_input_tokens": 0,
      "tool_output_tokens": 0,
      "tool_cost": 0.0
    }
  ]
}

POST/tokenize

Токенизация текста

Разбивает текст на токены выбранной кодировкой tiktoken и возвращает каждый токен с его идентификатором. Подходит для визуализации токенизации и точного подсчёта под конкретную модель OpenAI.

Тело запроса (JSON)

Параметр	Тип	Описание
text*	string	Текст для токенизации
encoding	string	Кодировка tiktoken: cl100k_base (по умолчанию), o200k_base, p50k_base или r50k_base

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

curl -X POST "https://api.llmoney.ru/api/v1/tokenize" \
  -H "Content-Type: application/json" \
  -d '{"text": "Hello, world!", "encoding": "cl100k_base"}'

Пример ответа

{
  "tokens": [
    { "id": 9906, "text": "Hello" },
    { "id": 11, "text": "," },
    { "id": 1917, "text": " world" },
    { "id": 0, "text": "!" }
  ],
  "total_count": 4,
  "encoding": "cl100k_base"
}

GET/health

Проверка доступности

Health-check сервиса. Единственный эндпоинт вне префикса /api/v1 — доступен от корня домена: https://api.llmoney.ru/health.

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

curl "https://api.llmoney.ru/health"

Пример ответа

{
  "status": "healthy"
}

Закрытые эндпоинты

Эндпоинты /auth, /api-keys и /call обслуживают само веб-приложение LLMoney: авторизацию через OAuth, хранение пользовательских API-ключей (BYOK) и вызов моделей от вашего имени. Они требуют авторизации и не входят в публичный API.

Машиночитаемая документация

Полная спецификация генерируется автоматически и всегда соответствует текущей версии API.

Swagger UI — Интерактивная документация — запросы можно выполнять прямо из браузера
ReDoc — Тот же справочник в альтернативном формате
openapi.json — Машиночитаемая спецификация OpenAPI 3.1
llms.txt — Описание API для AI-агентов по конвенции llms.txt