Référence de l’API
Télémétrie et optimisation
Déclarer les appels faits hors de la passerelle, choisir un modèle pour une requête, chercher et stocker des réponses en cache, vérifier qu’un agent ne boucle pas, compresser un long contenu et interroger la place de marché des fournisseurs.
Les résumés des routes et les noms des champs sont écrits en anglais, ici comme dans le fichier.
/api/ingest
POST /api/ingest
Ingest AI usage events
Authentification
Clé API
Portée de la clé
ingest:writeCorps
events (obligatoire)Réponses
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 402 budget_exceeded · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed, eu_storage_unavailable · 413 validation_failed · 429 ingest_queue_full · 500 internal_error · 503 service_unavailable · 504/api/arbiter
POST /api/arbiter/route
Select optimal model for a request
Authentification
Clé API
Portée de la clé
inference:writeCorps
agentId · promptTokens · mode · qualityFloor · latencyCeilingMs · budgetUsd · candidatesRéponses
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 402 budget_exceeded · 403 policy_blocked, sovereignty_blocked, jurisdiction_blocked, kill_switch_active, human_review_not_resumable, api_key_scope_denied · 429 · 500 internal_error · 503 budget_unavailable, governance_error/api/cache
POST /api/cache/lookup
Look up a cached answer for a prompt
Authentification
Clé API
Portée de la clé
cache:readCorps
prompt (obligatoire) · threshold · modelRéponses
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed · 429 · 500 internal_errorPOST /api/cache/store
Store a prompt and its answer in the cache
Authentification
Clé API
Portée de la clé
cache:writeCorps
prompt (obligatoire) · response (obligatoire) · model (obligatoire) · provider (obligatoire) · costUsd · ttlMsRéponses
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed · 429 · 500 internal_error/api/loops
POST /api/loops/check
Check an agent for a loop, reset its counters, or read its state
Authentification
Clé API
Portée de la clé
advisory:readCorps
action · agentId (obligatoire) · workflowId · prompt · model · costUsdRéponses
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed · 429 · 500 internal_error/api/v1/compress
POST /api/v1/compress
Compress long reasoning content (levels L1 to L3)
Authentification
Clé API
Portée de la clé
advisory:readModule
Servie là où le déploiement fait tourner
FEATURE_CCE.Corps
content (obligatoire) · level · agentId · workflowId · traceIdRéponses
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed · 429 · 500 internal_error · 501 feature_disabled/api/v1/reconstruct
POST /api/v1/reconstruct
Reconstruct compressed content from its id
Authentification
Clé API
Portée de la clé
advisory:readModule
Servie là où le déploiement fait tourner
FEATURE_CCE.Corps
cognitiveStateId (obligatoire)Réponses
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed · 404 not_found · 429 · 500 internal_error · 501 feature_disabled/api/v1/marketplace
GET /api/v1/marketplace
The best-fit model of the provider marketplace for your constraints
Authentification
Clé API
Portée de la clé
advisory:readModule
Servie là où le déploiement fait tourner
FEATURE_MARKETPLACE.Paramètres
mode · maxCostPer1k · maxLatencyMs · minQuality · requiresVision · requiresTools · minContextWindowRéponses
200 · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed · 404 · 429 · 500 internal_error · 501 feature_disabled