SecondMe APIAPI 变更日志
SecondMe API 的最近变更与更新
2026-03-30
新增：分身对话 API（Visitor Chat）
新增分身对话接口，支持第三方应用接入 SecondMe 分身的实时对话能力。
新增接口：
| 接口 | 说明 |
|---|---|
POST /api/oauth/token/client | OAuth2 client_credentials grant，获取应用级 token（匿名用户场景） |
POST /api/secondme/visitor-chat/init | 初始化分身对话，返回 WebSocket 连接凭证 |
POST /api/secondme/visitor-chat/send | 发送消息，AI 回复通过 WebSocket 推送 |
支持两种身份模式：
- 实名用户：用户已通过 OAuth 登录，直接使用 access token
- 匿名用户：通过
client_credentials获取应用 token，携带visitorId标识匿名访客
主要特性：
- 分身 API Key（
sk-前缀）标识和哪个分身对话 - WebSocket 实时推送 AI 流式回复
/send自动恢复 session（token/缓存过期时透明刷新，无需重新 init）- 匿名用户支持
visitorName显示名称，分身中心自动显示来源应用名称
详见 分身对话文档。
2026-03-28
profileCompleteness 字段从百分比改为等级
GET /api/secondme/user/info 返回的 profileCompleteness 字段含义变更：
| 变更前 | 变更后 |
|---|---|
| 资料完整度百分比（0-100） | 资料等级（0-10） |
Breaking Change：如果您的应用依赖 profileCompleteness 做 0-100 范围的判断逻辑，需要适配为 0-10 范围。
2026-03-23
Refresh Token 有效期从 30 天延长至 365 天
POST /api/oauth/token/code 签发的 Refresh Token 有效期由 30 天延长至 365 天。已签发的活跃 Refresh Token 也已同步延长。客户端无需做任何改动。
2026-03-19
新增：Chat 和 Act 流式接口支持 maxTokens 参数
POST /chat/stream 和 POST /act/stream 现在支持可选参数 maxTokens（整数，范围 1–16000，默认 2000）。调用方可按需调大输出 token 上限，避免长回复被截断。
- 不传时行为不变（默认 2000）。
- 传入无效值（如 0 或 >16000）将返回 422 校验错误。
2026-03-11
Token 刷新接口移除 Refresh Token 轮换
POST /api/oauth/token/refresh 接口不再执行 Refresh Token 轮换。刷新时返回的 refreshToken 与请求中传入的相同，Refresh Token 在 365 天有效期内可重复使用。
此变更适用于 Confidential Client（需要 client_secret 的后端应用）场景，client_secret 已提供足够的安全保障，移除轮换可避免网络异常导致的 Token 丢失问题。
2026-02-24
Add Note 接口暂时不可用
POST /note/add 接口暂时不可用，后续将被废弃。请使用 Agent Memory Ingest 接口作为替代方案来写入结构化记忆数据。
2026-02-22
新增：Agent Memory Ingest API
新增 Agent Memory 接口，允许第三方应用向用户的 SecondMe 写入结构化记忆数据：
POST /agent_memory/ingest— 批量写入记忆条目，支持 channel 信息和引用元数据。- 认证方式：OAuth2 Token（Bearer）。
ChannelInfo和RefItem中的platform字段由服务端根据应用的 Client ID 自动填充，无需手动设置。
API Base URL 迁移
API 基础地址已迁移：
| 迁移前 | 迁移后 |
|---|---|
https://app.mindos.com | https://api.mindverse.com |
所有 API 请求应使用新的基础地址。旧地址可能暂时仍可访问，但不再受官方支持。