GET /v1/models

Minden elérhető engedélyezett modellt visszaad a hitelesített API-kulcsnak. Az árak tizedesjegyek USD-ben, egymillió tokenenként.

Hitelesítés

Authorization: Bearer mg_live_...

x-api-key: mg_live_... is elfogadják.

Kulcsok állapottal active vagy frozen elolvashatja a modellkatalógust és a kulcsspecifikus áraikat. A lefagyott kulcs blokkolva marad a következtetési végpontoktól és az aktív kulcsot igénylő egyéb fiókmetaadat-végpontoktól.

Kér

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

Válasz

{
  "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
    }
  ]
}

Ár mezők

• cost a számlaegyenleg terhelésére használt tényleges Model Gate árfolyam.
• official_cost az elmentett hivatalos szolgáltatói katalógusárfolyam.
• usage_cost a tényleges arány, amelyet csak a visszaállítható API-kulcsok és csoporthasználati korlátok esetén használnak.
• usage_pricing azonosítja a hitelesített kulcs alapját, szorzóját és öröklődési forrását.
• Ha a számla számlázási sablonjának köteg együtthatója eltér a 1, batch_cost megmutatja a Claude/OpenAI-kompatibilis kötegelemek tényleges tényleges díjait és batch_pricing.multiplier azonosítja a további Model Gate együtthatót. Ezek a feltételes mezők kimaradnak, ha az együttható 1. Bennszülött async=true nem használja ezt az együtthatót.

Mert official_price, mindegyik megjelenik usage_cost árfolyam az official_cost × multiplier. Mert user_price, az cost × multiplier. Ezek milliós token katalógusdíjak. A kérelem végső elszámolása először kiszámítja és 10 tizedesjegyre kerekíti a kiválasztott alapkérelem összegét, majd alkalmazza a szorzót, és az eredményt 10 tizedesjegyre kerekíti.

Modellkorlát mezők

• context_window a kliensre néző környezeti ablak értéke, és jelenleg egyenlő context_length.
• max_input_tokens a konfigurált maximális bemeneti token értéke, ha ismert.
• max_output_tokens a konfigurált maximális kimeneti token értéke, ha ismert.
• max_completion_tokens a szolgáltatói típusú modell metaadatai által használt kiegészítési korlát kompatibilitási mező.
• Egy számértéke 0 azt jelenti, hogy a Model Gate nem rendelkezik konfigurált értékkel ehhez a határértékhez. Az opcionális manuális határérték-felülírással rendelkező ügyfeleknek a kezelés helyett hagyniuk kell ezt a beállítást 0 mint tényleges modellhatár vagy más érték kitalálása.

A hitelesített /models oldal is megjelenik Kontextus, Max bemenet, és Max kimenet ismert, nullától eltérő értékekhez, így a hétköznapi felhasználóknak nem kell lekérdezniük az API-t csak azért, hogy ezeket a korlátokat átmásolják az ügyfélkonfigurációba.

Hibák

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