查询 Response 输入项¶

分页读取已保存 Response 使用的输入项。完整输入内容能否取回取决于所选模型服务。

GET https://token.moi.matrixorigin.cn/v1/responses/$RESPONSE_ID/input_items

调用前准备¶

在支持保存和取回的模型服务上创建 Response，并开启保存。选择仍可访问、未删除且未过期的响应。
准备创建该响应时使用的个人访问令牌。

请求示例¶

将示例中的 $GENESIS_ACCESS_TOKEN 和 $RESPONSE_ID 分别替换为个人访问令牌和所选响应的 ID。

不指定分页参数¶

curl -X GET \
  "https://token.moi.matrixorigin.cn/v1/responses/$RESPONSE_ID/input_items" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN"

读取第一页¶

curl --get \
  "https://token.moi.matrixorigin.cn/v1/responses/$RESPONSE_ID/input_items" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN" \
  --data-urlencode 'limit=1' \
  --data-urlencode 'order=asc'

读取下一页¶

当 has_more 为 true 时，将上一页的 last_id 保存为 $LAST_ITEM_ID，使用相同的排序读取下一页。has_more 为 false 时停止。

curl --get \
  "https://token.moi.matrixorigin.cn/v1/responses/$RESPONSE_ID/input_items" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN" \
  --data-urlencode 'limit=1' \
  --data-urlencode 'order=asc' \
  --data-urlencode "after=$LAST_ITEM_ID"

路径参数¶

参数	类型	是否必填	说明
`response_id`	string	是	已保存 Response 的标识，取自创建响应返回的 `id`。

查询参数¶

参数	类型	是否必填	说明
`limit`	integer	否	每页项数，示例设为 `1`；支持范围由所选模型服务决定。
`order`	string	否	排列顺序：`asc` 或 `desc`。
`after`	string	否	从上一页的 `last_id` 之后继续读取。

成功响应¶

成功时返回本页输入项及下一页标记。

响应示例

{
  "data": [
    {
      "id": "item-example-1",
      "type": "message",
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Reply with OK."
        }
      ]
    }
  ],
  "first_id": "item-example-1",
  "last_id": "item-example-1",
  "has_more": true
}

字段说明

字段	类型	说明
`data`	array of object	本页输入项。
`data[].id`	string	输入项标识，可用作下一页游标。
`data[].type`	string	项类型，文本消息为 `message`。
`data[].role`	string	输入消息的角色。
`data[].content`	array of object	输入消息的文本块。
`data[].content[].type`	string	文本块类型 `input_text`。
`data[].content[].text`	string	输入文本。
`first_id`	string	本页第一项的标识。
`last_id`	string	本页最后一项的标识；用作 `after` 继续读取。
`has_more`	boolean	是否还有下一页；为 `false` 时停止翻页。

错误响应¶

响应不存在、已删除、已过期或当前凭据无法访问时，返回 HTTP 404。确认响应 ID 和创建时使用的凭据。

响应示例

{
  "error": {
    "message": "response state not found",
    "type": "response_state_not_found",
    "code": "response_state_not_found"
  }
}

字段说明

字段	类型	说明
`error`	object	错误信息。
`error.message`	string	不可访问或不存在的响应说明。
`error.type`	string	错误类别。
`error.code`	string	错误代码。

最后更新于 2026 年 9 月 8 日