Niveaux

Certains modèles sont proposés dans plus d'un niveau. Un niveau est le même modèle vendu à un prix différent, par exemple un niveau moins coûteux à côté du niveau Par défaut. Une clé API atteint tous les niveaux ; vous choisissez un niveau par le nom du modèle, pas par une clé ou un paramètre distinct.

Niveau par défaut

Le simple nom du modèle utilise toujours le niveau Par défaut. Les requêtes existantes continuent de fonctionner sans changement lorsqu'un modèle gagne un autre niveau.

{ "model": "gpt-image-2" }

Choisir un niveau

Ajoutez un deux-points et l'ID du niveau au nom du modèle :

{ "model": "gpt-image-2:<tier>" }

Cela fonctionne pour les modèles de texte, d'image, de vidéo et d'audio, partout où la requête nomme un modèle : le champ model d'un corps JSON, le champ de formulaire model d'un téléchargement audio, et le segment de modèle d'un chemin natif Gemini. Dans un chemin Gemini, l'action reste en dernier :

POST /v1beta/models/<model>:<tier>:generateContent

Trouvez les niveaux d'un modèle

• Sur chaque page de modèle, un sélecteur de niveau se trouve au-dessus du tableau des prix et affiche les prix de chaque niveau ainsi que l'ID du modèle à appeler. Les pages avec un prix unique affichent les niveaux dans le tableau Niveaux tarifaires à la place. Les deux n'apparaissent que lorsque le modèle a plus d'un niveau.
• Le guide Markdown /models/<page>/llms.txt de chaque modèle répertorie les prix complets de tous les niveaux.
• GET /v1/models répertorie <model>:<tier> à côté de <model> pour chaque modèle que votre clé peut appeler dans plus d'un niveau.

Dans le Playground des modèles de texte, le sélecteur de Niveau bascule entre les mêmes niveaux. Le Playground des modèles d'image, de vidéo et d'audio utilise le niveau Par défaut ; appelez les autres niveaux via l'API.

Facturation et comportement

• Une requête de niveau s'exécute uniquement dans ce niveau et est facturée au prix de ce niveau.
• Si le niveau ne peut pas servir la requête, la requête échoue. Elle ne bascule jamais vers un autre niveau, donc elle n'est jamais facturée à un prix différent.
• Les réponses et les résultats de tâches signalent le simple nom du modèle.
• Une clé créée pour un seul niveau peut appeler ce niveau et aucun autre.

Erreurs

Voir Erreurs pour la forme de la réponse.