Ace Data Cloud SDK 总览
内容提要
Ace Data Cloud SDK提供TypeScript、Python、Go三种官方客户端，封装chat completions、images、video等AI能力，支持任务轮询、流式响应和X402链上支付。文章介绍申请API Token、环境变量配置，并展示三语言调用gpt-4o-mini的示例代码及运行结果。Go SDK多媒体功能尚处alpha阶段，推荐TypeScript或Python用于多媒体场景。
延伸解读
SDK 与原生 HTTP 的选择
文章明确区分了 SDK、MCP、原生 HTTP 和 X402 的适用场景：后端服务、CLI、自动化脚本和 Agent 框架推荐使用 SDK；Claude Desktop 等 MCP 客户端用 MCP Servers；一次性 curl 验证或嵌入式环境用原生 HTTP；不想创建 API Token、按调用链上付 USDC 时用 X402。SDK 与 X402 不互斥，可同时支持 token 路径和 paymentHandler 路径。
Go SDK 的成熟度差异
Go SDK 的多媒体资源（images、videos、audios）和任务轮询仍处于 alpha 阶段，稳定能力仅限 chat.completions。若需使用多媒体功能，建议优先选择 TypeScript 或 Python SDK。此外，Go SDK 的响应类型为 map[string]any，需自行类型断言，与 TypeScript 和 Python 的强类型或 dict 访问方式不同。
环境变量命名注意事项
三个 SDK 统一读取环境变量 ACEDATACLOUD_API_TOKEN，但项目仓库约定俗成使用 ACEDATACLOUD_API_KEY。若环境中只有 ACEDATACLOUD_API_KEY，SDK 不会自动识别，需在构造客户端时显式传入 apiToken 或 api_token。示例代码中使用了 process.env.ACEDATACLOUD_API_KEY，但实际应使用 ACEDATACLOUD_API_TOKEN 或显式传入。
Q&A
Ace Data Cloud SDK 支持哪些编程语言？
Ace Data Cloud 提供 TypeScript、Python、Go 三种官方 SDK。
如何获取 Ace Data Cloud 的 API Token？
需要登录 Ace Data Cloud 控制台，在“应用列表”中申请 API Token。首次申请会赠送免费额度。
Ace Data Cloud SDK 支持哪些 AI 能力？
SDK 封装了 chat completions、images、video、music、search 等 AI 能力，并支持任务轮询、流式响应和 X402 链上支付。
Go SDK 的多媒体功能是否稳定？
Go SDK 的多媒体功能（如图像、视频生成）和任务轮询目前处于 alpha 阶段，不稳定，推荐在多媒体场景使用 TypeScript 或 Python SDK。
如何配置 Ace Data Cloud SDK 的环境变量？
推荐设置环境变量 ACEDATACLOUD_API_TOKEN 为你的 API Token，SDK 会自动读取。也可以在构造客户端时显式传入，例如 TypeScript 中 new AceDataCloud({ apiToken: '{token}' })。
Ace Data Cloud SDK 支持哪些支付方式？
SDK 支持两种支付方式：token 路径（使用 API Token）和 paymentHandler 路径（无 token 链上付费）。SDK 与 X402 不互斥。
Ace Data Cloud SDK 如何处理错误和重试？
SDK 内置自动重试和指数退避机制，并提供类型化异常（如 AuthenticationError、RateLimitError）以便处理错误。
如何查看 Ace Data Cloud 账户的剩余额度和使用历史？
在 Ace Data Cloud 控制台的“应用列表”可查看剩余额度，在“使用历史”可查看使用历史和扣费详情。
