# 沙箱环境

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

来源：https://open.shengzhiai.com/sdk/v2/sandbox/

## 环境地址

| 用途 | 地址 |
|---|---|
| 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 仓库的集成测试读取三个环境变量，未设置时只跑本地模拟服务端的测试：

```bash
export YUGU_SANDBOX_APPKEY=ak_xxx
export YUGU_SANDBOX_SECRET=xxx
export YUGU_SANDBOX_BASE=https://open.shengzhiai.com
```

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