GET /v1/models

Renvoie chaque modèle activé disponible pour la clé API authentifiée. Les prix sont des chaînes décimales en USD pour un million de jetons.

Authentification

Authorization: Bearer mg_live_...

x-api-key: mg_live_... est également accepté.

Clés avec statut active ou frozen lire, s'il y a lieu, le catalogue de modèles et les tarifs spécifiques aux clés. Une clé gelée reste bloquée des points de terminaison d’inférence et des autres points de terminaison de métadonnées de compte qui nécessitent une clé active.

Demande

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

Réponse

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

Champs de prix

• cost est le taux Model Gate réel utilisé pour débiter le solde du compte.
• official_cost est le tarif du catalogue officiel du fournisseur enregistré.
• usage_cost est le taux effectif utilisé uniquement pour les limites d'utilisation des clés API et des groupes réinitialisables.
• usage_pricing identifie la base, le multiplicateur et la source d'héritage de la clé authentifiée.
• Lorsque le modèle de facturation du compte a un coefficient de lot différent de 1, batch_cost montre les tarifs réels effectifs pour les éléments de lot compatibles Claude/OpenAI et batch_pricing.multiplier identifie le coefficient de porte de modèle supplémentaire. Ces champs conditionnels sont omis lorsque le coefficient est 1. Indigène async=true n'utilise pas ce coefficient.

Pour official_price, chacun affiché usage_cost le taux est official_cost × multiplier. Pour user_price, c'est cost × multiplier. Il s’agit des tarifs catalogue par million de jetons. Le règlement final de la demande calcule et arrondit d'abord le montant de la demande de base sélectionné à 10 décimales, puis applique le multiplicateur et arrondit le résultat à 10 décimales.

Champs de limite du modèle

• context_window est la valeur de la fenêtre contextuelle orientée client et est actuellement égale à context_length.
• max_input_tokens est la valeur maximale configurée du jeton d’entrée lorsqu’elle est connue.
• max_output_tokens est la valeur maximale configurée du jeton de sortie lorsqu'elle est connue.
• max_completion_tokens est le champ de compatibilité de limite d'achèvement utilisé par les métadonnées du modèle de style fournisseur.
• Une valeur numérique de 0 signifie que Model Gate n'a pas de valeur configurée pour cette limite. Les clients disposant de dépassements de limites manuels facultatifs doivent laisser ce paramètre non défini plutôt que de traiter 0 comme limite réelle du modèle ou deviner une autre valeur.

L'authentifié /models la page affiche également Contexte, Entrée maximale, et Sortie maximale pour les valeurs non nulles connues, les utilisateurs ordinaires n'ont donc pas besoin d'interroger l'API simplement pour copier ces limites dans une configuration client.

Erreurs

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