Interroger l'API des modèles disponibles

Les deux formats de réponse de GET /v1/models, la lecture des identifiants de modèle, ainsi que la différence entre la visibilité d'un modèle et sa réelle capacité d'appel.

Interrogez d’abord les modèles, puis rédigez votre requête. GET https://1zheai.com/v1/models renvoie les modèles visibles sous les restrictions de clé, de groupe et de modèle actuelles, sans nécessiter d’envoyer une requête d’inférence.

Format OpenAI

1
curl --fail-with-body --connect-timeout 10 --max-time 30 \
2
  https://1zheai.com/v1/models \
3
  -H "Authorization: Bearer $ONEZHE_API_KEY"

Voici un aperçu simplifié de la structure ; la liste dépend du retour réel :

1
{
2
  "object": "list",
3
  "data": [{"id": "gpt-5.6-sol", "object": "model"}]
4
}

Lorsque jq est installé, vous pouvez ajouter | jq -r '.data[].id' après la requête pour afficher un identifiant de modèle par ligne. Ne confondez pas le model_name de l’interface de prix publique avec le id ici.

Format Anthropic

Lorsque les deux en-têtes suivants sont utilisés, le même chemin renvoie des données de style Anthropic :

1
curl --fail-with-body https://1zheai.com/v1/models \
2
  -H "x-api-key: $ONEZHE_API_KEY" \
3
  -H "anthropic-version: 2023-06-01"

Portez attention sur data[].id, data[].display_name et has_more. Après avoir changé de méthode d’authentification, ne continuez pas à analyser la réponse selon l’autre structure.

Comment utiliser les résultats de la requête

Copiez l’identifiant complet depuis data[].id en conservant la casse, les tirets et le suffixe de date.
Vérifiez le type d’interface de ce modèle dans le catalogue de modèles de la console.
Validez avec une requête de texte minimale, puis ajoutez progressivement des images, des outils ou d’autres paramètres.

La liste des modèles n’est pas un contrôle de santé en temps réel et n’inclut pas toutes les restrictions de paramètres. Un modèle peut être visible mais les requêtes peuvent encore échouer si aucun amont disponible n’est temporairement disponible ; la surveillance de disponibilité HTTP du site officiel ne signifie pas non plus que chaque modèle peut réussir une inférence.

Liste vide ou modèles manquants

Vérifiez les restrictions de modèle et le groupe de votre clé ; les modèles affichés sur la page de prix publique ne sont pas nécessairement ouverts à chaque clé. Pour 401, vérifiez d’abord l’état de la clé ; pour 403, vérifiez les conditions d’accès ; pour les étapes détaillées, consultez codes d’erreur et dépannage.

Pour les familles de modèles et les conseils de sélection, consultez modèles pris en charge.