API 密钥
仅 Cloud
API 密钥仅在 Cloud 版本中可用。
API 密钥让你从外部服务、脚本或集成中访问 ADHDev 的 REST API。
创建 API 密钥
在侧边栏中打开 API，为密钥命名、选择权限范围并复制密钥 —— 密钥只会显示一次。
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/{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 页面（或通过 REST API）撤销密钥
- 每个密钥都可以限定到特定权限范围
- API 密钥用于针对你自己的机器和会话进行云自动化，而不是用于绕过对敏感设置更改的账户安全检查
- 创建或撤销密钥是受近期登录保护的操作，因此陈旧的浏览器会话可能需要在更改成功前重新认证