获取响应上下文
获取某次模型响应对应的全部上下文信息。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看 认证鉴权。
请求参数
响应的唯一标识符。
返回该 ID 之后的输入项,例如,msg-abc123。
返回该 ID 之前的输入项,例如,msg-abc456。
返回对象数量的限制,取值范围 1-100,默认为 20。
返回输入项的顺序,默认为desc。
asc:按照正序排列。desc:按照倒序排列。
GET /v2/responses/{response_id}/input_items?after={after}&before={before}&limit={limit}&order={order} HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <您的API Key>
Content-Type: application/json
示例代码
curl https://qianfan.baidubce.com/v2/responses/resp-abc123/input_items?after=msg-abc123&before=msg-abc456&limit=2&order=desc \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <您的API Key>"
返回响应
资源对象类型,固定为list。
上下文元素列表,与创建模型响应时的input(输入的元素列表)字段结构完全一致。如果请求中引用了previous_response_id,服务器也会返回previous_response包含的上下文。
显示子属性
隐藏子属性
多选一,只需要符合下列任意一组子节点
发送给模型的文本、图像或文件输入,用于生成响应。
显示子属性
隐藏子属性
输入给模型的文本类型信息,等同于使用user角色输入的文本信息。
输入给模型的信息元素,可以包括不同的信息类型。
显示子属性
隐藏子属性
多选一,只需要符合下列任意一组子节点
显示子属性
隐藏子属性
Input Message
显示子属性
隐藏子属性
多选一,只需要符合下列任意一组子节点
输入到模型的文本、图像或音频,用于生成响应。也可以包含先前的assistant响应。
显示子属性
隐藏子属性
输入给模型的文本类型信息,等同于使用user角色输入的文本信息。
包含一个或多个输入项的列表。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
输入给模型的文本类型信息。
输入项的类型,固定值为:input_text。
消息输入的角色,支持user、assistant、system、developer。
消息输入类型,固定值为message。
多选一,只需要符合下列任意一组子节点
item,支持按需选择下列多种类型对象。
显示子属性
隐藏子属性
Input Message
显示子属性
隐藏子属性
包含不同内容类型的模型输入项列表。
显示子属性
隐藏子属性
Input text
显示子属性
隐藏子属性
模型输入的文本。
输入项的类型,固定值为:input_text。
消息输入的角色,支持user、system、developer。
消息输入类型,固定值为message。
项目状态,支持:in_progress、completed、incomplete,通过API返回时填充。
Output Message
显示子属性
隐藏子属性
输出消息的内容。
显示子属性
隐藏子属性
Output text
显示子属性
隐藏子属性
模型生成的文本输出。
输出文本的类型,固定值为:output_text。
附注信息。
显示子属性
隐藏子属性
Doc citation
显示子属性
隐藏子属性
固定值为:output_text。
片段ID。
文本。
文档ID。
文档名称。
输出消息的唯一ID。
输出消息的角色,固定值为:assistant。
消息输入的状态。支持:in_progress、completed、incomplete。
输出消息类型,固定值为:message。
Function Tool Call
显示子属性
隐藏子属性
传递给函数参数的JSON字符串。
模型生成的函数工具调用的唯一ID。
要运行的函数名称。
函数工具调用类型,固定值为:function_call。
函数工具调用的唯一ID
项目状态,支持:in_progress、completed、incomplete。
Function Tool Call Output
显示子属性
隐藏子属性
模型生成的函数工具调用的唯一ID。
函数工具调用输出的JSON字符串。
函数工具调用输出类型,固定值为:function_call_output。
函数工具调用输出的唯一ID。
项目状态,支持:in_progress、completed、incomplete。
Reasoning
显示子属性
隐藏子属性
推理内容的唯一标识符。
输出消息的内容。
显示子属性
隐藏子属性
reasoning text
显示子属性
隐藏子属性
模型生成的推理内容输出。
输出文本的类型,固定值为:reasoning_text。
对象类型,固定值为:reasoning。
项目状态,支持:in_progress、completed、incomplete。
knowledge_search_call
显示子属性
隐藏子属性
固定值为:knowledge_search_call。
本次请求的唯一标识。
项目状态,支持:in_progress、completed、incomplete。
列表中的第一条数据的 ID。
列表中的最后一条数据的 ID。
标识是否还有更多数据未返回。
true:存在未返回的数据。false:已返回全部数据。
{
"object": "list",
"data": [
{
"id": "msg-abc123",
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "今天的天气真不错!"
}
],
"status": "completed"
}
],
"first_id": "msg-***456",
"last_id": "msg-***123",
"has_more": false
}
{
"error": {
"code": "invalid_value",
"message": "parameter check failed, before id message-abc456 not found",
"param": "before",
"type": "invalid_request_error"
},
"id": "as-***ip9k3"
}
错误码
如果调用失败并返回报错信息,请参见错误码进行解决。
公共错误码:查看公共错误码
本接口专有错误码如下:
| HTTP状态码 | 类型 | 错误码 | 错误信息 | 说明 |
|---|---|---|---|---|
| 500 | conflict_error | resource_already_in_use | previous response id resp-xxx is already in use | previous_response_id正在被其他请求占用 |
