开始使用

API密钥

一个密钥即可使用REST API、Python SDK和MCP服务器。

基础URL与请求头

每个请求

# base URL
https://api.clousd.com/v1

# header
Authorization: Bearer cl_live_••••••••

打开设置 → 连接：在权限 → API密钥中创建和吊销密钥。连接 AI 工具窗口可一键创建能控制你所有手机的密钥，并给出可直接粘贴到Claude Code、Codex、Cursor等客户端的配置。密钥只显示一次。

每个密钥都有一个权限范围和一份设备列表：

权限范围	可执行的操作
read	列出设备、截图、观察屏幕、读取作业。任何会改动内容的调用都返回`403`。
control	包含上述全部操作，另外可以开机、关机、安装应用、操作屏幕和运行任务。

密钥可以覆盖账户下的所有手机，也可以只覆盖你选定的列表。不在列表中的手机返回404，就像它不存在一样。

密钥一经吊销立即失效，所有使用它的客户端都会停用。密钥属于账户而不属于个人，所以有成员离开团队后，密钥依然有效。

账户有所有者和运营人员两种角色（设置 → 团队）。所有者负责账单、API密钥、团队，以及设备的创建和删除。运营人员操作分配给自己的设备，不能管理账单和密钥，也不能删除设备。