> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zerone.run/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/zh/runtime/endpoints/runs)、[Agent API](/zh/runtime/endpoints/agents) 和 [Files API](/zh/runtime/endpoints/files)。