ابدأ مجانًا →

مرجع واجهة API

القياس عن بُعد والتحسين

الإبلاغ عن الاستدعاءات المُجراة خارج البوابة، واختيار نموذج لطلب، والبحث عن الإجابات المخزّنة مؤقتًا وتخزينها، والتحقق من دخول وكيل في حلقة، وضغط المحتوى الطويل، والاستعلام من سوق المزوّدين.

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

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

/api/ingest

POST /api/ingest

Ingest AI usage events

المصادقة
مفتاح API
نطاق المفتاح
ingest:write
الجسم
events (إلزامي)

/api/arbiter

POST /api/arbiter/route

Select optimal model for a request

المصادقة
مفتاح API
نطاق المفتاح
inference:write
الجسم
agentId · promptTokens · mode · qualityFloor · latencyCeilingMs · budgetUsd · candidates

/api/cache

POST /api/cache/lookup

Look up a cached answer for a prompt

المصادقة
مفتاح API
نطاق المفتاح
cache:read
الجسم
prompt (إلزامي) · threshold · model

POST /api/cache/store

Store a prompt and its answer in the cache

المصادقة
مفتاح API
نطاق المفتاح
cache:write
الجسم
prompt (إلزامي) · response (إلزامي) · model (إلزامي) · provider (إلزامي) · costUsd · ttlMs

/api/loops

POST /api/loops/check

Check an agent for a loop, reset its counters, or read its state

المصادقة
مفتاح API
نطاق المفتاح
advisory:read
الجسم
action · agentId (إلزامي) · workflowId · prompt · model · costUsd

/api/v1/compress

POST /api/v1/compress

Compress long reasoning content (levels L1 to L3)

المصادقة
مفتاح API
نطاق المفتاح
advisory:read
الوحدة
متاح حيث يشغّل النشر FEATURE_CCE.
الجسم
content (إلزامي) · level · agentId · workflowId · traceId

/api/v1/reconstruct

POST /api/v1/reconstruct

Reconstruct compressed content from its id

المصادقة
مفتاح API
نطاق المفتاح
advisory:read
الوحدة
متاح حيث يشغّل النشر FEATURE_CCE.
الجسم
cognitiveStateId (إلزامي)

/api/v1/marketplace

GET /api/v1/marketplace

The best-fit model of the provider marketplace for your constraints

المصادقة
مفتاح API
نطاق المفتاح
advisory:read
الوحدة
متاح حيث يشغّل النشر FEATURE_MARKETPLACE.
المعاملات
mode · maxCostPer1k · maxLatencyMs · minQuality · requiresVision · requiresTools · minContextWindow