Nous utilisons des cookies. Les cookies et le stockage du navigateur vous gardent connecté et mémorisent vos préférences. Avec votre accord, nous mesurons aussi l’utilisation du site. Vous pouvez à tout moment. Consultez notre politique relative aux cookies.

Identifiants et variantes de modèles

Premiers pas

Identifiants et variantes de modèles

Les identifiants de modèles suivent le format provider/model, avec les variantes :free, :online, :nitro et :floor, plus les modèles de secours.

Les identifiants de modèles sur api14 ont la forme provider/model, par exemple openai/gpt-5-mini. Passez l'identifiant dans le champ model de n'importe quelle requête.

{ "model": "anthropic/claude-sonnet-4.5" }

Trouver les identifiants de modèles

  • Parcourez la page des modèles : chaque modèle avec son identifiant, ses prix, sa longueur de contexte et ses capacités.
  • Appelez GET /models depuis le code ; filtrez par catégorie avec ?category=image. Voir Modèles.

Quelques exemples :

CatégorieExemples d'identifiants
Texteopenai/gpt-5-mini, anthropic/claude-sonnet-4.5, google/gemini-2.5-pro, deepseek/deepseek-chat
Imageopenai/gpt-5.4-image-2, google/gemini-2.5-flash-image
Vidéogoogle/veo-3.1-fast, openai/sora-2-pro
Voix (TTS)openai/gpt-4o-mini-tts
Transcriptionopenai/whisper-1, openai/gpt-4o-transcribe
Embeddingsopenai/text-embedding-3-small
Rerankcohere/rerank-v3.5

Les identifiants sont sensibles à la casse. Un identifiant inconnu ou désactivé renvoie 404 model_not_found.

Variantes

Une variante est un suffixe après deux-points qui change la façon dont la requête est servie. Les variantes fonctionnent avec le même modèle de base ; les règles de disponibilité et de liste autorisée du modèle de base s'appliquent.

SuffixeEffet
:freeL'endpoint gratuit d'un modèle, quand il existe. Les endpoints gratuits ont des limites de débit plus strictes en amont.
:onlineAjoute des résultats de recherche web au prompt. Voir Recherche web.
:nitroRoute vers les fournisseurs les plus rapides (débit le plus élevé).
:floorRoute vers les fournisseurs les moins chers.
{ "model": "openai/gpt-5-mini:online" }

:nitro et :floor sont des raccourcis pour le tri des fournisseurs, équivalents à provider: { sort: "throughput" } et provider: { sort: "price" }. Voir Routage des fournisseurs et modèles de secours.

Modèles de secours

Envoyez un tableau models pour essayer d'autres modèles quand le premier échoue ou est indisponible :

{
  "model": "anthropic/claude-sonnet-4.5",
  "models": ["openai/gpt-5-mini", "google/gemini-2.5-flash"],
  "messages": [{ "role": "user", "content": "Hello" }]
}

Chaque modèle de la liste doit être disponible et autorisé pour votre clé et votre forfait, sinon la requête est rejetée avant d'être envoyée. Le champ model de la réponse indique lequel a répondu, et vous payez le prix de ce modèle.

Listes autorisées et forfaits

  • Une clé avec une liste de modèles autorisés ne peut utiliser que les identifiants listés ; les autres renvoient 403 model_not_allowed.
  • Tous les forfaits, Free compris, couvrent toutes les catégories de modèles, y compris la vidéo et la musique/l'audio. Un forfait limité à certaines catégories renvoie 403 plan_required pour les autres. Voir Tarifs et facturation.

Évolution des modèles

Le catalogue se met à jour automatiquement. Les nouveaux modèles apparaissent d'eux-mêmes ; les modèles retirés renvoient 404 model_not_found. Figez des identifiants exacts en production et utilisez des solutions de secours models pour la résilience.