创建模型响应
本文介绍 Responses API 创建模型请求时的输入参数,供您使用接口时查阅字段含义。
支持模型列表
支持文本生成类模型,详细模型列表请参见Responses API 使用指南-支持模型。
权限说明
调用本文API,需使用API Key鉴权方式。使用API Key鉴权调用API流程,具体调用流程,请查看认证鉴权。
请求参数
多选一,只需要符合下列任意一组子节点
发送给模型的文本、图像或文件输入,用于生成响应。
显示子属性
隐藏子属性
输入给模型的文本类型信息,等同于使用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(Model ID)。
多选一,只需要符合下列任意一组子节点
显示子属性
隐藏子属性
作为模型上下文中第一项插入的系统消息。
多选一,只需要符合下列任意一组子节点
显示子属性
隐藏子属性
是否以流式接口的形式返回数据,默认false。
多选一,只需要符合下列任意一组子节点
显示子属性
隐藏子属性
温度值控制输出的随机性,取值范围[0-2],默认为1。 温度值高,输出结果更具随机性和创造性。 温度值低,输出结果更集中、确定和可预测。
频率惩罚。设为正值时,惩罚已频繁出现的词元,降低重复率。 默认值因模型而异,取值范围:[-2.0, 2.0]。
存在惩罚。设为正值时,惩罚所有已出现的词元,鼓励谈论新主题。 默认值因模型而异,取值范围:[-2.0, 2.0]。
多选一,只需要符合下列任意一组子节点
显示子属性
隐藏子属性
输出文本的多样性,取值越大,生成文本的多样性越强。默认为1。
多选一,只需要符合下列任意一组子节点
模型在生成响应时可调用的工具数组,支持按需选择下列多种类型对象。
显示子属性
隐藏子属性
知识库工具。
显示子属性
隐藏子属性
工具类型,值为:knowledge_search。
知识库的ID。
函数调用(Function Calls)工具。
显示子属性
隐藏子属性
描述函数参数的 JSON Schema 对象。
要调用的函数名称。
函数工具调用类型,固定值为function。
函数的描述,模型使用此描述来决定是否调用该函数。
POST /v2/responses HTTP/1.1
Host: qianfan.baidubce.com
Authorization: Bearer <您的API Key>
Content-Type: application/json
{
"input":"请介绍下百度千帆",
"model":"qwen3-14b"
}
示例代码
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": "什么是百度千帆?"
}
]
}'
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 '{
"tools": [
{
"type": "knowledge_search",
"knowledgebase_ids": "8fb9950d-********-be65-449bc60f0544"
},
{
"type": "function",
"name": "get_current_weather",
"description": "天气查询工具",
"parameters": {
"properties": {
"location": {
"description": "地理位置,精确到市级别",
"type": "string"
},
"time": {
"description": "时间,格式为YYYY-MM-DD",
"type": "string"
}
}
}
}
],
"input": [
{
"role": "user",
"content": "我需要两项信息:第一,请从知识库中获取陶波湖的介绍?;第二,请调用天气查询功能来获取北京市今天的天气情况。"
}
],
"model": "qwen3-14b"
}'
返回响应
{
"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
}
}
