Skip to main content
帳戶權杖(Account Token,舊稱 Platform Token) 是開發者透過程式設計方式管理 AceDataCloud 平台資源(服務申請、API 憑證、訂單、呼叫記錄、餘額、檔案等)的「帳號級金鑰」。它的作用類似前端登入後的使用者 Token,預設沒有過期時間;一般使用者只能管理自己的權杖,超級管理員可依權限管理其他帳戶權杖。 帳戶權杖以所屬帳號的目前權限存取平台介面:基礎權限、直接授予的權限及所屬使用者群組權限合併生效;加入群組或移出群組後,下次請求即依新權限判斷。存取具體申請、訂單等資源仍需透過歸屬驗證。帳戶權杖預設不過期,請只在可信任環境使用並妥善保管。
ℹ️ 本介面屬於 AceDataCloud 平台管理 API,統一前綴 https://platform.acedata.cloud/api/v1/。完整介面索引見取得 AceDataCloud 平台文件列表。

帳戶權杖 vs API 憑證

新手最容易混淆的兩類金鑰,請先看清楚: 如果你只是想調一下 GPT-4.1,要的是 API 憑證,不是帳戶權杖。 如果你要寫自動化指令碼管理儲值、看每月帳單、批量發憑證給團隊成員,那才用帳戶權杖。

在控制台一鍵建立(推薦)

  1. 登入 https://platform.acedata.cloud。
  2. 進入側邊欄 →「開發者」→「Account Token」。
  3. 點擊右上角「建立」按鈕,立刻得到一枚 platform-v1-... 權杖,點複製按鈕儲存到密碼管理器。
Account Token 控制台
⚠️ 目前建立、列表和詳情回應都會傳回權杖明文。請把整個回應按秘密處理,不要寫入日誌、分析平台或前端持久化;用戶端也不應依賴列表長期保持明文傳回。

用 API 建立帳戶權杖

介面概覽

驗證說明(雞生蛋問題)

第一枚權杖怎麼來?答案是走控制台——瀏覽器登入後,控制台用 JWT 驗證呼叫 POST /platform-tokens/,把第一枚權杖發給你。 之後你可以用任何一枚已有的 platform-v1-... 權杖再建立更多。
請求標頭格式:

請求範例

回應(HTTP 201)

欄位說明


取得帳戶權杖列表

介面概覽

必傳查詢參數

⚠️ 必須帶 ?user_id=<your_user_id>。原因:列表介面對分頁結果逐物件做權限驗證,沒帶 user_id 時第一個不屬於你的物件就會被拒絕,傳回 403 permission_denied。
如何取得 user_id:
  1. 瀏覽器開啟 https://auth.acedata.cloud/user/profile,頁面頂部顯示完整 UUID。
  2. 或者用 POST /platform-tokens/ 的回傳值裡的 user_id 欄位直接回填。

查詢參數

請求範例

回應(HTTP 200)

本介面的分頁回應使用 count + items。其他平台介面可能使用不同結構,請以對應文件和實際回應為準。

取得帳戶權杖詳情

回傳結構與列表元素一致,HTTP 200。

刪除帳戶權杖

  • 成功回傳 HTTP 204 No Content,無回應主體。
  • 刪除後該權杖立即失效,所有正在使用它的服務會馬上收到 401。
  • 再次查詢該 id 會回傳 404。
⚠️ 刪除不可逆。如果你懷疑權杖洩漏,可以先建立一枚新的,切換業務端,再刪除舊的。

不支援的操作


錯誤碼速查

錯誤回應統一格式:
排查時將 trace_id 提供給客服或貼在工單裡,可快速定位日誌。

完整程式碼範例

Python

Node.js


在其他平台 API 中使用

將 platform-v1-... 直接放到 Authorization: Bearer ... 標頭即可呼叫任何需要驗證的平台介面:
與 https://api.acedata.cloud/** 業務介面(OpenAI、Midjourney、Suno、Veo 等)所用的 32 位元十六進位 API 憑證完全不同。請勿混用——將帳戶權杖寫到業務介面會得到 401,反之亦然。

相關介面