Публичный API

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

✓ без ключей и регистрации✓ JSON (UTF-8)✓ цены за 1M токенов · 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-параметры

providerstring	Фильтр по слагу провайдера: openai, anthropic, google, gigachat, yandex, deepseek, meta, mistral
free_onlyboolean	Только модели с бесплатной (локальной) токенизацией. По умолчанию false
toolsstring	Только модели со ВСЕМИ перечисленными встроенными инструментами провайдера (через запятую): web_search, code_interpreter, file_search, image_generation, computer_use, mcp

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

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

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

{
  "models": [
    {
      "id": "openai-gpt-5",
      "provider": "openai",
      "provider_display_name": "OpenAI",
      "name": "gpt-5",
      "display_name": "GPT-5",
      "tokenizer_type": "tiktoken",
      "tokenizer_config": { "encoding": "o200k_base" },
      "input_price": 1.25,
      "output_price": 10.0,
      "cached_input_price": 0.125,
      "currency": "usd",
      "is_paid_api": false,
      "supports_byok": true,
      "context_window": 400000,
      "description": null,
      "knowledge_cutoff": "Apr 2025",
      "builtin_tools": ["web_search", "code_interpreter", "file_search", "image_generation", "mcp"]
    }
  ]
}

GET/models/{model_id}

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

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

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

model_id*string

Идентификатор модели, например openai-gpt-5

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

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

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

{
  "id": "openai-gpt-5",
  "provider": "openai",
  "provider_display_name": "OpenAI",
  "name": "gpt-5",
  "display_name": "GPT-5",
  "tokenizer_type": "tiktoken",
  "tokenizer_config": { "encoding": "o200k_base" },
  "input_price": 1.25,
  "output_price": 10.0,
  "cached_input_price": 0.125,
  "currency": "usd",
  "is_paid_api": false,
  "supports_byok": true,
  "context_window": 400000,
  "description": null,
  "knowledge_cutoff": "Apr 2025",
  "builtin_tools": ["web_search", "code_interpreter", "file_search", "image_generation", "mcp"]
}

GET/models/{model_id}/price-history

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

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

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

model_id*string

Идентификатор модели, например openai-gpt-5

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

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

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

{
  "model_id": "openai-gpt-5",
  "entries": [
    {
      "date": "2025-08-07",
      "input_price": 2.5,
      "output_price": 20.0,
      "cached_input_price": 0.25,
      "source": "seed"
    },
    {
      "date": "2026-07-17",
      "input_price": 1.25,
      "output_price": 10.0,
      "cached_input_price": 0.125,
      "source": "openrouter"
    }
  ]
}

GET/price-changes

— Лента изменений цен

Возвращает изменения цен по всему каталогу, начиная с самых свежих: что подешевело, что подорожало, на сколько процентов и из какого источника пришла цена. Запись появляется только когда цена действительно изменилась. Значение kind: drop (подешевела), rise (подорожала), mixed (вход и выход разнонаправленно), new (модель добавлена в каталог).

Query-параметры

daysinteger	Глубина окна в днях, 1–1825. По умолчанию 90
kindstring	all \| changes (по умолчанию, без добавлений моделей) \| drop \| rise \| new
providerstring	Фильтр по слагу провайдера
model_idstring	Фильтр по одной модели
min_change_pctnumber	Скрыть изменения меньше указанного процента. По умолчанию 0
limitinteger	Максимум записей, 1–500. По умолчанию 100

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

curl "https://api.llmoney.ru/api/v1/price-changes?days=30&kind=drop"

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

{
  "summary": {
    "period_days": 30,
    "total": 2,
    "drops": 2,
    "rises": 0,
    "mixed": 0,
    "new_models": 0,
    "models_affected": 2
  },
  "changes": [
    {
      "model_id": "openai-gpt-5",
      "model_name": "GPT-5",
      "provider": "openai",
      "provider_display_name": "OpenAI",
      "currency": "usd",
      "date": "2026-07-17T03:00:00+00:00",
      "kind": "drop",
      "source": "openrouter",
      "input_price": 1.25,
      "output_price": 10.0,
      "cached_input_price": 0.125,
      "previous_input_price": 2.5,
      "previous_output_price": 20.0,
      "previous_cached_input_price": 0.25,
      "input_change_pct": -50.0,
      "output_change_pct": -50.0,
      "cached_change_pct": -50.0
    }
  ]
}

GET/recommend

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

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

Query-параметры

max_input_pricenumber	Максимальная цена входных токенов за 1 млн
max_output_pricenumber	Максимальная цена выходных токенов за 1 млн
min_context_windowinteger	Минимальный размер контекстного окна в токенах
currencystring	Фильтр по валюте тарификации: usd или rub
providerstring	Фильтр по слагу провайдера, например openai или gigachat
toolsstring	Только модели со ВСЕМИ перечисленными встроенными инструментами провайдера (через запятую): web_search, code_interpreter, file_search, image_generation, computer_use, mcp
sort_bystring	Сортировка: input_price (по умолчанию), output_price или context_window (по убыванию)
limitinteger	Максимум моделей в ответе, от 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-5-mini",
      "provider": "openai",
      "name": "gpt-5-mini",
      "display_name": "GPT-5 Mini",
      "input_price": 0.25,
      "output_price": 2.0,
      "cached_input_price": 0.025,
      "currency": "usd",
      "context_window": 400000,
      "builtin_tools": ["web_search", "code_interpreter", "file_search", "image_generation", "mcp"]
    }
  ],
  "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_idsstring[]	Идентификаторы моделей. Если не указаны — все модели с бесплатной токенизацией
output_multipliernumber	Ожидаемый размер ответа относительно входа. По умолчанию 1.0
cached_input_rationumber	Доля входных токенов из промпт-кэша, от 0 до 1. По умолчанию 0
toolsobject[]	Оценка накладных расходов на инструменты: массив объектов {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-5"]}'

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

{
  "input_length": 12,
  "word_count": 2,
  "results": [
    {
      "model_id": "openai-gpt-5",
      "provider": "openai",
      "provider_display_name": "OpenAI",
      "model_name": "gpt-5",
      "display_name": "GPT-5",
      "tokens": 5,
      "cached_tokens": 0,
      "input_cost": 0.00000625,
      "cached_input_cost": 0.0,
      "effective_input_cost": 0.00000625,
      "output_cost": 0.00005,
      "total_cost": 0.00005625,
      "currency": "usd",
      "context_window": 400000,
      "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	Текст для токенизации
encodingstring	Кодировка 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"
}

MCP-сервер для AI-агентов

Агент в Claude Code, Cursor или Windsurf сам смотрит цены, подбирает модель под бюджет и считает стоимость запроса. Ключи и регистрация не нужны.

claude mcp add llmoney -- npx -y llmoney-mcp

Для Cursor / Windsurf / Claude Desktop — в конфигурацию MCP-серверов:

{
  "mcpServers": {
    "llmoney": { "command": "npx", "args": ["-y", "llmoney-mcp"] }
  }
}

list_models— каталог с текущими ценами, фильтры и пересчёт в usd/rub
recommend_model— подбор модели под бюджет и контекст
estimate_cost— стоимость запроса по тексту или по числу токенов
price_changes— что подешевело и подорожало за период
price_history— полная история цен модели
exchange_rate— курс USD→RUB (ЦБ РФ)

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

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

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

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

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