创建模型响应
本文介绍 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。
频率惩罚。设为正值时,惩罚已频繁出现的词元,降低重复率。 默认值因模型而异,取值范围:[-2.0, 2.0]。
存在惩罚。设为正值时,惩罚所有已出现的词元,鼓励谈论新主题。 默认值因模型而异,取值范围:[-2.0, 2.0]。
多选一,只需要符合下列任意一组子节点
显示子属性
隐藏子属性
输出文本的多样性,取值越大,生成文本的多样性越强。默认为1。
多选一,只需要符合下列任意一组子节点
模型在生成响应时可调用的工具数组,支持按需选择下列多种类型对象。
显示子属性
隐藏子属性
知识库工具。
显示子属性
隐藏子属性
工具类型,值为:knowledge_search。
知识库的ID。
函数调用(Function Calls)工具。
显示子属性
隐藏子属性
描述函数参数的 JSON Schema 对象。
要调用的函数名称。
函数工具调用类型,固定值为function。
函数的描述,模型使用此描述来决定是否调用该函数。
是否存储生成的模型响应以供后续通过API检索,默认为 true。
设置存储的过期时刻。需传入 UTC Unix 时间戳(单位:秒),对 store(上下文存储)生效,默认保留3天。 取值范围:(创建时刻, 创建时刻+259200],即最多保留3天。
模型上一个响应的唯一 id,用于创建多轮对话。
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": "resp-abc123",
"object": "response",
"created_at": 1765357234,
"status": "completed",
"model": "qwen3-coder-30b-a3b-instruct",
"output": [
{
"id": "msg-***b2cc7",
"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
}
