创建 AceDataCloud 平台 API 凭证
内容提要
本文介绍如何在AceDataCloud平台创建API凭证（32位Token），用于调用OpenAI、Midjourney等业务接口。需通过POST请求至指定URL，携带账户令牌和Application ID，可设置额度、过期时间、IP白名单等。Token明文仅返回一次，需立即保存。文章还提供cURL、Python、Node.js示例及错误处理建议。
延伸解读
Token 明文只出现一次
创建凭证时，响应中会返回完整的 32 位 Token，但之后列表或详情接口只会显示脱敏格式（如 ac****ef）。因此，必须在创建后立即将 Token 保存到安全的地方，如密码管理器或环境变量。如果丢失，只能重新创建凭证，无法找回原 Token。
安全建议：限额、过期与 IP 白名单
文章建议在生产环境设置 amount 限制，以控制泄露风险；设置 expired_at 便于临时凭证的自动失效；使用 client_ip_allowlist 将凭证绑定到特定 IP，即使泄露也无法被他人使用。这些措施能有效降低凭证泄露带来的损失。
创建凭证前需先有 Application
创建凭证需要提供 application_id，该 ID 来自先前创建的服务申请。因此，流程上应先创建 Application，再为其签发凭证。凭证的额度、过期时间等均基于该 Application 的配置，且凭证只能用于该 Application 对应的业务接口。
Q&A
如何在AceDataCloud平台创建API凭证？
登录AceDataCloud平台，进入Account Token控制台创建账户令牌，然后向https://platform.acedata.cloud/api/v1/credentials/发送POST请求，请求头携带Authorization: Bearer <账户令牌>，请求体包含application_id（必填）等字段，即可创建API凭证。
创建AceDataCloud API凭证需要哪些必填参数？
必填参数只有application_id，即该凭证所属的Application ID。其他参数如name、amount、expired_at、tags、metadata、client_ip_allowlist均为可选。
AceDataCloud API凭证的Token为什么只能看到一次？
因为完整Token明文只在创建接口的响应中返回一次，列表和详情接口返回的都是脱敏格式（如ac****ef）。所以创建后必须立即保存到密码管理器或环境变量中，否则无法再次获取完整Token。
创建AceDataCloud API凭证时如何设置IP白名单？
在创建凭证的请求体中，通过client_ip_allowlist字段设置IP白名单，格式为CIDR数组，例如["203.0.113.7/32"]。设置后，只有白名单内的IP地址才能使用该凭证调用API。
AceDataCloud API凭证的amount字段有什么作用？
amount字段用于设置单凭证的额度上限，即该凭证最多能消耗的Credit数。设置为null表示无上限，可用Application全部余额。生产环境建议设置具体额度，以控制风险。
创建AceDataCloud API凭证时返回400错误可能是什么原因？
400错误表示invalid application_id，即application_id缺失、格式错误，或者amount为负数。请检查请求体中的application_id是否正确，以及amount是否为非负数。
AceDataCloud平台创建API凭证的接口地址是什么？
创建API凭证的接口地址是https://platform.acedata.cloud/api/v1/credentials/，使用POST方法，需要账户令牌鉴权。
