用代码、编辑器或 AI 来操控 Bot-Hosting。
公开测试版。 尽管放手去构建和尝试，但请谨慎使用：接口仍可能变动，每次调用都会作用于你真实的部署。
REST API 71 个接口，用来操控你的账号：部署、文件、环境变量、备份、依赖包、域名。 Bearer bhk_ 密钥，每分钟 120 次请求 MCP 服务器 同样的 71 个操作以工具形式提供，让 ChatGPT、Claude Desktop 或 Cursor 管理你的部署。 ChatGPT 用 OAuth，其他用 API 密钥 OAuth 2.1 让你的用户用 Bot-Hosting 账号登录，并在他们批准的权限范围内操作。 PKCE，访问令牌 7 天，刷新令牌 30 天 CLI 把一个文件夹关联到某个部署，在自己的编辑器里每次保存都自动推送。 npm i -g bot-hosting
一个密钥，一次请求
在开发者设置中创建密钥，只授予它所需的权限范围，然后作为 Bearer 令牌传入。
权限范围
API 密钥、MCP 和 OAuth 共用同一份清单。只有当密钥拥有该权限范围、且你对资源有权限时，请求才会执行。
部署
- deployments:read 列出并查看部署
- deployments:power 启动、停止、重启、控制台
- deployments:write 创建、编辑、删除、调整规格、迁移
- deployments:shell 在容器中运行 Shell 命令
- projects:read 列出你的项目
- projects:write 创建和删除项目
- files:read 浏览和下载文件
- files:write 上传、编辑、重命名、删除文件
- env:read 读取环境变量，机密信息会被隐藏
- env:write 设置环境变量
- backups:read 列出恢复点
- backups:write 创建、恢复、删除恢复点
- packages:read 查看已安装的依赖包
- packages:write 添加和移除依赖包
账号
- account:read 读取个人资料和配额
- billing:read 读取发票和套餐
- credits:spend 花费积分来创建资源
模板与文档
- templates:read 浏览公开模板
- docs:read 搜索并阅读文档