ADCN 開發者中心
API 文件草案
已實作的端點以第二階段 MVP 為準,標為已完成。其餘是規劃中的草案,標為尚未開發。本頁文件本身是草案。
已完成的客戶 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(多語模型) | 中文或其他語言的向量模型。 |