创建模型响应
创建模型响应，发送请求给模型并获取响应内容，返回包含响应ID和生成内容的完整信息
权限说明
调用本文API，需使用API Key鉴权方式。使用API Key鉴权调用API流程，具体调用流程，请查看认证鉴权。
请求参数
输入内容，发送给模型的输入。
可以是简单文本，也可以是复杂的对象数组（包含对话历史）。
模型标识，用于生成响应的模型ID。
可选择符合一个或多个
系统指令，作为模型上下文中的第一项插入。
可选参数，用于指导模型的行为和输出风格。
显示子属性
隐藏子属性
可选择符合一个或多个
流式传输开关，是否开启流式传输（SSE）。
true：开启流式传输
false：不开启流式传输（默认值）
显示子属性
隐藏子属性
可选择符合一个或多个
采样温度，控制生成文本的随机性，取值范围为 0-2，默认值为 1。
较高值（如 1.8）使输出更随机，较低值（如 0.2）使输出更确定和集中。
显示子属性
隐藏子属性
可选择符合一个或多个
核采样参数，控制模型考虑的 token 范围，默认值为 1。
该参数与 temperature 配合使用，影响生成结果的多样性。
显示子属性
隐藏子属性
频率惩罚系数，取值范围为 [-2.0, 2.0]。
降低模型逐字重复的可能性，正值会根据新 token 在文本中的现有频率对其进行惩罚。
存在惩罚系数，取值范围为 [-2.0, 2.0]。
增加模型谈论新主题的可能性，正值会根据新 token 是否出现在文本中对其进行惩罚。
工具列表，模型可调用的工具列表（包含函数或内置工具）。
用于扩展模型的能力，使其能够调用外部函数或工具。
显示子属性
隐藏子属性
显示子属性
隐藏子属性
POST /v2/responses HTTP/1.1
HOST: qianfan.baidubce.com
Authorization: Bearer <API Key>
Content-Type: application/json
{
"input": "你好，请介绍一下人工智能",
"model": "ernie-bot",
"instructions": "请用中文回答",
"stream": false,
"temperature": 1,
"top_p": 1,
"frequency_penalty": 0,
"presence_penalty": 0,
"tools": []
}示例代码
发送文本输入给模型并获取响应
curl -X POST "https://qianfan.baidubce.com/v2/responses" \
-H "Authorization: Bearer bce-v3/ALTAK-******ZftZDTn7/125eeb1c5e9ddc8cf3edf18ef6d03f1517ec9408" \
-H "Content-Type: application/json" \
-d '{
"input": "你好，请介绍一下人工智能",
"model": "ernie-bot",
"instructions": "请用中文回答",
"stream": false,
"temperature": 1,
"top_p": 1,
"frequency_penalty": 0,
"presence_penalty": 0,
"tools": []
}'返回响应
响应唯一标识符，用于标识本次响应请求。
对象类型，固定为 response，标识返回对象的类型。
创建时间，响应创建的时间戳（秒），格式为 Unix 时间戳。
响应状态，标识当前响应的状态。
completed：已完成
failed：失败
in_progress：进行中
incomplete：不完整
模型标识，生成响应的模型 ID，与请求中的 model 参数对应。
输出内容，模型生成的内容项数组，包含助手角色返回的消息内容。
显示子属性
隐藏子属性
Token 使用情况，包含输入、输出和总 token 数量的详细统计信息。
显示子属性
隐藏子属性
输入 token 数量。
输出 token 数量。
总 token 数量。
输出 token 详细信息。
显示子属性
隐藏子属性
推理 token 数量。
错误信息对象，仅在 status 为 failed 时返回，包含错误的详细描述。
显示子属性
隐藏子属性
不完整详情，响应不完整的详细原因，仅在 status 为 incomplete 时返回。
显示子属性
隐藏子属性
模型成功生成响应内容
{
"id": "resp_123456789",
"object": "response",
"created_at": 1678886400,
"status": "completed",
"model": "ernie-bot",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "人工智能是一门研究、开发用于模拟、延伸和扩展人的智能的理论、方法、技术及应用系统的新技术科学。"
}
]
}
],
"usage": {
"input_tokens": 100,
"output_tokens": 200,
"total_tokens": 300,
"output_tokens_details": {
"reasoning_tokens": 50
}
}
}