GET /v1/models

Връща всеки активиран модел, наличен към удостоверения API ключ. Цените са десетични низове в USD за един милион токени.

Удостоверяване

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 идентифицира допълнителния модел гейт коефициент. Тези условни полета се пропускат, когато коефициентът е 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"
  }
}