平台按「理解 → 推理 → 生成 → 交付」组织多引擎协同，各层配备备选引擎自动降级链（无缝切换）； 第三方经开放平台 API 直接消费同一套生产级算力编排，无需自建模型运维。

OPE 开放平台开发者沙箱接入指南（测试环境）

2026-08-26 上线。为降低第三方开发者接入门槛，开放平台提供免付费的沙箱 测试通道：注册并验证邮箱后即可自助生成测试 Key，无需充值、无需管理员审批。 沙箱与生产在计费、模型、配额、吊销四个维度完全隔离。

当前开放范围（2026-09-12 更新）：① LLM 智能对话（chat）沙箱与正式均开放； ② 工具任务网关（POST /api/v1/open/tasks）对正式 Key 开放 image 图片生成 / video 视频生成 / checker 内容审核 / civil-check 文明行为图片审核 / mv 照片MV（含银发关怀版）五工具， 沙箱 Key 出于成本管控禁止调用工具；其余创作工具暂仅经站内 Web 界面与 RoboAgent 使用，API 化持续扩展中。

1. 快速开始

1. 注册/登录 OPE，完成邮箱验证；
2. 在「开发者中心」页（/developer/keys，或账单中心开放平台板块）一键创建， 或直接调用 POST /api/user/dev-keys（会话 Cookie 鉴权）自助生成沙箱 Key， 明文以 ope_test_ 开头，仅返回一次，请立即保存；
3. 携带 Authorization: Bearer ope_test_xxx 调用 POST /api/v1/open/chat （请求/响应格式与正式通道完全一致，见 docs/open-api-token.md）；
4. 额度耗尽或需要生产模型时，按 §6 升级路径切换正式 Key。

curl -X POST https://<ope-domain>/api/v1/open/chat \
  -H "Authorization: Bearer ope_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{"model":"qwen-turbo","messages":[{"role":"user","content":"你好"}]}'

沙箱成功响应会额外携带测试环境标识：

{
  "ok": true,
  "data": {
    "environment": "sandbox",
    "sandbox_tokens_remaining": 9620,
    "content": "……",
    "usage": { "prompt_tokens": 12, "completion_tokens": 368, "total_tokens": 380 }
  }
}

响应头同时带 X-OPE-Environment: sandbox，可用于联调期区分测试环境流量。

2. 沙箱配额与限制

3. 管理端点 /api/user/dev-keys

会话鉴权 + 邮箱验证门控（未验证返回 403「请先验证邮箱」）。

4. 错误码（沙箱专属）

通用错误码（400/401/502）与正式通道一致，见 docs/open-api-token.md。

5. 计费安全与审计（平台视角）

• 钱包隔离：沙箱调用记账归属 system → INTERNAL 台账 （toolKey=open-api-sandbox、source=open-gateway.sandbox）， 不触碰用户能量点钱包；Key 泄露也不会造成用户资金损失，最坏成本被 三重配额（RPM ∧ 日次数 ∧ Token 预算）封顶。
• 测试环境标识：ApiKey.isSandbox=true + ope_test_ 前缀 + 响应 environment=sandbox/X-OPE-Environment 头，四处可审计追踪。
• 对账口径：沙箱成本计入 INTERNAL 台账归集，不混入 EXTERNAL 商业营收， E1/E2/E3 对账等式不受影响；审计免费试用消耗： SELECT … FROM "TokenUsageEvent" WHERE "toolKey"='open-api-sandbox'。
• 权限隔离：沙箱 Key 仅在开放网关 /api/v1/open/* 生效；会话侧管理端点 与正式 Key 端点（/api/user/api-keys）互不代管对方的吊销操作。

6. 升级路径（沙箱 → 生产）

1. 充值能量点或订阅套餐（账单中心）；
2. POST /api/user/api-keys 创建正式 Key（ope_sk_ 前缀，付费门控）；
3. 替换 Authorization 头即可，请求体无需任何改动；正式通道解锁： 全部已登记模型、最高 120 RPM、无日次数限制、包内 Token 额度（能力 B）；
4. 沙箱 Key 可保留观察或经 DELETE /api/user/dev-keys 吊销。

关联组件