示例 5:类型化错误处理
import os
from acedatacloud import AceDataCloud
from acedatacloud import AuthenticationError, RateLimitError, ValidationError
bad = AceDataCloud(api_token=\"definitely-not-a-real-token\")
try:
bad.openai.chat.completions.create(
model=\"gpt-4o-mini\",
messages=[{\"role\": \"user\", \"content\": \"hi\"}],
max_tokens=5,
)
except AuthenticationError as err:
print(\"err_class\", type(err).__name__)
print(\"status\", err.status_code)
print(\"code\", err.code)
except RateLimitError as err:
# 429,SDK 已经自动指数退避重试 2 次仍失败才会抛
print(\"rate limited:\", err.code)
except ValidationError as err:
# 400,例如缺字段、模型名不存在
print(\"bad request:\", err.code, err.message)
异常层级跟 TypeScript 一致:AuthenticationError (401)、TokenMismatchError (token 与服务不匹配)、InsufficientBalanceError (余额不足)、ResourceDisabledError (服务被禁用)、ValidationError (400)、RateLimitError (429)、ModerationError (403 内容审核)、APIError (兜底)、TimeoutError(超时)、TransportError(网络层)。
配置选项
from acedatacloud import AceDataCloud
client = AceDataCloud(
# 必填之一:显式 token 或环境变量 ACEDATACLOUD_API_TOKEN
api_token=\"...\",
# 平台 API 根地址,默认 https://api.acedata.cloud
base_url=\"https://api.acedata.cloud\",
# 部分服务(如 dashboard 元数据)走 platform 域名
platform_base_url=\"https://platform.acedata.cloud\",
# 单次请求超时,秒;默认 300.0
timeout=300.0,
# 自动重试次数,默认 2;重试条件:408 / 409 / 429 / 5xx / 网络错误
max_retries=2,
# 自定义请求头
headers={\"x-app\": \"my-service/1.0\"},
)
“
Python SDK 的
timeout和 TaskHandle 的poll_interval/max_wait单位都是秒,TypeScript SDK 用的是毫秒,跨语言迁移时要特别注意。详见 SDK 任务轮询与流式响应。“
SDK 默认读取
ACEDATACLOUD_API_TOKEN环境变量;本文为了和 Claude Code VS Code 教程 等其它教程统一,示例里用的是ACEDATACLOUD_API_KEY,需要api_token=os.environ[\"ACEDATACLOUD_API_KEY\"]显式注入。
进阶:X402 支付钩子
from acedatacloud import AceDataCloud
from acedatacloud_x402 import create_x402_payment_handler
client = AceDataCloud(
payment_handler=create_x402_payment_handler(
network=\"base\",
evm_signer=my_evm_signer,
prefer_scheme=\"exact\", # 或 \"upto\"
)
)
完整流程和真实链上结果见 SDK + X402 支付钩子。
如何查看剩余额度
通过 Ace Data Cloud 控制台 - 应用列表,即可查看当前账户的剩余额度。
通过 Ace Data Cloud 控制台 - 使用历史 即可查看所有使用历史和扣费详情。
了解更多
- 🐍
acedatacloudon PyPI - 🗂 SDK 源码
- 📘 TypeScript SDK 接入教程
- 🟦 Go SDK 接入教程
- 🔌 SDK + X402 支付钩子
版权声明
本站仅做备份收录,仅供研究与教学参考之用。
读者将信息用于其他用途的,全部法律及连带责任由读者自行承担,本站不承担任何责任。









评论