Empezar gratis →

Referencia de la API

Llamadas a la pasarela

Llamar a un modelo a través de la pasarela gobernada — y en torno a una llamada: si necesita un modelo, el modelo que puede usar una primera llamada, reanudar una llamada retenida, pedir una excepción, la comprobación de anclaje y los recibos de tu propia bóveda.

Toda la referencia de la API

Los resúmenes de las rutas y los nombres de los campos están en inglés, aquí y en el archivo.

/api/v1/chat

POST /api/v1/chat/completions

The governed gateway, OpenAI-compatible

Autenticación
Clave API
Ámbito de la clave
inference:write
Cabeceras
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
Cuerpo
model (obligatorio) · messages (obligatorio) · 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

Autenticación
Clave API
Ámbito de la clave
inference:write
Cabeceras
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
Cuerpo
provider (obligatorio) · model (obligatorio) · messages (obligatorio) · temperature · maxTokens · stream · useCache · task · cachePolicy · agentId · workflowId · fallbackProviders · azureEndpoint · azureDeployment · ollamaBaseUrl · onApprovalRequired · azoth_sources
Respuestas

/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

Autenticación
Clave API
Ámbito de la clave
advisory:read
Módulo
Disponible donde el despliegue ejecuta FEATURE_IAE.
Cuerpo
connectorId · request

/api/v1/models

GET /api/v1/models/defaults

Which model a first call can use, per provider

Autenticación
Clave API
Ámbito de la clave
advisory:read

/api/v1/exceptions

POST /api/v1/exceptions

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

Autenticación
Clave API
Ámbito de la clave
inference:write
Módulo
Disponible donde el despliegue ejecuta FEATURE_HELPFUL_REFUSALS.
Cuerpo
refusal_ref (obligatorio) · justification (obligatorio) · duration_days · requester_label

GET /api/v1/exceptions/{id}

Where an exception this key asked for stands

Autenticación
Clave API
Ámbito de la clave
inference:write
Módulo
Disponible donde el despliegue ejecuta FEATURE_HELPFUL_REFUSALS.
Parámetros
id (obligatorio)

/api/v1/grounding

POST /api/v1/grounding/release

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

Autenticación
Clave API
Ámbito de la clave
inference:write
Módulo
Disponible donde el despliegue ejecuta FEATURE_GROUNDING_CHECK.
Cuerpo
approval_request_id (obligatorio)

POST /api/v1/grounding/receipts

Seal the receipt of a grounding check run on your side

Autenticación
Clave API
Ámbito de la clave
inference:write
Módulo
Disponible donde el despliegue ejecuta FEATURE_GROUNDING_CHECK.
Cuerpo
traceId (obligatorio) · claims (obligatorio) · supported (obligatorio) · judgeVersion (obligatorio) · claimsVersion (obligatorio) · sourcesHash (obligatorio) · sourceCount (obligatorio) · latencyMs · usecaseId

/api/v1/vault

POST /api/v1/vault/receipts

Seal the receipt of a call kept in your own vault

Autenticación
Clave API
Ámbito de la clave
inference:write
Módulo
Disponible donde el despliegue ejecuta FEATURE_CLIENT_VAULT.
Cabeceras
X-Azoth-Decision-Ref
Cuerpo
traceId (obligatorio) · plaintextHash (obligatorio) · ciphertextHash (obligatorio) · keyId