GPUtw 說明文件

API 金鑰

建立有權限範圍的 bearer key,用於 REST API 自動化。

建立金鑰

開啟控制台 → API 金鑰,選擇權限組合或自訂 scopes,並複製產生的密鑰。密鑰只會顯示一次。

驗證

範例
curl -H "Authorization: Bearer gputw_live_..." https://gputw.ai/api/instances

權限範圍

使用 catalog:read 瀏覽 GPU 與可用機器,instances:create 用於部署自動化,instances:manage 用於停止、刪除與重啟,ports:manage 用於連接埠變更,keys:manage 用於 API 金鑰管理。

輪替或撤銷

若金鑰外洩,請立即輪替。撤銷金鑰會停止後續 API 存取,但不會影響瀏覽器登入狀態。

最小權限

請使用符合自動化需求的最小 scope。部署機器人通常需要 catalog:readinstances:readinstances:create。會停止、重啟或刪除執行個體的操作腳本需要 instances:manage