عرض النماذج

يعرض النماذج المتاحة لمفتاحكم. مفيد لملء مُحدِّد ديناميكيًا، أو التحقق من عمل مفتاح.

الطلب#

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);

الاستجابة#

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

التحقق من مفتاح#

هذا هو الاستدعاء الأخف لاختبار مفتاح : لا يستهلك أي رمز ويعمل حتى عند نفاد الرصيد (خلافًا لـ/v1/chat/completions الذي يُعيد حينها 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

صيغة 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"
}