Aller au contenu principal

B10 - Registre des prix des modèles

GroupeTechnologieStatutServicePhase de la feuille de routeContrats
B - Gestion des LLM et Model GatewayDéveloppéà développerfinops2usage-event

Retour à l'index - English

Rôle et responsabilités​

Grilles tarifaires versionnées par provider, modèle, région, unité et devise.

Modèle de données​

Tables (schéma eai, chaque table tenant porte tenant_id uuid NOT NULL avec une politique RLS sur current_setting('app.tenant_id', true)::uuid) : eai.usage_events, eai.price_cards, eai.fx_rates, eai.recon_imports, eai.audit_events.

Endpoints API​

  • GET /v1/finops/price-cards
  • POST /v1/finops/price-cards
  • GET /v1/finops/price-cards/{id}
  • POST /v1/finops/price-cards/{id}/retire
  • GET /v1/finops/fx-rates
  • PUT /v1/finops/fx-rates
POST /v1/finops/price-cards HTTP/1.1
Host: <control-plane-host>
X-API-Key: eai_xxx_secret
Accept-Language: fr
Content-Type: application/json

{"provider": "openai", "model_pattern": "gpt-4o*", "currency": "USD", "version": "2025-05", "prices": {"input_tokens": 2.5, "output_tokens": 10.0}, "effective_from": "2025-01-01T00:00:00Z"}
{"id": "a9f571c4-9c05-4254-8e25-e1d5273a9b3d", "scope": "tenant", "tenant_id": "18de5695-21f9-4053-a4ea-beb4bf2a5932", "status": "active", "provider": "openai", "model_pattern": "gpt-4o*", "region": "*", "usage_type": null, "currency": "USD", "version": "2025-05", "effective_from": "2025-01-01T01:00:00+01:00", "effective_to": null, "reasoning_billing": "included_in_output", "prices": {"input_tokens": "2.5", "output_tokens": "10.0"}, "image_prices": {}, "video_prices": {}, "tiers": [], "reference": false, "source": null, "notes": null, "created_at": "2026-10-30T02:38:04.091090+01:00"}

Les erreurs utilisent l'enveloppe commune {"error": {"code", "message", "message_i18n", "details", "request_id"}} ; les listes sont paginées avec limit et cursor.

Utilisation des SDK​

Python (enterprise_ai):

from enterprise_ai import EnterpriseAI

client = EnterpriseAI(base_url="<control-plane-url>", api_key="eai_xxx_secret")
items = client.finops.list_price_cards()

TypeScript (@enterprise-ai/sdk):

import { EnterpriseAI } from "@enterprise-ai/sdk";

const eai = new EnterpriseAI({ baseUrl: "<control-plane-url>", apiKey: process.env.EAI_API_KEY });
const items = await eai.finops.priceCards.list();

Java (enterprise-ai-java):

EnterpriseAIClient client = EnterpriseAIClient.builder()
    .baseUrl("<control-plane-url>")
    .apiKey(System.getenv("EAI_API_KEY"))
    .build();
var items = client.finops().listPriceCards();

Go (enterprise-ai-go):

client, _ := eai.NewClient(eai.WithBaseURL("<control-plane-url>"), eai.WithAPIKey(os.Getenv("EAI_API_KEY")))
items, err := client.FinOps.ListPriceCards(ctx)

Configuration​

  • Environnement : EAI_DATABASE_URL, EAI_OTEL_EXPORTER_OTLP_ENDPOINT.
  • Valeurs Helm : controlPlane.enabled, controlPlane.replicas, controlPlane.resources, controlPlane.config.

Contrôles de sécurité​

  • Authentification par JWT OIDC, clé API tenant avec scopes, ou mTLS SPIFFE ; le tenant est résolu depuis l'identifiant, jamais depuis le corps.
  • Autorisation par décisions OpenFGA et OPA ; chaque mutation et décision écrit une ligne eai.audit_events chaînée par hash.
  • Les secrets ne sont jamais renvoyés par l'API ; TLS partout ; les politiques réseau Cilium restreignent qui peut joindre le service.

Observabilité​

  • Métriques : eai_model_pricing_registry_requests_total, eai_model_pricing_registry_errors_total, eai_model_pricing_registry_latency_seconds (Prometheus).
  • Traces : spans OpenTelemetry eai.finops.* avec propagation W3C traceparent, spans IA envoyés à Opik.
  • Actions d'audit : finops.price_card.create, finops.price_card.retire, finops.reconciliation.run, policy.evaluate.

Aspects FinOps​

Le coût d'exploitation est imputé par tenant et projet via les labels des Usage Events et les requêtes de ressources Kubernetes ; pas de coût direct par appel.

Modes de défaillance et résilience​

  • Réplicas sans état derrière l'API Gateway, PostgreSQL HA pour l'état ; la sonde GET /readyz retire les pods défaillants.
  • Système externe indisponible : échec fermé pour les décisions de sécurité, code d'erreur explicite, aucun contournement silencieux.

Adoption autonome (client d'un client)​

Un client d'un client peut adopter cette brique seule avec le sous-client SDK Python client.finops (TS eai.finops, Java client.finops(), Go client.FinOps). Déploiement minimal : Control Plane API + PostgreSQL + Keycloak (ou clés API), le Control Plane charge tous les domaines de services/control-plane/src/eai/domains ; les composants optionnels du chart se coupent dans deploy/helm/enterprise-ai/values.yaml (vllm.enabled, qdrant.enabled, nats.enabled, workers.enabled).

Tests d'acceptation​

  1. Un tenant ne peut ni lire ni modifier les ressources d'un autre tenant (test RLS).
  2. Chaque mutation produit un événement d'audit vérifiable par GET /v1/audit/verify.
  3. Les erreurs sont renvoyées en anglais et en français selon Accept-Language.

Prix audio, image, vidéo, GPU et stockage (LLM_-011)​

eai.finops_media_prices (V137) garde des révisions datées par unité (audio_second, image, video_second, gpu_second, storage_gb_month), fournisseur et ressource, avec leur source. POST /v1/finops/media-costs/estimate applique la révision en vigueur à la date d'usage et renvoie sa provenance ; sans révision, le coût vaut null avec status: unavailable et reason: price_unknown, jamais zéro. Tests : tests/test_finops_media.py.