AceData平台PythonSDK接入教程"

admin 2026-10-20 13:17:37 网络安全文章 来源:ZONE.CI 全球网 0 阅读模式

cover_image示例 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 控制台 - 使用历史 即可查看所有使用历史和扣费详情。

了解更多

  • 🐍 acedatacloud on PyPI
  • 🗂 SDK 源码
  • 📘 TypeScript SDK 接入教程
  • 🟦 Go SDK 接入教程
  • 🔌 SDK + X402 支付钩子

AceData平台PythonSDK接入教程" 网络安全文章

AceData平台PythonSDK接入教程"

本文详细介绍AceDataCloud平台PythonSDK的安装配置与使用方法,涵盖同步/异步客户端调用ChatCompletions、图像生成等核心功能,提供完整的代码示例和错误处理机制,并说明SSE流式响应、类型校验等特性。
挖洞思路|CORS配置漏洞背后的信任陷阱,赏金猎人如何靠逻辑链破防?" 网络安全文章

挖洞思路|CORS配置漏洞背后的信任陷阱,赏金猎人如何靠逻辑链破防?"

本文深入分析CORS配置漏洞的两种实战场景:一是受信子域名存在XSS漏洞时攻击者可利用CORS信任关系窃取主站敏感数据;二是HTTPS主站将HTTP子域列入白名单导致安全链路被降维打击。文章强调需从整体信任网络角度审视CORS白名单中每个源的安全状况,为渗透测试人员提供了通过逻辑链挖掘高危漏洞的方法论。
[译苑雅集Vol.12]高强度使用Mythos两个月后,Cloudflare打造了一套不依赖单一模型的企业级漏洞发现工程系统" 网络安全文章

[译苑雅集Vol.12]高强度使用Mythos两个月后,Cloudflare打造了一套不依赖单一模型的企业级漏洞发现工程系统"

Cloudflare构建了一套不依赖单一AI模型的企业级漏洞发现系统,通过将模型作为可替换组件实现跨模型交叉验证。系统采用两阶段工作流(VDH漏洞发现引擎和VVS验证系统),具备状态外置、持久化存储和跨仓库依赖追踪能力。关键实践包括分阶段控制上下文窗口、使用独立验证模型复核发现、通过wishlist机制实现agent自主资源请求。建议从最小化三阶段harness开始,逐步扩展至多仓库扫描。
评论:0   参与:  0