额度与周期
每账号每月赠送固定调用额度，用尽后可申请一次追加，额度不跨月累计。
Developers / 开发者中心
半天跑通第一局 AI 对局
星欧平台对外只暴露少量稳定接口：会话、对局、审核与回调。剩下的模型调度、状态同步与容灾都在平台内部完成，接入方不需要理解推理细节。
Quickstart
四步完成接入
沙箱与生产使用同一套接口，迁移时只需要更换密钥与域名。
STEP 01
申请密钥
注册开发者账号，创建应用后获取沙箱密钥与额度。
STEP 02
创建会话
调用会话接口绑定角色卡与场景，得到会话标识。
STEP 03
接入对局
通过 WebSocket 建立长连接，收发对话与对局事件。
STEP 04
处理回调
接收审核与异常回调，按约定完成处置与重试。
# 1. 创建会话（沙箱环境）
curl -X POST https://sandbox.api.example/v4/session \
-H "Authorization: Bearer $XINGOU_KEY" \
-H "Content-Type: application/json" \
-d '{ "character": "lin-yao", "scene": "night-market", "safety": true }'
# 2. 返回
{
"session_id": "sess_8f2c...",
"ws_url": "wss://sandbox.api.example/v4/stream",
"expires_in": 7200
}提示：示例中的域名为文档占位地址，实际接入地址以控制台「应用详情」页展示的域名为准。所有请求必须使用 HTTPS 或 WSS。
API
核心接口一览
四个接口覆盖 90% 的接入场景，其余接口用于运营与数据分析。
| 接口 | 方法 | 用途 | 关键限制 |
|---|---|---|---|
| /v4/session | POST | 创建会话，绑定角色卡与场景 | 单应用并发受套餐限制 |
| /v4/stream | WSS | 对话流式收发与对局事件推送 | 单连接空闲 5 分钟断开 |
| /v4/match | POST | 发起匹配并获取房间信息 | 需先完成实名配置 |
| /v4/review | POST | 提交内容审核，返回处置建议 | 同步 ≤ 50ms，异步 ≤ 1s |
| /v4/callback | POST | 平台向业务方推送审核与异常事件 | 需验签，失败重试 5 次 |
错误码与重试策略
星欧平台把所有错误分成三类：可重试、需修正、需人工介入。SDK 默认对第一类做指数退避重试，其余两类直接抛给业务层，避免把问题掩盖在重试里。
- 429 / 503：限流或节点切换，SDK 自动退避重试。
- 400 / 422：参数或配置错误，需修正后重发。
- 451：内容被审核拦截，不得自动重试，需按流程处置。
sdk / default policyv4
最大重试3 次指数退避
初始间隔200 ms上限 2s
超时5 s可配置
回调验签HMAC-SHA256必开
Sandbox
沙箱规则
沙箱是公共资源，请按约定使用，异常调用会被限流。
数据边界
沙箱数据与生产环境完全隔离，角色卡与对话记录按 30 天滚动清理。
内容约束
沙箱同样开启内容审核。用于测试违规拦截时，请使用文档提供的测试语料。
不建议在沙箱里做的事
- 把沙箱密钥写进公开仓库或客户端代码，密钥泄露会立即被冻结。
- 用脚本对接口做压测，沙箱不承诺并发能力，压测请提交生产评估申请。
- 把沙箱用于真实用户运营。沙箱不具备生产级 SLA，也不支持实名与支付接入。
Support
遇到问题怎么找人
Q01文档里找不到某个能力怎么办？
先看「常见问题」页是否覆盖；仍未解决的，可在开发者控制台提交工单，或在每周四的技术答疑时段预约 30 分钟沟通。星欧娱乐的工程师会直接对接，不经过多层转述。
Q02SDK 支持哪些语言？
官方维护 JavaScript / TypeScript、Go 与 Python 三套 SDK，覆盖会话、流式对话、匹配与回调验签。其他语言可直接按 REST 与 WebSocket 协议接入。
Q03能否拿到示例工程的源码？
可以。控制台提供三种玩法模板的完整源码，包括一个纯前端对战 Demo、一个叙事向模板和一个匹配型模板，均可在沙箱直接运行。
Q04从沙箱迁移到生产要改什么？
只需替换域名与密钥，并在控制台完成资质提交与审核策略确认。接口路径与返回结构保持不变，迁移通常不超过半天。