Session API

当服务端需要显式管理用户、会话、消息和 revision 时使用 Session API。所有请求都必须从服务端发送并携带 API key。

Authorization: Bearer $ZIWEI_API_KEY
Content-Type: application/json

创建会话并绑定用户

curl https://chat-api.iztro.com/v2/platform/sessions \
  -H "Authorization: Bearer $ZIWEI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"external_user_id":"user_42","model":"iztro-ziwei-v3"}'

响应字段使用 session_id。

本命与中长期分析使用 iztro-ziwei-v3；一件具体事件的决断使用 iztro-qimen-v3。调用奇门模型时，建议在发送消息时用 current_datetime 传入用户当地的 ISO 8601 问事时刻：

会话默认走更快的非思考路径。如需整个会话使用深度推理，可在创建会话时加入 "reasoning_effort": "high"。也可以在某次发送、编辑或重新生成请求中使用同一标准字段覆盖会话设置；该轮需要非思考路径时发送 "none" 或 "low"。

{
  "message": "现在应该推进这项合作吗？如果可以，什么时候行动？",
  "reasoning_effort": "high",
  "current_datetime": "2026-07-20T14:30:00+08:00",
  "language": "zh",
  "enable_iztro_call": true
}

模型选择、问题写法、对外计算名称和应期语义详见模型。

language 是发送、流式发送、编辑和重新生成操作的单轮回复设置，支持 zh、en、ko、ja、vi。当输出必须只使用一种语言且不能夹杂源语言时请显式设置；省略时自动跟随当前对话语言。

Session API 有意只暴露持久会话所需的控制项：模型、推理强度、回复语言、当地问事时刻、应用指令和托管工具开关。采样和开发者工具设置属于 SDK 或 Chat Completions 请求，完整矩阵见模型设置。

用户和会话管理

操作	方法和路径
列出用户所有会话	GET /v2/platform/users/{external_user_id}/sessions?limit=20
查看一个会话	GET /v2/platform/sessions/{session_id}
更新会话元数据	PATCH /v2/platform/sessions/{session_id}
查看消息	GET /v2/platform/sessions/{session_id}/messages
发送消息	POST /v2/platform/sessions/{session_id}/messages
流式发送	POST /v2/platform/sessions/{session_id}/messages/stream
编辑消息	POST .../messages/{message_id}/edit
重新生成	POST .../messages/{message_id}/resend
流式编辑/重试	在路径末尾增加 /stream

编辑和重新生成

编辑会基于修改后的用户消息创建新 revision；resend 保留用户消息并重新生成助手回答。请保存返回的 revision_id 和 message_id。

delete 和 fork 目前不是公开平台路由，文档不提供未公开 endpoint。