优谷·雅言SDK 文档2.0.0

沙箱环境

沙箱供接入方联调与 SDK 集成测试使用,与生产使用同一个基址,同一套评测引擎与同一份接口契约,区别只在密钥类型与额度。

查看 Markdown

环境地址#

用途 地址
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

密钥不要写进代码仓库与构建日志,持续集成里用流水线的密钥配置注入。

更新于 2026-10-08