Démarrer gratuitement →

Référence de l’API

Appels à la passerelle

Appeler un modèle par la passerelle gouvernée — et autour d’un appel : s’il lui faut un modèle, le modèle qu’un premier appel peut utiliser, la reprise d’un appel retenu, une demande d’exception, la vérification d’ancrage et les reçus de votre propre coffre.

Toute la référence de l’API

Les résumés des routes et les noms des champs sont écrits en anglais, ici comme dans le fichier.

/api/v1/chat

POST /api/v1/chat/completions

The governed gateway, OpenAI-compatible

Authentification
Clé API
Portée de la clé
inference:write
En-têtes
X-Azoth-Usecase · X-Azoth-Decision-Ref · X-Azoth-Subject-Zone · X-Azoth-End-User · X-Azoth-Challenge-Passed · X-Azoth-On-Behalf-Of · X-Azoth-Locale · X-Azoth-Alternative · X-Azoth-Refusal-Ref · Idempotency-Key
Corps
model (obligatoire) · messages (obligatoire) · temperature · max_tokens · stream · azoth_use_cache · azoth_task · azoth_cache_policy · azoth_agent_id · azoth_workflow_id · azoth_compute_os · azoth_sources

POST /api/v1/chat

The governed gateway with an explicit provider, fallbacks and streaming

Authentification
Clé API
Portée de la clé
inference:write
En-têtes
X-Azoth-Usecase · X-Azoth-Decision-Ref · X-Azoth-Subject-Zone · X-Azoth-End-User · X-Azoth-Challenge-Passed · X-Azoth-On-Behalf-Of · X-Azoth-Locale · X-Azoth-Alternative · X-Azoth-Refusal-Ref · Idempotency-Key
Corps
provider (obligatoire) · model (obligatoire) · messages (obligatoire) · temperature · maxTokens · stream · useCache · task · cachePolicy · agentId · workflowId · fallbackProviders · azureEndpoint · azureDeployment · ollamaBaseUrl · onApprovalRequired · azoth_sources
Réponses

/api/v1/infer

POST /api/v1/infer/resume

Run a held call once a reviewer approved it

POST /api/v1/infer/preflight

Score whether a request needs a model call at all

Authentification
Clé API
Portée de la clé
advisory:read
Module
Servie là où le déploiement fait tourner FEATURE_IAE.
Corps
connectorId · request

/api/v1/models

GET /api/v1/models/defaults

Which model a first call can use, per provider

Authentification
Clé API
Portée de la clé
advisory:read

/api/v1/exceptions

POST /api/v1/exceptions

Ask the rule's owner for a time-limited exception to a refusal

Authentification
Clé API
Portée de la clé
inference:write
Module
Servie là où le déploiement fait tourner FEATURE_HELPFUL_REFUSALS.
Corps
refusal_ref (obligatoire) · justification (obligatoire) · duration_days · requester_label

GET /api/v1/exceptions/{id}

Where an exception this key asked for stands

Authentification
Clé API
Portée de la clé
inference:write
Module
Servie là où le déploiement fait tourner FEATURE_HELPFUL_REFUSALS.
Paramètres
id (obligatoire)

/api/v1/grounding

POST /api/v1/grounding/release

Fetch a high-stakes answer the grounding check held, once approved

Authentification
Clé API
Portée de la clé
inference:write
Module
Servie là où le déploiement fait tourner FEATURE_GROUNDING_CHECK.
Corps
approval_request_id (obligatoire)

POST /api/v1/grounding/receipts

Seal the receipt of a grounding check run on your side

Authentification
Clé API
Portée de la clé
inference:write
Module
Servie là où le déploiement fait tourner FEATURE_GROUNDING_CHECK.
Corps
traceId (obligatoire) · claims (obligatoire) · supported (obligatoire) · judgeVersion (obligatoire) · claimsVersion (obligatoire) · sourcesHash (obligatoire) · sourceCount (obligatoire) · latencyMs · usecaseId

/api/v1/vault

POST /api/v1/vault/receipts

Seal the receipt of a call kept in your own vault

Authentification
Clé API
Portée de la clé
inference:write
Module
Servie là où le déploiement fait tourner FEATURE_CLIENT_VAULT.
En-têtes
X-Azoth-Decision-Ref
Corps
traceId (obligatoire) · plaintextHash (obligatoire) · ciphertextHash (obligatoire) · keyId