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 /modelsdepuis le code ; filtrez par catégorie avec?category=image. Voir Modèles.
Quelques exemples :
| Catégorie | Exemples d'identifiants |
|---|---|
| Texte | openai/gpt-5-mini, anthropic/claude-sonnet-4.5, google/gemini-2.5-pro, deepseek/deepseek-chat |
| Image | openai/gpt-5.4-image-2, google/gemini-2.5-flash-image |
| Vidéo | google/veo-3.1-fast, openai/sora-2-pro |
| Voix (TTS) | openai/gpt-4o-mini-tts |
| Transcription | openai/whisper-1, openai/gpt-4o-transcribe |
| Embeddings | openai/text-embedding-3-small |
| Rerank | cohere/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.
| Suffixe | Effet |
|---|---|
:free | L'endpoint gratuit d'un modèle, quand il existe. Les endpoints gratuits ont des limites de débit plus strictes en amont. |
:online | Ajoute des résultats de recherche web au prompt. Voir Recherche web. |
:nitro | Route vers les fournisseurs les plus rapides (débit le plus élevé). |
:floor | Route 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_requiredpour 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.