环境地址#
| 用途 | 地址 |
|---|---|
| REST | https://open.shengzhiai.com |
| WebSocket | wss://open.shengzhiai.com |
SDK 不需要为沙箱改任何配置,换上沙箱密钥即可。
沙箱密钥#
沙箱密钥是环境标记为 sandbox 的 API Key,由平台为接入方开通。申请方式:在控制台提交工单,标题写“申请 SDK 沙箱密钥”,注明接入方名称与联系人,平台开通后在工单里回复 appKey 与 secretKey。一个接入方默认开通一把,联调结束后可申请停用。
额度与限制#
| 项 | 沙箱 | 生产 |
|---|---|---|
| 每日调用次数 | 每把密钥 200 次,北京时间零点重置 | 按套餐 |
| 超出后 | HTTP 429,错误码 42903,当日不可重试 | 按套餐与余额 |
| 计费 | 不扣套餐与余额,照常写调用记录 | 按调用计费 |
| 并发评测数 | 每个接入方账号 2 路,账号下的沙箱密钥合计 | 按套餐层级 |
| AI 报告 | 每个接入方账号每日 1000 份 | 按套餐层级 |
| 幂等 | 与生产相同,同一个键只计一次 | 同左 |
| 数据保留 | 与生产相同 | 同左 |
| 服务等级 | 不承诺可用性,平台维护时可能中断 | 按合同 |
每日次数在调用前预留额度时统计,幂等重放不经过预留,不占次数。
集成测试用法#
SDK 仓库的集成测试读取三个环境变量,未设置时只跑本地模拟服务端的测试:
Shell
export YUGU_SANDBOX_APPKEY=ak_xxx
export YUGU_SANDBOX_SECRET=xxx
export YUGU_SANDBOX_BASE=https://open.shengzhiai.com密钥不要写进代码仓库与构建日志,持续集成里用流水线的密钥配置注入。