Felo API PlatformFelo API Platform

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.

EndpointRenvoie
GET /api/v1/modelsToutes les catégories de modèles activées
GET /api/v1/videos/modelsLes modèles de génération vidéo
GET /api/v1/decisions/modelsLes 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_default marque le canal utilisé pour le prix affiché en tête et pour la route par défaut.
  • runnable indique si le canal est actuellement disponible pour des requêtes.
  • standard_pricing contient les tarifs standard du fournisseur.
  • discount_multiplier est le multiplicateur commercial, de 0 à 1.
  • pricing_mode vaut configured_rates ou upstream_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 multiplier

Par 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 typiqueComment elle est mesurée
JetonsChat, raisonnement, embeddings, génération de texteJetons d'entrée et de sortie séparément ; les lectures et écritures de cache peuvent avoir leurs propres tarifs
Jetons d'imageGénération et édition d'imagesJetons 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êtesCertains endpoints d'image et utilitairesDes frais fixes par appel
Secondes ou paliersGénération vidéoDuré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

  1. Trouvez l'ID de modèle et le canal que vous prévoyez d'utiliser.
  2. Lisez les tarifs d'entrée, de sortie et de cache de ce canal.
  3. 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.
  4. Ajoutez tout palier conditionnel applicable.
  5. Laissez une marge pour les nouvelles tentatives et la variabilité de la sortie.

Voir aussi