Lister les modèles

Liste les modèles disponibles pour votre clé. Utile pour peupler dynamiquement un sélecteur, ou vérifier qu'une clé fonctionne.

GET https://api.cloudzir.com/v1/models

Requête#

curl https://api.cloudzir.com/v1/models \
  -H "Authorization: Bearer $CLOUDZIR_API_KEY"

modeles = client.models.list()
for m in modeles.data:
    print(m.id)

const modeles = await client.models.list();
for (const m of modeles.data) console.log(m.id);

Réponse#

{
  "object": "list",
  "data": [
    {
      "id": "mina-flash",
      "object": "model",
      "created": 1766000000,
      "owned_by": "cloudzir",
      "description": "Tout ce que fait Mina, à la vitesse maximale et au coût le plus bas. Le bon choix quand la réponse doit être immédiate et le volume élevé.",
      "context_window": 64000,
      "max_output_tokens": 8192
    },
    {
      "id": "mina-full",
      "object": "model",
      "created": 1766000000,
      "owned_by": "cloudzir",
      "description": "La profondeur maximale : raisonnement en plusieurs étapes, code exigeant, agents outillés, dossiers longs. Le modèle le plus capable de la famille.",
      "context_window": 256000,
      "max_output_tokens": 32768
    },
    {
      "id": "mina-low",
      "object": "model",
      "created": 1766000000,
      "owned_by": "cloudzir",
      "description": "Les mêmes capacités, avec plus de profondeur de raisonnement et un contexte deux fois plus large. Le réglage par défaut pour la production.",
      "context_window": 128000,
      "max_output_tokens": 16384
    }
  ]
}

Champ	Description
`id`	Nom à passer dans `model`.
`owned_by`	Toujours `cloudzir`.
`description`	Positionnement du modèle (extension CloudZIR au format OpenAI).
`context_window`	Fenêtre de contexte en jetons (extension CloudZIR).
`max_output_tokens`	Plafond de `max_tokens` (extension CloudZIR).

Modèles désactivés

Un modèle temporairement retiré du catalogue n'apparaît plus dans la liste, et un appel le visant renvoie 404 model_not_found. Rafraîchissez cette liste au démarrage de votre application plutôt que de coder les noms en dur.

Vérifier une clé#

C'est l'appel le plus léger pour tester une clé : il ne consomme aucun jeton et fonctionne même à solde nul (contrairement à /v1/chat/completions qui renvoie alors 402).

curl -s -o /dev/null -w "%{http_code}\n" \
  https://api.cloudzir.com/v1/models \
  -H "Authorization: Bearer $CLOUDZIR_API_KEY"
# 200 → clé valide · 401 → clé invalide ou révoquée

Format Anthropic#

curl https://api.cloudzir.com/anthropic/v1/models \
  -H "x-api-key: $CLOUDZIR_API_KEY"

{
  "data": [
    {"type": "model", "id": "mina-flash", "display_name": "mina-flash",
     "created_at": "2026-08-22T00:00:00Z"}
  ],
  "has_more": false,
  "first_id": "mina-flash",
  "last_id": "mina-low"
}

Réponse API