查询最近 LLM 消息 ID

查询当前用户在指定会话中的最大消息 ID。

GET https://api.moi.matrixorigin.cn/v5/workspaces/{workspace_id}/llm/sessions/{session_id}/messages/latest

调用前准备

BASE_URL 使用产品 API 前缀 https://api.moi.matrixorigin.cn/v5;专有部署填写对应的产品 API 地址。

配置同一环境的工作区身份与变量。

请求

curl --request GET \
  "$BASE_URL/workspaces/$WORKSPACE_ID/llm/sessions/$SESSION_ID/messages/latest?completed_only=true" \
  --header "X-API-Key: $MOI_KEY" \
  --header "X-Workspace-ID: $WORKSPACE_ID"

参数

位置

类型

必填

说明

workspace_id

路径

string

是

目标工作区,与 X-Workspace-ID 一致。

session_id

路径

integer

是

本服务返回的正整数 ID。

completed_only

查询

string

否

值为 1 或不区分大小写的 true 时,只取 status=completed;其他值按不限制状态。

没有匹配消息时 message_id 为 0。此读取不独立检查会话记录是否存在,因此 0 不能证明会话存在或不存在。completed 是存储状态,不是模型任务完成证明。当前 SDK/CLI 专用最近消息方法没有 completed_only 参数;需要该条件时使用经核对的 HTTP 或通用资源请求。

成功响应

{
  "code": 0,
  "data": {
    "message_id": 0
  }
}

字段

类型

说明

code

integer

成功为 0;HTTP 状态码为 200。

data.message_id

integer

最大消息 ID;无匹配消息时为 0。

错误响应

错误格式与读取范围说明身份、参数、资源读取与存储失败的不同结果。

最后更新于