inference.eu

GET /v1/models

API Models : la liste des modèles ouverts accessibles à votre clé

Le point de terminaison models renvoie tous les modèles que votre clé d'API peut appeler, dans le même format de liste que l'API d'OpenAI. Les outils dotés d'un sélecteur de modèle, comme les interfaces de chat, les extensions d'IDE et les agents de code, l'utilisent pour remplir leurs menus. Dans votre code, c'est le moyen fiable de vérifier un identifiant de modèle avant d'y envoyer du trafic.

  1. 01Format d'API: OpenAI
  2. 02Centres de données dans l'UE
  3. 03Couvert par un seul DPA
GET /v1/models
curl https://api.inference.eu/v1/models \
  -H "Authorization: Bearer $INFERENCE_EU_API_KEY"

# {
#   "object": "list",
#   "data": [
#     {"id": "gpt-oss-120b", "object": "model", "created": 1754438400, "owned_by": "openai"},
#     {"id": "qwen3-embedding-8b", "object": "model", "created": 1749081600, "owned_by": "qwen"},
#     {"id": "bge-reranker-v2-m3", "object": "model", "created": 1710460800, "owned_by": "baai"}
#   ]
# }

Ce que fait le point de terminaison

GET /v1/models ne prend pas de corps. Authentifiez-vous avec votre clé comme jeton bearer et l'API renvoie un objet object: "list" avec un tableau data. Chaque entrée contient un id, la chaîne exacte à passer dans le champ model des autres requêtes, ainsi que object: "model", un horodatage created et owned_by, qui désigne l'organisation ayant publié les poids.

La liste couvre tous les types de modèles du catalogue : chat et raisonnement, vision, code, embeddings, reclassement, transcription, synthèse vocale et génération d'images. Tous les modèles listés tournent dans des centres de données européens.

Consulter un modèle précis

GET /v1/models/{model} renvoie une seule entrée au même format, ou un 404 si l'identifiant n'existe pas ou que votre clé n'y a pas accès. C'est une vérification peu coûteuse au démarrage : si votre configuration désigne un modèle, assurez-vous qu'il est disponible avant la première requête utilisateur plutôt que de découvrir une faute de frappe en production.

La liste peut varier d'une clé à l'autre. Les modèles peuvent être activés par projet ou par offre, et nous pouvons ajouter des déploiements dédiés visibles de votre seule organisation. Interrogez la liste avec la clé qu'utilise réellement votre application.

Choisir un identifiant en pratique

Les identifiants sont des chaînes en minuscules dérivées du nom publié, comme gpt-oss-120b, qwen3-embedding-8b ou whisper-large-v3-turbo. Gardez-les dans la configuration plutôt que dispersés dans le code : essayer un nouveau modèle devient un simple réglage.

Servez-vous de ce point de terminaison pour attribuer un modèle à chaque tâche : un grand modèle de raisonnement pour les questions complexes, un modèle de chat plus léger pour la classification, un modèle d'embeddings et un modèle de reclassement pour la recherche. Les pages modèles de ce site décrivent licence, longueur de contexte et points forts ; l'API indique ce que votre clé peut appeler à l'instant.

Erreurs et cas particuliers

Une clé absente ou invalide renvoie un 401 avec l'objet error habituel. Demander un modèle auquel votre clé n'a pas accès, ou un identifiant mal orthographié, renvoie un 404 ; le message reprend l'identifiant envoyé pour que vous repériez l'erreur.

Lorsqu'un modèle est remplacé par une version plus récente, l'ancien identifiant continue de fonctionner pendant une période de transition, et nous annonçons le changement à l'avance. Ne vous fiez pas à l'ordre des entrées dans data. Si vous mettez la liste en cache, rafraîchissez-la régulièrement.

List models : questions fréquentes

Les questions que nous posent le plus les achats, les développeurs et les juristes. Il en manque une ? Posez-la-nous directement.

Poser une question

Faites passer vos charges IA sur une infrastructure européenne

Dites-nous quels modèles vous utilisez et votre volume approximatif. Nous répondons sous un jour ouvré avec un tarif et la suite.

  • Réponse sous un jour ouvré
  • Tarif adapté à votre volume
  • DPA prêt à signer