POST
创建模型响应
POST /v1/responses — 创建模型响应(Responses API)
创建模型响应
使用 Responses API 创建模型响应,支持内置工具调用和更丰富的输出格式。
参考:OpenAI 官方文档
POST
https://api000.com/v1/responses
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model |
string | ✅ | 模型 ID,如 gpt-4.1、o3-pro |
input |
string / array | ✅ | 用户输入,可为字符串或消息数组 |
stream |
boolean | 可选 | 是否流式返回,默认 false |
tools |
array | 可选 | 内置工具列表(见下方) |
instructions |
string | 可选 | 系统指令(相当于 system message) |
max_output_tokens |
integer | 可选 | 最大输出 Token 数 |
temperature |
number | 可选 | 采样温度,默认 1 |
top_p |
number | 可选 | 核采样 |
previous_response_id |
string | 可选 | 上一轮响应 ID(实现多轮对话) |
请求示例
基础对话
from openai import OpenAI
client = OpenAI(base_url="https://api000.com/v1", api_key="sk-xxxxxxxxxxxxxxxx")
response = client.responses.create(
model="gpt-4.1",
input=[{"role": "user", "content": "请用 Python 写一个快速排序算法"}]
)
print(response.output[0].content[0].text)
cURL
curl https://api000.com/v1/responses \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \
-d '{
"model": "gpt-4.1",
"input": [
{
"role": "user",
"content": "请介绍量子计算的基本原理"
}
]
}'
响应示例
{
"id": "resp_67ccd2bed1ec8190b14f964abc8d3074",
"object": "response",
"created_at": 1741476542,
"model": "gpt-4.1",
"status": "completed",
"output": [
{
"type": "message",
"role": "assistant",
"content": [
{
"type": "output_text",
"text": "量子计算是利用量子力学原理..."
}
]
}
],
"usage": {
"input_tokens": 20,
"output_tokens": 150,
"total_tokens": 170,
"input_tokens_details": {
"cached_tokens": 0,
"text_tokens": 20
},
"output_tokens_details": {
"reasoning_tokens": 0
}
}
}
内置工具
| 工具类型 | 说明 |
|---|---|
web_search_preview |
实时网页搜索 |
file_search |
向量文件检索 |
computer_use_preview |
计算机控制(实验性) |
code_interpreter |
代码解释器 |
使用 o3-pro(仅支持 Responses 格式)
response = client.responses.create(
model="o3-pro",
input=[{"role": "user", "content": "分析这道复杂的数学证明题..."}]
)