Grilles tarifaires
L'écran Grilles tarifaires vous permet d'enregistrer et de retirer les prix versionnés d'un modèle fournisseur,
utilisés par le Control Plane pour calculer le coût mesuré de chaque appel. Chemin dans le portail :
/finops/price-cards (menu FinOps > Grilles tarifaires). Les analystes FinOps et les administrateurs de
tenant tiennent les grilles à jour ; les auditeurs les lisent.
Ce que montre l'écran
| Zone | Contenu |
|---|---|
| Tableau Grilles tarifaires | Colonnes : Fournisseur, Motif de modèle, Région, Version, Devise, Prix (JSON des prix par unité), Portée (tenant pour une grille de votre tenant, global pour une grille de la plateforme), En vigueur depuis, Statut. |
| Contenu de la liste | Le serveur ne liste que les grilles actives : une grille retirée sort de la liste. |
| Panneau de détail | Un clic sur une ligne charge la grille complète (paliers, prix image et vidéo, facturation du raisonnement, notes). |
| État vide | Aucune grille tarifaire : ajoutez les prix d'un modèle fournisseur. |
Actions
| Bouton ou action | Ce qu'il fait | Appel API | Rôles |
|---|---|---|---|
| Nouvelle grille | Ouvre le formulaire : Fournisseur (obligatoire), Motif de modèle (obligatoire, par exemple gpt-4o-mini*), Région (par défaut *), Version (par exemple openai-2026-01, sinon v<n>), Devise (obligatoire, par défaut USD), Prix (JSON obligatoire, prix pour 1M d'unités), En vigueur depuis (ISO 8601, par défaut maintenant), Notes. Créer l'envoie. | POST /v1/finops/price-cards | finops, tenant_admin, platform_admin |
| Retirer (menu de la ligne, grilles actives) | Demande une confirmation, puis termine la grille maintenant : statut retired et fin de validité fixée. | POST /v1/finops/price-cards/{card_id}/retire | finops, tenant_admin, platform_admin |
| Clic sur une ligne | Ouvre le panneau de détail de la grille. | GET /v1/finops/price-cards/{card_id} | Lecteurs de la section FinOps |
| Actualiser (icône flèche ronde) | Recharge la liste. | GET /v1/finops/price-cards | Lecteurs de la section FinOps |
La valeur par défaut de Prix dans le formulaire est :
{"input_tokens": "0.15", "output_tokens": "0.60", "cached_input_tokens": "0.075"}
Les clés acceptées par le serveur comprennent input_tokens, output_tokens, reasoning_tokens,
cached_input_tokens, cache_read_tokens, cache_write_tokens, audio_tokens, embedding_tokens, characters,
images, audio_seconds, video_seconds, requests et tool_calls ; une clé hors de la liste est refusée.
Rôles
| Rôle | Accès |
|---|---|
finops, tenant_admin | Créent et retirent les grilles du tenant (ADMIN_ROLES). |
platform_admin | Mêmes droits. Connecté sans tenant, la grille créée est une grille global partagée par tous les tenants. |
auditor | Lit les grilles ; le bouton Nouvelle grille et l'action Retirer sont masqués. |
developer, viewer, security_officer | Autorisés en lecture par l'API, mais la section FinOps du menu du portail ne s'ouvre pas pour eux. |
Tâches courantes
Enregistrer les nouveaux prix d'un modèle
- Ouvrir le formulaire. Une nouvelle grille garde l'historique : la grille précédente du même fournisseur, motif
et région est close à la date de la nouvelle. Cliquez sur Nouvelle grille.
Résultat attendu : le formulaire s'ouvre à droite.
En cas d'échec : si le bouton est absent, vos rôles ne sont pas
finops,tenant_adminouplatform_admin. - Remplir la grille. Saisissez Fournisseur, Motif de modèle, Devise et le JSON Prix, et mettez
En vigueur depuis à la date de la nouvelle liste de prix.
Résultat attendu : le formulaire accepte les valeurs.
En cas d'échec : la devise doit être en trois lettres majuscules (
EUR,USD). - La créer. Cliquez sur Créer.
Résultat attendu : le message Créé apparaît et la grille est listée avec le statut
active. En cas d'échec :price_card_invalidnomme les clés de prix erronées ;conflictsignifie qu'une grille plus récente du même modèle existe déjà à partir de cette date.
Retirer une grille obsolète
- Trouver la grille. Cherchez le fournisseur et le motif dans le tableau.
Résultat attendu : la grille est listée avec le statut
active. En cas d'échec : cliquez sur Actualiser. - La retirer. Ouvrez le menu de la ligne, choisissez Retirer et confirmez le message.
Résultat attendu : le message Terminé apparaît et la grille sort de la liste (le serveur ne liste que les
grilles actives).
En cas d'échec :
not_foundsignifie que la grille a déjà été supprimée ; rechargez la liste.
Dépannage
| Symptôme | Cause | Correction |
|---|---|---|
Erreur price_card_invalid (HTTP 422) : « La grille tarifaire est invalide : ... » | Une clé de Prix n'est pas une unité connue, ou un prix est négatif. | Utilisez les clés listées ci-dessus avec des valeurs positives. |
Erreur conflict (HTTP 409) : « La ressource existe déjà ou est en conflit. » | Une grille du même fournisseur, motif et région commence à la date de En vigueur depuis ou après. | Choisissez une date En vigueur depuis plus tardive, ou retirez d'abord la grille plus récente. |
Erreur validation_error (HTTP 422) | Devise n'est pas en trois lettres majuscules, ou En vigueur depuis n'est pas un horodatage. | Corrigez le champ. |
Erreur forbidden (HTTP 403) | Pas administrateur FinOps, ou platform_admin requis pour une grille globale. | Demandez le rôle finops. |
| Le coût mesuré d'un appel reste vide | Aucune grille active ne correspond au fournisseur et au modèle. | Créez une grille dont le Motif de modèle correspond à l'identifiant du modèle. |