数字空间 API 调试中心
统一入口:查看端云共同契约,或选择接口调试页面进行本地联调。Token 仅保存在当前页面内存,日志会自动脱敏。
飞书文档
V1.0 正式接口
对话 API
POST /api/v1/dialog/turnPOST /api/v1/dialog/turn-cancel
调试文本对话、SSE 回复、TTS 分片、取消 turn、小 T 状态和请求头。
首页 API
POST /api/v1/home/overview
按当前服务端配置验证首页正式接口、核心资源、空任务、分区降级和核心失败;请求不携带 Mock 参数。
日常内容 API
POST /api/v1/daily-content/overviewPOST /api/v1/daily-content/schedule/readPOST /api/v1/daily-content/fun-fact/queryPOST /api/v1/daily-content/diary/query
验证 30 天日程及日期已读状态、批量上报已读、趣事查询与必要解锁、日记查询与必要生成,以及日常红点;支持请求/响应日志及清理。
用户实际参与日程 API
POST /api/v1/daily-content/user-schedule/reportPOST /api/v1/daily-content/user-schedule/query
上报“一起玩”自然时间区间,验证精确重试 INSERTED/UPDATED、近 30 个自然日查询、跨日切片及 Daily 专用合并预览。
他的内心 API
POST /api/v1/inner-world/overview
验证角色内心分区、认知度、亲密度、锁定态、空态、降级态和“他眼中的你”内容。
消息查询 API
POST /api/v1/message/query
拉取待展示弹窗(亲密度 1→2、2→3)和可选升级 Toast。弹窗一次消费 1 条;Toast 按角色覆盖。
一起玩游戏 API
POST /api/v1/together-play/games
查询配置驱动的可玩游戏列表及 OSS 页面、封面地址。
紧急联系人 API
POST /api/v1/setting/emergency-contact/queryPOST /api/v1/setting/emergency-contact/createPOST /api/v1/setting/emergency-contact/updatePOST /api/v1/setting/emergency-contact/delete
调试联系人查询、新增、修改、删除及脱敏返回;页面日志不展示姓名和手机号明文。
他的印象详情 API
POST /api/v1/inner-world/impression-detail
查询看法和重要回忆:本地第一次一起玩/看,以及对话沉淀的 classic_memory(triggerType=OTHER)。
聊天记录 API
POST /api/v1/dialog/history-datesPOST /api/v1/dialog/history-page
按最近 30 天有数据日期分页查看聊天记录,支持请求与响应联动展示。
内测接口 · digital-space.internal-test.enabled 默认关闭
独立 TTS API
POST /api/v1/tts/synthesize
内测:不纳入 V1.0 交付。按角色调试独立文本转语音、PCM 音频分片、幂等重试和请求头。
V1.1 接口
退出聊天 API
POST /api/v1/dialog/chat-exit
V1.1:终端退出聊天室。成功立即返回 ACCEPTED,并异步通知陪伴记忆。
聊天后处理 API
POST /api/v1/dialog/chat-process
V1.1:提交终端已完成的 query 与 assistantText,异步验证安全并处理聊天记录、亲密度、事实和日常任务。
实时音视频 Token
POST /api/v1/rtc/token
V1.1:按当前角色签发终端进房 Token。可选 roomId;不传时房间号使用 externalUserId。
即兴导演提示词
POST /api/v1/improvisation-director/prompt
V1.1 终端正式接口:按用户、设备和角色依次返回下一条开场提示词。提示词列表本身不按角色区分。
S2S 提示词
POST /api/v1/dialog/s2s-prompt
V1.1 终端正式接口:按当前用户和角色的关系阶段返回拼接提示词。版本一致时省略正文。
调试接口 · digital-space.debug.enabled 默认关闭
会话上下文 API
POST /api/v1/dialog/session-context
调试:预加载角色、日期时间、日程、用户资料、持续话题和长期记忆,供终端侧自行拼装提示词。
聊天事实摘要查询
POST /api/v1/relationship/facts/query
调试:验证 VALID_CHAT 事实、safeEvidence 摘要回写、summaryPresent 和用户/设备/角色隔离。
角色聊天数据删除
POST /api/v1/character/data/delete
按当前用户、设备和角色删除聊天历史。分组开关关闭时此接口不注册。
全双工语音联调
WS /ws/dialog/voice/binary
内部测试:模拟 PCM 麦克风流或本地音频文件,联调 Fun-ASR、Qwen 对话、TTS 回流及抢话控制。浏览器调试握手需在受控环境开启专用开关。
陪伴对话用户上下文
POST /api/v1/dialog/user-context/query
内部测试:查询注入千问的用户资料和持续话题;重要回忆展示仍走印象详情页。
积分服务调试
POST /api/v1/debug/points/proxy
联调领取、消费和余额查询。分组开关关闭时此接口不注册。
趣事生成验证
POST /api/v1/debug/daily-content/fun-fact/preview
内部调试:手填 1~3 条日程,按线上提示词和模型生成趣事。只返回结果,不写入趣事表。
提示词资源下载
classpath:/prompts
内部调试:查看并下载系统提示词、S2S 阶段提示词和即兴导演提示词。
用户角色绑定查询
POST /api/v1/debug/user-character/query
按 dnum 查询 user_character。分组开关关闭时此接口不注册。
陪伴记忆通知
POST /api/v1/debug/xiaot-area/companion-memory/on-dialog
内部调试:按当前环境的 ai-xiaot-area 地址通知对话完成。地址留空时使用服务端 digital-space.xiaot-area.base-url。