API 密钥
冻结的界面（仪表板 UI）
云端仪表板中专用的 API Keys 页面目前因明确的产品决策（2026-07-14，参见仓库中的 docs/FROZEN_SURFACES.md）而被冻结：侧边栏入口已隐藏，/api-keys 重定向至 /dashboard。下文描述的 API 密钥后端、现有密钥和 REST API 保持在线并被保留，但在解除冻结之前不计划新的 API 密钥 UI 功能开发。请通过 REST API 或联系支持团队来管理 API 密钥。
仅 Cloud
API 密钥仅在 Cloud 版本中可用。
API 密钥让你从外部服务、脚本或集成中访问 ADHDev 的 REST API。
创建 API 密钥
- 在侧边栏中前往 API Keys
- 点击 Create API Key
- 输入一个描述性的名称
- 复制密钥 —— 它不会再次显示！
API 密钥以 adk_ 为前缀，便于识别。
使用 API 密钥
在 Authorization 头中包含该密钥：
bash
curl -H "Authorization: Bearer adk_your_key_here" \
https://api.adhf.dev/api/v1/daemons可用端点
| 方法 | 端点 | 说明 |
|---|---|---|
| GET | /api/v1/daemons | 列出已连接的机器 |
| GET | /api/v1/daemons/{daemonId}/status | 读取当前机器快照 |
| POST | /api/v1/shortcuts/{daemonId}/launch | 启动一个 IDE、CLI 或 ACP 目标 |
| POST | /api/v1/shortcuts/{ideId}/chat | 向代理发送消息 |
| POST | /api/v1/shortcuts/{ideId}/approve | 批准或拒绝一个操作 |
| GET | /api/v1/shortcuts/{ideId}/chat | 读取当前聊天 |
| GET/POST | /api/v1/shortcuts/{ideId}/chat/debug | 构建一个已脱敏的聊天调试包 |
| GET | /api/v1/shortcuts/{ideId}/status | 读取当前代理状态 |
参见完整的 API 参考 →
套餐限制
| 套餐 | API 密钥数 | 每月 API 调用 |
|---|---|---|
| Free | 3 | 1,000 |
| Pro | 10 | 50,000 |
| Ultra | 30 | 500,000 |
| Enterprise | 无限 | 无限 |
你可以在 Account → Account 标签页 → Plan limits 中查看当前用量。
安全
- 密钥在存储前会被哈希 —— 我们无法取回你的密钥
- 你可以随时从 API Keys 页面撤销密钥
- 每个密钥都可以限定到特定权限范围
- API 密钥用于针对你自己的机器和会话进行云自动化，而不是用于绕过对敏感设置更改的账户安全检查
- 创建或撤销密钥在云端仪表板中是受近期登录保护的操作，因此陈旧的浏览器会话可能需要在更改成功前重新认证