ابدأ مجانًا →

مرجع واجهة API

استدعاءات البوابة

استدعاء نموذج عبر البوابة المحكومة — وما يحيط بالاستدعاء: هل يحتاج إلى نموذج، والنموذج الذي يمكن لأول استدعاء استخدامه، واستئناف استدعاء معلّق، وطلب استثناء، والتحقق من الاستناد، وإيصالات خزنتك الخاصة.

مرجع واجهة API كاملًا

ملخصات المسارات وأسماء الحقول مكتوبة بالإنجليزية، هنا وفي الملف.

/api/v1/chat

POST /api/v1/chat/completions

The governed gateway, OpenAI-compatible

المصادقة
مفتاح API
نطاق المفتاح
inference:write
الترويسات
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
الجسم
model (إلزامي) · messages (إلزامي) · 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

المصادقة
مفتاح API
نطاق المفتاح
inference:write
الترويسات
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
الجسم
provider (إلزامي) · model (إلزامي) · messages (إلزامي) · temperature · maxTokens · stream · useCache · task · cachePolicy · agentId · workflowId · fallbackProviders · azureEndpoint · azureDeployment · ollamaBaseUrl · onApprovalRequired · azoth_sources
الإجابات

/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

المصادقة
مفتاح API
نطاق المفتاح
advisory:read
الوحدة
متاح حيث يشغّل النشر FEATURE_IAE.
الجسم
connectorId · request

/api/v1/models

GET /api/v1/models/defaults

Which model a first call can use, per provider

المصادقة
مفتاح API
نطاق المفتاح
advisory:read

/api/v1/exceptions

POST /api/v1/exceptions

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

المصادقة
مفتاح API
نطاق المفتاح
inference:write
الوحدة
متاح حيث يشغّل النشر FEATURE_HELPFUL_REFUSALS.
الجسم
refusal_ref (إلزامي) · justification (إلزامي) · duration_days · requester_label

GET /api/v1/exceptions/{id}

Where an exception this key asked for stands

المصادقة
مفتاح API
نطاق المفتاح
inference:write
الوحدة
متاح حيث يشغّل النشر FEATURE_HELPFUL_REFUSALS.
المعاملات
id (إلزامي)

/api/v1/grounding

POST /api/v1/grounding/release

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

المصادقة
مفتاح API
نطاق المفتاح
inference:write
الوحدة
متاح حيث يشغّل النشر FEATURE_GROUNDING_CHECK.
الجسم
approval_request_id (إلزامي)

POST /api/v1/grounding/receipts

Seal the receipt of a grounding check run on your side

المصادقة
مفتاح API
نطاق المفتاح
inference:write
الوحدة
متاح حيث يشغّل النشر FEATURE_GROUNDING_CHECK.
الجسم
traceId (إلزامي) · claims (إلزامي) · supported (إلزامي) · judgeVersion (إلزامي) · claimsVersion (إلزامي) · sourcesHash (إلزامي) · sourceCount (إلزامي) · latencyMs · usecaseId

/api/v1/vault

POST /api/v1/vault/receipts

Seal the receipt of a call kept in your own vault

المصادقة
مفتاح API
نطاق المفتاح
inference:write
الوحدة
متاح حيث يشغّل النشر FEATURE_CLIENT_VAULT.
الترويسات
X-Azoth-Decision-Ref
الجسم
traceId (إلزامي) · plaintextHash (إلزامي) · ciphertextHash (إلزامي) · keyId