The Response Object
创建模型请求 后,模型会返回一个 response 对象。本文为您介绍 response 对象包含的详细参数。
请求参数
示例代码
curl -X POST "https://qianfan.baidubce.com/v2/responses" \
-H "Host: qianfan.baidubce.com" \
-H "Authorization: Bearer <您的API Key>" \
-H "Content-Type: application/json" \
-d '{
"model": "qwen3-14b",
"input": [
{
"role": "user",
"content": "什么是百度千帆?"
}
]
}'
返回响应
一分钟内允许的最大请求次数。
一分钟内允许的最大输入tokens消耗。
一分钟内允许的最大输出tokens消耗。
达到RPM速率限制前,剩余可发送的请求数配额,如果配额用完,将会在0-60s后刷新。
达到TPM速率限制前,剩余可消耗的输入tokens数配额,如果配额用完,将会在0-60s后刷新
达到TPM速率限制前,剩余可消耗的输出tokens数配额,如果配额用完,将会在0-60s后刷新
本次请求创建时间的 Unix 时间戳(秒)。
本次响应的唯一标识符。
用于生成响应的模型 ID。
资源对象类型,固定为response。
响应状态:completed、failed、in_progress、cancelled、queued 或 incomplete。
多选一,只需要符合下列任意一组子节点
模型生成的内容项数组,长度与顺序取决于模型响应。支持按需返回下列多种类型对象。
显示子属性
隐藏子属性
output message
显示子属性
隐藏子属性
输出消息的内容。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
模型生成的文本输出。
输出文本的类型,始终为output_text。
一些附注信息。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
固定为doc_citation。
片段 id。
文本。
文件 id。
文件名称。
输出消息的唯一ID。
输出消息的角色,固定值为assistant。
消息输入的状态。支持in_progress、completed、incomplete。
输出消息类型,固定值为message。
Function Tool Call
显示子属性
隐藏子属性
传递给函数的参数的JSON字符串。
模型生成的函数工具调用的唯一ID。
要运行的函数名称。
函数工具调用类型,固定值为function_call。
函数工具调用的唯一ID。
项目状态。支持in_progress、completed、incomplete。
reasoning
显示子属性
隐藏子属性
推理内容的唯一标识符
输出消息的内容。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
模型生成的推理内容输出。
输出文本的类型,始终为reasoning_text。
对象类型,固定值为reasoning。
项目状态。支持in_progress、completed、incomplete。
knowledge_search_call
显示子属性
隐藏子属性
总为knowledge_search_call。
本次请求的唯一标识。
项目状态。支持in_progress、completed、incomplete。
多选一,只需要符合下列任意一组子节点
当模型无法生成响应时返回的错误对象。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
响应的错误码。
错误的可读描述信息。
多选一,只需要符合下列任意一组子节点
关于响应不完整时的详细信息。
显示子属性
隐藏子属性
响应不完整的原因。
显示子属性
隐藏子属性
多选一,只需要符合下列任意一组子节点
显示子属性
隐藏子属性
插入系统或开发者消息作为上下文中的第一项。
多选一,只需要符合下列任意一组子节点
显示子属性
隐藏子属性
采样温度,范围 0–2,数值越高输出越随机。
多选一,只需要符合下列任意一组子节点
模型可能使用的工具数组,包括内置工具与自定义函数调用。支持按需返回下列多种类型对象。
显示子属性
隐藏子属性
由您定义的函数,使模型能够使用强类型参数和输出调用您自己的代码。
显示子属性
隐藏子属性
函数工具的类型,固定值为function。
描述函数参数的 JSON Schema 对象
函数的描述。模型使用此描述来决定是否调用该函数
要调用的函数名称。
用于扩展模型的能力,例如knowledge_search。
显示子属性
隐藏子属性
此处只为knowledge_search。
知识库的 id。
多选一,只需要符合下列任意一组子节点
显示子属性
隐藏子属性
nucleus sampling 的概率阈值,替代temperature使用。
值根据迄今为止文本中的现有频率对新token进行惩罚,从而降低模型逐字重复同一行的可能性。 默认值各模型不同,取值范围:[-2.0, 2.0]
正值根据token记目前是否出现在文本中来对其进行惩罚,从而增加模型谈论新主题的可能性。 默认值各模型不同,取值范围:[-2.0, 2.0]
一些附注信息。
显示子属性
隐藏子属性
一些附注信息。
显示子属性
隐藏子属性
固定为doc_citation。
片段 id。
文本。
文件 id。
文件名称。
表示 token 使用详情,包括输入 token、输出 token、输出 token 的细分以及使用的总 token 数。
显示子属性
隐藏子属性
输入 token 的数量。
输出 token 的数量。
使用的总 token 数量。
输出 token 的详细细分。
显示子属性
隐藏子属性
推理 token 的数量。
模型上轮响应的唯一ID,用于创建多轮对话。
是否存储生成的模型响应以供后续通过API检索,默认为true。
存储有效期截止时间,用于指定store(上下文存储)何时失效。
请传入一个 UTC 标准的 Unix 时间戳(单位:秒)。 存储时长从创建时刻起算,最长保留 3 天。
{
"id": "resp-abc123",
"object": "response",
"created_at": 1765357234,
"status": "completed",
"model": "qwen3-coder-30b-a3b-instruct",
"output": [
{
"id": "msg-***2cc7",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "百度千帆是百度推出的一站式大模型开发及应用构建平台。以下是其主要特点:\n\n## 核心功能\n- **模型开发**:提供大模型训练、调优工具\n- **应用构建**:支持快速构建AI应用\n- **模型部署**:简化模型上线和管理流程\n\n## 主要优势\n- **易用性**:提供可视化界面,降低技术门槛\n- **高效性**:加速从模型训练到应用部署的全过程\n- **集成性**:与百度其他AI产品和服务深度整合\n\n## 应用场景\n- 企业级AI应用开发\n- 智能客服系统\n- 内容创作辅助\n- 数据分析处理\n- 自然语言处理任务\n\n## 目标用户\n- AI开发者和工程师\n- 企业技术团队\n- 需要AI能力的各类组织\n\n千帆平台旨在帮助企业和个人更便捷地利用大模型技术,推动AI技术的普及和应用。"
}
]
}
],
"usage": {
"input_tokens": 13,
"output_tokens": 212,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 225
},
"store": true,
"expire_at": 1765616434
}
"id": "rsn-****j21",
"object": "response",
"created_at": 1763032030,
"status": "completed",
"model": "qwen3-14b",
"tools": [
{
"type": "knowledge_search",
"knowledgebase_ids": "8fb9950d-****-449bc60f0544"
},
{
"type": "function",
"name": "get_current_weather",
"description": "天气查询工具",
"parameters": {
"properties": {
"location": {
"description": "地理位置,精确到市级别",
"type": "string"
},
"time": {
"description": "时间,格式为YYYY-MM-DD",
"type": "string"
}
}
}
}
],
"output": [
{
"id": "ks-****xcvj42",
"type": "knowledge_search_call",
"status": "completed"
},
{
"id": "fc-****bd",
"type": "function_call",
"status": "completed",
"arguments": "{\"location\": \"北京市\", \"time\": \"2024-04-14\"}",
"name": "get_current_weather",
"call_id": "9e1f243c****796c79185cdcc8d"
}
],
"usage": {
"input_tokens": 4858,
"output_tokens": 134,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 4992
},
"store": true,
"expire_at": 1765616434
}
错误码
如果调用失败并返回报错信息,请参见错误码进行解决。
公共错误码:查看公共错误码
本接口专有错误码如下:
| HTTP状态码 | 类型 | 错误码 | 错误信息 | 说明 |
|---|---|---|---|---|
| 500 | conflict_error | resource_already_in_use | previous response id resp-xxx is already in use | previous_response_id正在被其他请求占用 |
