获取灵感回复

根据当前用户与指定角色的对话上下文，生成最多 3 条可供用户选择的灵感回复。

每个用户每天前 10 次免费，第 11 次起每次消耗 3 钻石。

请求URL：

• /inspirationReply

请求方式：

• POST

认证：

• 需要登录，请在请求头携带 Authorization: Bearer {token}。

请求头：

参数：

请求示例：

{
    "appId": "com.example.app",
    "udid": "device-uuid",
    "roleId": 3209,
    "npcId": 0,
    "branchKey": "",
    "isSmartPhone": false
}

成功返回示例：

{
    "code": 200,
    "msg": "SUCCESS",
    "data": {
        "list": [
            "*Steps closer and meets her gaze.* \"Tell me what happened.\"",
            "*Lets out a quiet laugh.* \"Are you always this dramatic?\"",
            "*Turns toward the door.* \"Come on, let's find out together.\""
        ],
        "maxFreeCount": 10,
        "remainingFreeCount": 6
    }
}

返回参数说明：

失败返回示例：

{
    "code": 800,
    "msg": "param error:Key: 'RoleId' Error:Field validation for 'RoleId' failed on the 'required' tag",
    "data": {
        "list": [],
        "maxFreeCount": 10,
        "remainingFreeCount": 6
    }
}

{
    "code": 510,
    "msg": "Network is busy. Please try again later.",
    "data": {
        "list": [],
        "maxFreeCount": 10,
        "remainingFreeCount": 6
    }
}

错误码：

备注：

• 接口为同步调用，服务端会结合当前角色、场景、分支、NPC、对话记忆及最近一条角色回复生成内容。
• 客户端不需要传入聊天文本；dialogueCurrent 使用当前分支最近一条角色回复。没有历史角色回复时，使用角色开场白。
• 模型可能返回 Markdown 代码块或附带说明文本，服务端会提取其中的 JSON 字符串数组；解析出 1～3 条时均正常返回，超过 3 条时只返回前 3 条。
• 当模型返回内容无法解析出任何有效回复时，服务端会使用相同参数最多兜底重试 10 次；任意一次解析成功即停止重试并正常返回。
• 当 npcId > 0 时，即使未传 isSmartPhone，服务端也会自动启用小手机聊天上下文。
• 每个用户每天前 10 次成功生成的灵感回复免费；生成失败或返回内容解析失败不计入次数。
• 第 11 次及之后每次消耗 3 钻石。余额不足时返回错误码 730，不会调用模型。
• 付费生成成功并扣费后，服务端会通过 SSE 推送最新余额。
• 无论接口成功或失败，data 都会返回 maxFreeCount 和 remainingFreeCount。如果登录用户或当日次数无法识别，remainingFreeCount 返回 0。
• 免费次数仅在成功生成灵感回复后减少；生成失败时返回调用前的剩余次数。
• 首次请求及最多 10 次兜底均无法解析出灵感回复时，接口返回 Network is busy. Please try again later.，模型原始返回内容仅记录在服务端日志和后台统计记录中。