API Reference

Agent Runtime HTTP 接口总览。

​

API Reference

除健康检查外，Runtime 业务接口使用 /v1 前缀。

方法	路径	说明
GET	/health	健康检查
GET	/v1/metrics	请求、Token 与成本指标
GET	/v1/agents	Agent 列表
GET	/v1/agents/:id	Agent 详情
POST	/v1/agents/:id/runs	执行 Agent
POST	/v1/runs/:runId/cancel	取消执行
GET	/v1/sessions	Session 列表
GET	/v1/files	文件列表

配置 ZERONE_AGENT_HTTP_API_KEY 或 auth.apiKey 后，/v1/* 请求必须携带 x-api-key；环境变量优先。

详细请求与响应见 Runs API、Agent API 和 Files API。