GET /v1/models

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

Аутентификация

Authorization: Bearer mg_live_...

x-api-key: mg_live_... также принимается.

Ключи со статусом active или frozen Вы можете ознакомиться с каталогом моделей и ценами на них. Замороженный ключ остается заблокированным для конечных точек вывода и для других конечных точек метаданных учетной записи, которым требуется активный ключ.

Запрос

curl https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..."

Ответ

{
  "object": "list",
  "data": [
    {
      "id": "claude-opus-4.7",
      "object": "model",
      "owned_by": "anthropic",
      "display_name": "Claude Opus 4.7",
      "aliases": ["ch-47"],
      "currency": "USD",
      "pricing_unit": "per_1m_tokens",
      "cost": {
        "input": "0.2",
        "output": "1",
        "cache_read": "0.02",
        "cache_write": "0.25",
        "reasoning": "1"
      },
      "official_cost": {
        "input": "1",
        "output": "5",
        "cache_read": "0.1",
        "cache_write": "1.25",
        "reasoning": "5"
      },
      "usage_cost": {
        "input": "10",
        "output": "50",
        "cache_read": "1",
        "cache_write": "12.5",
        "reasoning": "50"
      },
      "usage_pricing": {
        "basis": "official_price",
        "multiplier": "10",
        "inherited_from": "key"
      },
      "batch_cost": {
        "input": "0.1",
        "output": "0.5",
        "cache_read": "0.01",
        "cache_write": "0.125",
        "reasoning": "0.5"
      },
      "batch_pricing": {
        "multiplier": "0.5",
        "applies_to": "claude_openai_compat_batches"
      },
      "context_length": 200000,
      "context_window": 200000,
      "max_input_tokens": 180000,
      "max_output_tokens": 20000,
      "max_completion_tokens": 20000,
      "supports_streaming": true,
      "supports_tools": true,
      "supports_vision": true
    }
  ]
}

Поля цен

• cost — это фактическая ставка Model Gate, используемая для дебетования баланса счета.
• official_cost — сохраненный тариф из официального каталога провайдера.
• usage_cost — эффективная ставка, используемая только для сбрасываемых лимитов использования API-ключей и групп.
• usage_pricing определяет основу, множитель и источник наследования для аутентифицированного ключа.
• Если в шаблоне выставления счетов по аккаунту пакетный коэффициент отличается от 1, batch_cost показывает эффективные фактические ставки для позиций партии, совместимых с Claude/OpenAI, и batch_pricing.multiplier идентифицирует дополнительный коэффициент Model Gate. Эти условные поля опускаются, если коэффициент равен 1. Родной async=true не использует этот коэффициент.

Для official_price, каждый отображается usage_cost ставка official_cost × multiplier. Для user_price, это cost × multiplier. Это каталожные ставки за миллион токенов. При окончательном расчете запроса сначала рассчитывается и округляется выбранная базовая сумма запроса до 10 знаков после запятой, затем применяется множитель и округляется результат до 10 знаков после запятой.

Поля пределов модели

• context_window — это значение контекстного окна, обращенного к клиенту, и в настоящее время оно равно context_length.
• max_input_tokens — настроенное максимальное значение входного токена, если оно известно.
• max_output_tokens — настроенное максимальное значение выходного токена, если оно известно.
• max_completion_tokens — это поле совместимости предела завершения, используемое метаданными модели в стиле поставщика.
• Числовое значение 0 означает, что Model Gate не имеет настроенного значения для этого ограничения. Клиентам с дополнительным ручным переопределением лимита следует оставить этот параметр невыставленным, а не лечить 0 как фактический предел модели или угадывание другого значения.

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

Ошибки

{
  "error": {
    "type": "authentication_error",
    "code": "invalid_api_key",
    "message": "missing API key"
  }
}