Lovely RouterДокументация
Получить ключ
Models API

Модели и цены

Получите список доступных моделей и их цен за токен через GET /v1/models и узнайте, как именно рассчитывается списание за каждый вызов.

Модели тарифицируются за токены, цены указаны в долларах США за миллион токенов. Каждый вызов тарифицируется по числу токенов, которое модель сообщает в своём ответе, а сумма списывается с вашего предоплаченного баланса в течение нескольких секунд.

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

GET /v1/models возвращает все модели, которые можно вызвать прямо сейчас, с размером контекста, ценами и группами каналов, которые их обслуживают. API-ключ не нужен, а client.models.list() работает с ним и в OpenAI SDK, и в Anthropic SDK.

curl https://lovelyrouter.com/v1/models

Сокращённый ответ:

Response
{
  "object": "list",
  "data": [
    {
      "id": "claude-sonnet-5.5",
      "object": "model",
      "type": "model",
      "display_name": "Claude Sonnet 5.5",
      "created": 1700000000,
      "created_at": "2025-01-01T00:00:00Z",
      "owned_by": "Anthropic",
      "context_length": 1000000,
      "pricing": {
        "input": 2,
        "output": 10,
        "cache_read": 0.1,
        "cache_write": 2.5,
        "unit": "USD per 1M tokens"
      },
      "groups": ["claude-value"]
    },
    {
      "id": "gpt-6.1-sol",
      "object": "model",
      "type": "model",
      "display_name": "GPT-6.1 Sol",
      "created": 1700000000,
      "created_at": "2025-01-01T00:00:00Z",
      "owned_by": "OpenAI",
      "context_length": 1050000,
      "pricing": {
        "input": 2,
        "output": 10,
        "cache_read": 0.1,
        "cache_write": null,
        "unit": "USD per 1M tokens"
      },
      "groups": ["gpt-value"]
    }
  ],
  "has_more": false,
  "first_id": "claude-fable-5.1",
  "last_id": "gpt-5.6-luna"
}
ПолеЗначение
idid модели, который нужно отправлять. Другие варианты написания тоже распознаются; см. id моделей.
owned_byВендор: Anthropic, OpenAI или Google.
context_lengthМаксимальное контекстное окно в токенах.
pricing.inputЦена входных токенов без кеша.
pricing.outputЦена выходных токенов, включая токены рассуждений и thinking.
pricing.cache_readЦена входных токенов, взятых из кеша промптов.
pricing.cache_writeЦена входных токенов, записанных в кеш промптов. null означает, что запись в кеш тарифицируется по цене входных токенов.
pricing.unitВсегда USD per 1M tokens.
groupsГруппы каналов, обслуживающие модель.
created, created_atФиксированные значения-заглушки, нужны для совместимости с SDK.

Все цены — прайсовые, до применения множителя группы каналов. GET /v1beta/models возвращает те же модели в формате Gemini, без цен.

Как тарифицируется вызов#

Расход каждого вызова делится на четыре вида токенов, и каждый вид тарифицируется по своей цене:

Вид токеновПоле usage в AnthropicПоле usage в OpenAIПоле usage в Gemini
Входные без кешаinput_tokensprompt_tokens минус cached_tokenspromptTokenCount минус cachedContentTokenCount
Чтение кешаcache_read_input_tokensprompt_tokens_details.cached_tokenscachedContentTokenCount
Запись кешаcache_creation_input_tokensне сообщаетсяне сообщается
Выходныеoutput_tokens (включая thinking)completion_tokens (включая рассуждения)candidatesTokenCount + thoughtsTokenCount

Списание составляет:

Text
charge = ( uncached_input × input_price
         + cache_read     × cache_read_price
         + cache_write    × cache_write_price
         + output         × output_price ) ÷ 1,000,000 × multiplier

Множитель — это множитель группы каналов, обслужившей вызов; она указана в заголовке ответа x-lovely-group. У модели может быть собственный множитель, который тогда заменяет множитель группы. Все группы, которые сейчас обслуживают модели, тарифицируют по ×1.00, так что вы платите ровно прайсовые цены. Списания округляются вверх до ближайших $0.000001.

Например, одна реплика агентской сессии на claude-sonnet-5.5:

Вид токеновТокеныЦена за 1MСтоимость
Входные без кеша1,200$2.00$0.002400
Чтение кеша30,000$0.10$0.003000
Запись кеша2,000$2.50$0.005000
Выходные800$10.00$0.008000
Итого$0.018400

Без кеша те же 33 200 входных токенов стоили бы $0.066400. Как поддерживать высокую долю попаданий в кеш, описано в разделе Кеширование промптов.

Модели изображений#

Модели изображений (gpt-image-*) тарифицируются за изображение, а не за токен. В GET /v1/models их pricing — это per_image (доллары США за изображение) вместо цен за токены. См. Цены на изображения.

Что не тарифицируется#

  • Запросы, отклонённые до того, как они дошли до модели: недействительный ключ, неразрешённая модель, недостаточный баланс, лимит запросов, некорректный JSON.
  • Запросы, которые не прошли ни на одном канале, и неудачные попытки, повторённые на другом канале. Вы платите только за попытку, которая вернула ответ.
  • POST /v1/messages/count_tokens и :countTokens в Gemini.
  • Получение списка моделей.

Отменённые и прерванные потоки#

Если вы закрываете поток раньше времени, вы платите за токены, выданные до этого момента. Для входа берётся число, которое сообщил поток, а если он ничего не сообщил — примерно один токен на четыре символа вашего запроса. Для выхода берётся большее из двух: число, сообщённое на этот момент, или примерно один токен на четыре символа уже доставленного вам текста.

Поток, который шлюз обрывает, потому что модель перестала отвечать, тарифицируется так же — за то, что было доставлено. См. Потоковая передача.

Где смотреть списания#

Каждый вызов отображается в Логах с числом токенов и суммой списания. Маркетплейс показывает цену каждой модели по группам каналов с уже применённым множителем, а также текущую доступность. Баланс и пополнение описаны в разделе Кредиты и оплата, отчёты об использовании — в разделе Использование и логи.

Актуальная таблица цен#

МодельКонтекстВходВыводЧтение кешаЗапись кеша

Данные из GET /v1/models · USD за 1 млн токенов