Пользовательские цены

Обзор

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

Ключевые возможности:

• Области действия — цена применяется глобально или только для провайдера, ключа провайдера или виртуального ключа.
• Сопоставление по шаблону — точное имя модели или префикс, например gpt-4*.
• Фильтр по типу запроса — переопределение действует только для выбранных операций: chat, embedding, генерация изображений и других.
• Иерархическое разрешение — применяется наиболее специфичное переопределение, более широкие области служат резервным вариантом.

Источник данных о ценах

Переопределения применяются поверх каталога цен. По умолчанию Meridian загружает датасет цен Meridian и синхронизирует его каждые 24 часа. Если вы ведёте собственный датасет, укажите его адрес.

{
  "framework": {
    "pricing": {
      "pricing_url": "https://your-host/pricing.json",
      "model_parameters_url": "https://your-host/model-parameters.json",
      "pricing_sync_interval": 86400
    }
  }
}

"pricing_url": "file:///opt/meridian/pricing.json"

Области действия

Каждое переопределение относится к одной области — scope_kind. Для запроса Meridian находит все подходящие переопределения и применяет то, у которого область наиболее специфична.

virtual_key_provider_key  (наиболее специфичная)
virtual_key_provider
virtual_key
provider_key
provider
global                    (наименее специфичная)

Сопоставление по шаблону

Поле pattern задаёт имя модели, match_type — способ сопоставления.

В одной области точное совпадение проверяется раньше шаблона. Из нескольких подходящих шаблонов выбирается шаблон с самым длинным префиксом.

Порядок поиска цены

Цена из каталога ищется по первому найденному имени модели в таком порядке:

1. Модель серверного резервного варианта, если запрос обслужен им.
2. Каноническое имя алиаса ключа — routing_info.resolved_key_alias.model_name.
3. Идентификатор модели алиаса — routing_info.resolved_key_alias.model_id.
4. Модель из запроса — routing_info.model.

Такой порядок решает задачу непрозрачных идентификаторов. Если алиас ключа сопоставляет deployment Azure 12345-azure-prod с именем claude-sonnet-4-5, цена находится в каталоге по имени модели, хотя идентификатора deployment в каталоге нет.

Переопределения сопоставляются с именем модели, отправленным провайдеру: моделью резервного варианта, model_id алиаса или моделью из запроса — по первому найденному. Поэтому переопределение можно задать для конкретного deployment. Если модели нет в каталоге, переопределение применяется к пустой базовой цене.

Типы запросов

Поле request_types обязательно и содержит хотя бы одно значение. Указывайте базовый тип: chat_completion покрывает и потоковые, и непотоковые запросы. Потоковые варианты (chat_completion_stream и другие) отклоняются.

Типы realtime, compaction и container_create задаются только через API и config.json.

Создание переопределения

Веб-интерфейсAPIconfig.json

1. В боковом меню откройте Models → Pricing Overrides. В таблице — название, область, провайдер, ключ и шаблон модели каждого переопределения. Список можно искать по названию и фильтровать по виртуальному ключу.

2. Нажмите New Override.
3. Заполните форму Create Pricing Override:
   • Name — название переопределения.
   • Scope root — Global или Virtual key. Для Virtual key выберите виртуальный ключ.
   • Provider — провайдер или All providers. После выбора провайдера появляется поле Provider key.
   • Match type — Exact или Wildcard.
   • Pattern — имя модели или префикс со * в конце.
   • Request types — один или несколько типов запросов.
   • Pricing fields — поля цен в долларах США за единицу. Найдите поле поиском или в группе и введите значение. Поля без значения не переопределяются.
4. Нажмите Save Override.

Изменить или удалить переопределение можно в меню строки таблицы — Edit и Delete.

Создание:

curl -X POST http://localhost:8080/api/governance/pricing-overrides \
  -H "Content-Type: application/json" \
  -d '{
    "name": "GPT-4o negotiated rate",
    "scope_kind": "global",
    "match_type": "exact",
    "pattern": "gpt-4o",
    "request_types": ["chat_completion"],
    "patch": {
      "input_cost_per_token": 0.0000025,
      "output_cost_per_token": 0.00001
    }
  }'

Поле patch — JSON-объект с переопределяемыми полями цен. Ответ 201:

{
  "message": "Pricing override created successfully",
  "pricing_override": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "GPT-4o negotiated rate",
    "scope_kind": "global",
    "match_type": "exact",
    "pattern": "gpt-4o",
    "request_types": ["chat_completion"],
    "pricing_patch": "{\"input_cost_per_token\":0.0000025,\"output_cost_per_token\":0.00001}",
    "created_at": "2026-09-14T10:00:00Z",
    "updated_at": "2026-09-14T10:00:00Z"
  }
}

Изменение:

curl -X PUT http://localhost:8080/api/governance/pricing-overrides/{id} \
  -H "Content-Type: application/json" \
  -d '{
    "patch": {
      "input_cost_per_token": 0.000002,
      "output_cost_per_token": 0.000008
    }
  }'

Неуказанные поля сохраняют прежние значения. Переданный patch заменяет сохранённый целиком. При смене scope_kind идентификаторы области сбрасываются: сохраняются только переданные в том же запросе.

Удаление:

curl -X DELETE http://localhost:8080/api/governance/pricing-overrides/{id}

Список:

# Все переопределения
curl http://localhost:8080/api/governance/pricing-overrides

# Фильтр по области и поиск по названию с пагинацией
curl "http://localhost:8080/api/governance/pricing-overrides?scope_kind=virtual_key&virtual_key_id=vk-abc123&search=gpt&limit=25&offset=0"

Параметр	Описание
scope_kind, virtual_key_id, provider_id, provider_key_id	Фильтры по области.
search	Поиск по названию без учёта регистра.
limit, offset	Пагинация. По умолчанию limit — 25, максимум — 100.

Пагинация включается, если передан limit, offset или search. Ответ содержит pricing_overrides, count, total_count, limit и offset.

Переопределения задаются в governance.pricing_overrides. В отличие от API, поля цен передаются в pricing_patch строкой с JSON.

{
  "governance": {
    "pricing_overrides": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Global GPT-4o rate",
        "scope_kind": "global",
        "match_type": "exact",
        "pattern": "gpt-4o",
        "request_types": ["chat_completion"],
        "pricing_patch": "{\"input_cost_per_token\":0.0000025,\"output_cost_per_token\":0.00001}"
      },
      {
        "id": "660e8400-e29b-41d4-a716-446655440001",
        "name": "All Claude models for prod VK",
        "scope_kind": "virtual_key",
        "virtual_key_id": "vk-abc123",
        "match_type": "wildcard",
        "pattern": "claude*",
        "request_types": ["chat_completion"],
        "pricing_patch": "{\"input_cost_per_token\":0.000003,\"output_cost_per_token\":0.000015}"
      }
    ]
  }
}

Поле	Тип	Обязательное	Описание
id	string	Да	Уникальный идентификатор. Рекомендуется UUID.
name	string	Да	Название переопределения.
scope_kind	string	Да	Область действия: global, provider, provider_key, virtual_key, virtual_key_provider, virtual_key_provider_key.
virtual_key_id	string	Для областей virtual_key*	Идентификатор виртуального ключа.
provider_id	string	Для областей provider, virtual_key_provider, virtual_key_provider_key	Имя провайдера.
provider_key_id	string	Для областей provider_key, virtual_key_provider_key	Идентификатор ключа провайдера.
provider_key_name	string	Нет	Имя ключа провайдера вместо provider_key_id. Преобразуется в идентификатор при загрузке. Нельзя указывать вместе с provider_key_id.
match_type	string	Да	exact или wildcard.
pattern	string	Да	Имя модели или префикс со * в конце.
request_types	array	Да	Типы запросов, хотя бы одно значение.
pricing_patch	string	Нет	JSON-строка с переопределяемыми полями цен.

Для записей из config.json правила областей, шаблонов и типов запросов при загрузке не проверяются. Некорректная запись не вызовет ошибку, а просто не будет применяться. Проверяйте значения по таблицам на этой странице.

Справочник полей цен

Все значения — стоимость за единицу в долларах США.

Токены

Тарифы по размеру контекста

Кэширование

Изображения

Аудио и видео

Прочее

Примеры

Единый тариф для всех моделей Anthropic

{
  "id": "anthropic-flat-rate",
  "name": "Anthropic flat rate",
  "scope_kind": "provider",
  "provider_id": "anthropic",
  "match_type": "wildcard",
  "pattern": "claude*",
  "request_types": ["chat_completion", "text_completion", "responses"],
  "pricing_patch": "{\"input_cost_per_token\":0.000003,\"output_cost_per_token\":0.000015}"
}

Согласованный тариф для виртуального ключа

{
  "id": "vk-prod-gpt4o-rate",
  "name": "Prod VK — GPT-4o negotiated rate",
  "scope_kind": "virtual_key",
  "virtual_key_id": "vk-abc123",
  "match_type": "exact",
  "pattern": "gpt-4o",
  "request_types": ["chat_completion"],
  "pricing_patch": "{\"input_cost_per_token\":0.000002,\"output_cost_per_token\":0.000008}"
}

Цена генерации изображений

{
  "id": "dall-e-3-rate",
  "name": "DALL-E 3 custom rate",
  "scope_kind": "global",
  "match_type": "exact",
  "pattern": "dall-e-3",
  "request_types": ["image_generation"],
  "pricing_patch": "{\"output_cost_per_image_high_quality\":0.04,\"output_cost_per_image_medium_quality\":0.02}"
}

Цена для модели, которой нет в каталоге

{
  "id": "my-new-model-rate",
  "name": "my-new-model pricing",
  "scope_kind": "global",
  "match_type": "exact",
  "pattern": "my-new-model-v1",
  "request_types": ["chat_completion"],
  "pricing_patch": "{\"input_cost_per_token\":0.000001,\"output_cost_per_token\":0.000005}"
}

Применение изменений

Созданное или изменённое переопределение сразу действует на узле, который обработал запрос. В кластере изменение передаётся на остальные узлы, а каждые 300 секунд узлы дополнительно выполняют полную сверку переопределений.

Дальше

• Алиасы моделей — сопоставление непрозрачных идентификаторов с именами из каталога.
• Виртуальные ключи — переопределения на уровне виртуального ключа.
• Бюджеты и лимиты — как рассчитанная стоимость учитывается в бюджетах.
• Маршрутизация провайдеров — каталог моделей и его синхронизация.