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,反之亦然。

相关接口