開始使用

API 金鑰

一組金鑰就能使用 REST API、Python SDK 和 MCP 伺服器。

Base URL 與標頭

每個請求

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

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

開啟設定 → 連線：在權限 → API 金鑰建立和撤銷金鑰。連接 AI 工具視窗可一鍵建立能控制你所有手機的金鑰，並提供可直接貼到 Claude Code、Codex、Cursor 等用戶端的設定。金鑰只會顯示一次。

每組金鑰都有一個權限範圍和一份裝置清單：

權限範圍	可以做什麼
read	列出裝置、截圖、讀取畫面、讀取工作。任何會變更內容的呼叫都會回應 `403`。
control	以上全部，再加上開機、關機、安裝 App、操作畫面和執行任務。

金鑰可涵蓋帳戶裡的所有手機，或只涵蓋你選的清單。不在清單內的手機會回應 404，就像它不存在一樣。

金鑰一撤銷就立即失效，所有使用它的用戶端都會停止運作。金鑰屬於帳戶而不是個人，所以團隊成員離開後，金鑰照樣能用。

帳戶有擁有者和操作員兩種角色（設定 → 團隊）。擁有者負責帳務、API 金鑰、團隊，以及建立或刪除裝置。操作員只操作分配給自己的裝置，不能碰帳務、金鑰，也不能刪除裝置。