Skip to main content

内部接口

内部接口用于服务间通信，需要 INTERNAL_SERVICE_TOKEN 认证。

caution

这些接口不应暴露到公网，仅用于内部服务调用。

Worker 心跳​

POST /internal/worker/heartbeat

请求头​

Authorization: Bearer <INTERNAL_SERVICE_TOKEN>

请求体​

{
  "worker_id": "gpu-worker-01",
  "worker_type": "gpu",
  "status": "online",
  "metrics": {
    "cpu_percent": 45.2,
    "memory_percent": 67.8,
    "gpu_percent": 89.1,
    "gpu_memory_percent": 75.3
  }
}

任务回调​

POST /internal/tasks/{task_id}/callback

请求体​

{
  "status": "completed",
  "result": {
    "metrics": {...},
    "model_path": "..."
  }
}

节点管理​

获取节点列表​

GET /internal/admin/nodes

获取节点统计​

GET /internal/admin/nodes/stats

启用/停用节点​

PUT /internal/admin/nodes/{node_id}/status
{
  "enabled": true
}

配置下发​

GET /internal/config

Worker 启动时从主节点拉取配置。