查询 Response¶

查询已保存的 Response。可读取的输出内容和保存时长取决于模型服务。

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

调用前准备¶

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

认证方式见 Genesis 凭据规则。

请求参数¶

将示例中的 $RESPONSE_ID、$GENESIS_ACCESS_TOKEN 替换为实际值。

输入示例

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

参数说明

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

成功响应¶

响应示例

{
  "id": "resp-example",
  "object": "response",
  "status": "completed",
  "model": "MODEL_ID",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "OK"
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 12,
    "output_tokens": 1,
    "total_tokens": 13
  }
}

字段说明

字段	类型	说明
`id`	string	Response 标识。保存后可用于查询和删除。
`object`	string	对象类型 `response`。
`status`	string	生成状态，例如 `completed`。应结合状态判断输出是否完整。
`model`	string	处理请求的模型。
`output`	array of object	输出项，文本消息可能位于推理项之后。
`output[].type`	string	输出项类型，例如 `message` 或 `reasoning`。
`output[].role`	string	消息输出项的角色。
`output[].content`	array of object	模型服务返回的完整响应可能包含内容块。本地保存的摘要不含此字段。
`output[].content[].type`	string	生成文本块使用 `output_text`。
`output[].content[].text`	string	模型服务返回的生成文本。本地仅保存摘要，无法取回原文。
`output[].summary`	array of object	推理输出项返回的摘要，存在时读取。
`output[].summary[].type`	string	摘要块类型，例如 `summary_text`。
`output[].summary[].text`	string	摘要文本。
`usage`	object	本次调用的 Token 用量。
`usage.input_tokens`	integer	输入 Token 数。
`usage.output_tokens`	integer	输出 Token 数。
`usage.total_tokens`	integer	Token 总数。

错误响应¶

响应不存在、已删除、已过期或当前凭据无法访问时，返回 HTTP 404。

核对响应 ID，并使用创建响应时的账户和凭据。换用账户或凭据后，可能无法访问原有响应。
使用服务账号时，即使响应由自身创建，也可能无法查询。
使用服务账号 OAuth 令牌时，确认令牌有效且有权访问目标响应。

响应示例

{
  "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 年 10 月 19 日