Referencia de la API
Telemetría y optimización
Informar de las llamadas hechas fuera de la pasarela, elegir un modelo para una solicitud, buscar y guardar respuestas en caché, comprobar si un agente entra en bucle, comprimir contenido largo y consultar el mercado de proveedores.
Los resúmenes de las rutas y los nombres de los campos están en inglés, aquí y en el archivo.
/api/ingest
POST /api/ingest
Ingest AI usage events
Autenticación
Clave API
Ámbito de la clave
ingest:writeCuerpo
events (obligatorio)Respuestas
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
Autenticación
Clave API
Ámbito de la clave
inference:writeCuerpo
agentId · promptTokens · mode · qualityFloor · latencyCeilingMs · budgetUsd · candidatesRespuestas
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
Autenticación
Clave API
Ámbito de la clave
cache:readCuerpo
prompt (obligatorio) · threshold · modelRespuestas
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
Autenticación
Clave API
Ámbito de la clave
cache:writeCuerpo
prompt (obligatorio) · response (obligatorio) · model (obligatorio) · provider (obligatorio) · costUsd · ttlMsRespuestas
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
Autenticación
Clave API
Ámbito de la clave
advisory:readCuerpo
action · agentId (obligatorio) · workflowId · prompt · model · costUsdRespuestas
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)
Autenticación
Clave API
Ámbito de la clave
advisory:readMódulo
Disponible donde el despliegue ejecuta
FEATURE_CCE.Cuerpo
content (obligatorio) · level · agentId · workflowId · traceIdRespuestas
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
Autenticación
Clave API
Ámbito de la clave
advisory:readMódulo
Disponible donde el despliegue ejecuta
FEATURE_CCE.Cuerpo
cognitiveStateId (obligatorio)Respuestas
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
Autenticación
Clave API
Ámbito de la clave
advisory:readMódulo
Disponible donde el despliegue ejecuta
FEATURE_MARKETPLACE.Parámetros
mode · maxCostPer1k · maxLatencyMs · minQuality · requiresVision · requiresTools · minContextWindowRespuestas
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