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": "rsn-****75mmr",
"object": "response",
"created_at": 1763021238,
"status": "completed",
"model": "qwen3-14b",
"output": [
{
"id": "msg-*****kk6js",
"type": "message",
"status": "completed",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "百度千帆(Baidu Qianfan)是百度公司推出的一站式人工智能开发平台,旨在为开发者、企业和研究机构提供全面的人工智能工具和服务,帮助用户更高效地构建、训练和部署人工智能模型。\n\n### 百度千帆的核心特点:\n\n1. **模型即服务(MaaS)**:\n - 百度千帆提供多种预训练模型,如ERNIE Bot、文心一言(Wenxin Yiyi)等,用户可以直接调用这些模型进行自然语言处理、文本生成、对话理解等任务,无需从零开始训练模型。\n\n2. **模型训练与优化**:\n - 提供模型训练平台,支持用户自定义数据集进行模型训练和微调,帮助用户根据具体业务需求优化模型性能。\n\n3. **推理服务**:\n - 支持模型的部署和推理服务,用户可以将训练好的模型部署为API服务,方便集成到各种应用场景中。\n\n4. **开发工具链**:\n - 提供一系列开发工具,包括代码编辑器、调试工具、模型评估工具等,帮助开发者更高效地进行AI开发。\n\n5. **行业解决方案**:\n - 针对不同行业(如金融、医疗、教育、制造业等)提供定制化的人工智能解决方案,帮助企业实现智能化升级。\n\n6. **开放生态**:\n - 百度千帆致力于构建开放的AI生态,与开发者、企业和研究机构合作,推动人工智能技术的发展和应用。\n\n### 百度千帆的应用场景:\n\n- **智能客服**:通过自然语言处理技术,实现智能问答和对话理解。\n- **内容生成**:如文章、报告、营销文案等自动生成。\n- **数据分析与预测**:利用机器学习模型进行数据挖掘和预测分析。\n- **图像识别与处理**:如人脸识别、图像分类、目标检测等。\n- **语音识别与合成**:支持语音转文字、文字转语音等功能。\n\n### 百度千帆的发展目标:\n\n百度千帆的目标是降低人工智能的使用门槛,让更多的企业和开发者能够轻松地使用AI技术,推动AI技术在各个行业的广泛应用和深度融合。\n\n如需了解更多关于百度千帆的详细信息,可以访问百度AI开放平台官网或相关技术文档。"
}
]
}
],
"usage": {
"input_tokens": 24,
"output_tokens": 482,
"output_tokens_details": {
"reasoning_tokens": 0
},
"total_tokens": 506
}
}
"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
}
}
错误码
如果请求错误,服务器返回的JSON文本包含以下参数。
| 名称 | 描述 |
|---|---|
| code | 错误码 |
| message | 错误描述信息,帮助理解和解决发生的错误 |
| type | 错误类型 |
更多相关错误码,请查看模型错误码说明。
