ADCN 開發者中心

API 文件草案

已實作的端點以第二階段 MVP 為準,標為已完成。其餘是規劃中的草案,標為尚未開發。本頁文件本身是草案。

OpenAPI 3.1 草案 標準化任務格式(JSON Schema)

已完成的客戶 API

方法與路徑說明狀態
POST /api/v1/jobs送出文字與模型,建立工作。
GET /api/v1/jobs/{jobId}查詢狀態與進度。
GET /api/v1/jobs/{jobId}/result完成後取回向量結果。

認證:Authorization: Bearer 客戶密鑰。錯誤回應為繁體中文。詳見第二階段 README 與 adcn-phase2.pages.dev。

已完成的裝置 API

方法與路徑說明狀態
POST /api/worker/register登記裝置,憑證只回一次。
POST /api/worker/lease領取分片。
POST /api/worker/submit交回向量。
POST /api/worker/bench更新基準速度 B。
GET /api/worker/me裝置與有效分鐘摘要;結算固定為未開放。
GET /api/account-minutes帳號今日有效分鐘(聯集)。

排程與驗證(已完成)

尚未實測:

標準化任務格式(摘要)

{
  "texts": ["The cat sits on the mat."],
  "model": "Xenova/all-MiniLM-L6-v2"
}

完整約束見 JSON Schema。單次最多 1000 段、每段 1000 字、請求 512 KB。

尚未開發的草案端點

方法與路徑說明狀態
POST /api/v1/agents/keys智能體自助建立金鑰。
PUT /api/v1/agents/budget設定預算上限並強制執行。
POST /api/v1/payments/intents建立付款。
GET /api/v1/earnings查詢已結算金額。
POST /api/v1/jobs(多語模型)中文或其他語言的向量模型。