Guides
Modèles et tarifs
Comprenez les ID de modèles, les fournisseurs, les tarifs publiés, les remises, les unités de facturation et le calcul du prix d'une requête.
Les prix des modèles sont publiés en USD. Un modèle peut être disponible via plusieurs fournisseurs upstream, et chaque fournisseur peut publier un prix client différent. Ce guide explique d'où viennent ces prix et comment calculer le coût d'une requête avant de l'envoyer.
Trouver un ID de modèle
Utilisez l'ID de modèle renvoyé par l'API. Ne construisez pas un ID à partir du nom d'affichage ou du slug de la page.
| Endpoint | Renvoie |
|---|---|
GET /api/v1/models | Toutes les catégories de modèles activées |
GET /api/v1/videos/models | Les modèles de génération vidéo |
GET /api/v1/decisions/models | Les modèles de décision |
GET /api/v1/models accepte aussi exclude_video_and_decisions=true et un filtre provider facultatif. La découverte lit le catalogue et ne facture pas d'appel de modèle.
Les modèles d'image n'ont pas d'endpoint de liste dédié. Filtrez GET /api/v1/models sur model_kind: "image_generation" ; consultez Génération d'images.
Pour une vue navigable, ouvrez le catalogue de modèles ou la page des tarifs. Les pages de détail des modèles indiquent les limites de contexte, les protocoles et chaque prix fournisseur publié.
Fournisseurs et canaux
Chaque modèle porte une liste de canaux publics. Un canal est une configuration de fournisseur upstream pour ce modèle, par exemple Anthropic, Azure, Google ou un canal Claude avec remise.
is_defaultmarque le canal utilisé pour le prix affiché en tête et pour la route par défaut.runnableindique si le canal est actuellement disponible pour des requêtes.standard_pricingcontient les tarifs standard du fournisseur.discount_multiplierest le multiplicateur commercial, de 0 à 1.pricing_modevautconfigured_ratesouupstream_cost.
La page du modèle trie les fournisseurs en plaçant celui par défaut en premier, puis par prix client d'entrée croissant. Pour choisir un fournisseur explicitement, consultez Canaux et routage fournisseur.
Comment est calculé un prix client
Pour un canal configured_rates :
customer price = standard rate × discount multiplierPar exemple, un canal avec un tarif d'entrée standard de $1.00 par 1M de jetons et un multiplicateur de 0.8 facture $0.80 par 1M de jetons.
Pour un canal upstream_cost, standard_pricing vaut null, et non zéro. La facturation se base sur le coût de génération déclaré, multiplié par la remise figée. La page du modèle affiche la règle réelle pour ce canal.
Les tarifs par jeton sont affichés pour 1 million de jetons par souci de lisibilité. La facturation utilise la précision par jeton de l'instantané tarifaire en vigueur.
Unités de facturation
| Unité | Usage typique | Comment elle est mesurée |
|---|---|---|
| Jetons | Chat, raisonnement, embeddings, génération de texte | Jetons d'entrée et de sortie séparément ; les lectures et écritures de cache peuvent avoir leurs propres tarifs |
| Jetons d'image | Génération et édition d'images | Jetons d'image d'entrée et de sortie séparément ; le nombre de jetons de sortie par image dépend de la résolution |
| Requêtes | Certains endpoints d'image et utilitaires | Des frais fixes par appel |
| Secondes ou paliers | Génération vidéo | Durée, résolution, entrées de référence ou autre condition publiée |
Si plusieurs conditions tarifaires correspondent, la première condition correspondante listée dans les détails de tarification du modèle s'applique. Consultez la page de détail du modèle pour les paliers avant d'estimer une tâche importante.
Tarifs de cache
Lorsqu'un modèle publie input_cache_read ou input_cache_write, ces tarifs apparaissent dans le catalogue et sur la page du modèle. L'usage du cache est rapporté par la réponse du protocole ; un cache hit n'est pas garanti et dépend du fournisseur upstream et de la requête. Felo n'ajoute pas d'interrupteur de cache séparé.
Où vérifier les prix
- Page des tarifs : comparez les modèles et les fournisseurs.
- Page de détail du modèle : tableau complet des tarifs, paliers et conditions.
- API du catalogue de modèles : les mêmes données en JSON, actualisées en 60 secondes.
Ne codez pas les prix en dur dans votre application. Lisez le catalogue ou affichez un lien vers la page des tarifs afin qu'un changement de prix ne casse pas silencieusement votre estimation de coût.
Estimer une requête
- Trouvez l'ID de modèle et le canal que vous prévoyez d'utiliser.
- Lisez les tarifs d'entrée, de sortie et de cache de ce canal.
- Multipliez par vos nombres de jetons attendus, ou utilisez le tarif par requête ou par durée pour les modèles non basés sur des jetons.
- Ajoutez tout palier conditionnel applicable.
- Laissez une marge pour les nouvelles tentatives et la variabilité de la sortie.