ℹ️ 本接口属于 AceDataCloud 平台管理 API,统一前缀 https://platform.acedata.cloud/api/v1/。完整接口索引见获取 AceDataCloud 平台文档列表。
账户令牌 vs API 凭证
新手最容易混淆的两类密钥,请先看清楚:
如果你只是想调一下 GPT-4.1,要的是 API 凭证,不是账户令牌。
如果你要写自动化脚本管理充值、看每月账单、批量发凭证给团队成员,那才用账户令牌。
在控制台一键创建(推荐)
- 登录 https://platform.acedata.cloud。
- 进入侧边栏 →「开发者」→「Account Token」。
- 点击右上角「创建」按钮,立刻得到一枚
platform-v1-...令牌,点复制按钮保存到密码管理器。
⚠️ 当前创建、列表和详情响应都会返回令牌明文。请把整个响应按秘密处理,不要写入日志、分析平台或前端持久化;客户端也不应依赖列表长期保持明文返回。
用 API 创建账户令牌
接口概览
鉴权说明(鸡生蛋问题)
第一枚令牌怎么来?答案是走控制台——浏览器登录后,控制台用 JWT 鉴权调用请求头格式:POST /platform-tokens/,把第一枚令牌发给你。 之后你可以用任何一枚已有的platform-v1-...令牌再创建更多。
请求示例
响应(HTTP 201)
字段说明
获取账户令牌列表
接口概览
必传查询参数
⚠️ 必须带如何获取?user_id=<your_user_id>。原因:列表接口对分页结果逐对象做权限校验,没带user_id时第一个不属于你的对象就会被拒,返回403 permission_denied。
user_id:
- 浏览器打开 https://auth.acedata.cloud/user/profile,页面顶部显示完整 UUID。
- 或者用
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,反之亦然。
相关接口
- 获取 AceDataCloud 平台服务申请列表 — 用账户令牌看自己申请了哪些服务
- 创建 AceDataCloud 平台 API 凭证 — 用账户令牌签发业务 API 用的 32 位凭证
- 获取 AceDataCloud 平台 API 调用记录 — 查账与排错
- 获取 AceDataCloud 平台订单列表 — 查充值历史

