返回文档首页

Responses API - API 文档

OpenAI 新一代对话接口,统一处理文本、工具调用与结构化输出。

接口说明 这是什么

Responses API 是 OpenAI 新一代对话接口,用 input 替代 messages,交互方式更统一。

有什么用:与 Chat 对话类似,适合需要工具调用(function calling)、结构化输出的新项目。习惯传统方式的用户直接用 Chat 对话 即可。

请求信息

项目值
请求方法POST
请求路径https://103.236.87.35/v1/responses
https://103.236.87.35/v1/responses/compact(会话压缩)
请求头Authorization: Bearer <你的密钥>
Content-Type: application/json
是否需要鉴权必需
是否计费按 Token 计费

请求参数

参数名类型必填默认值说明
modelstring是-模型名称
inputstring/array是-输入内容:字符串或消息对象数组(含 role/content)
instructionsstring否-系统指令,相当于 system 消息
max_output_tokensinteger否模型默认输出最大 token 数
temperaturenumber否1随机性
streamboolean否false是否流式返回
toolsarray否-工具定义(function calling)

怎么请求 请求示例

curl

curl https://103.236.87.35/v1/responses \
  -H "Authorization: Bearer <你的密钥>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "instructions": "你是一个简洁的助手",
    "input": "用一句话介绍你自己",
    "max_output_tokens": 200
  }'

Python

from openai import OpenAI

client = OpenAI(api_key="<你的密钥>", base_url="https://103.236.87.35/v1")
resp = client.responses.create(
    model="deepseek-v4-flash",
    instructions="你是一个简洁的助手",
    input="用一句话介绍你自己",
)
print(resp.output_text)

返回示例 成功响应

{
  "id": "resp_xxx",
  "object": "response",
  "status": "completed",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [{"type": "output_text", "text": "我是你的 AI 助手。"}]
    }
  ],
  "usage": {"input_tokens": 15, "output_tokens": 20, "total_tokens": 35}
}

返回字段说明

字段名类型说明
idstring本次响应唯一 ID
statusstring状态:completed 完成 / in_progress 进行中
output[].content[].textstring回复文本内容
usageobjecttoken 用量(计费依据)

其他接口

接口说明
POST /v1/chat/completionsChat 对话(流式 SSE)查看 →
POST /v1/completions文本补全查看 →
POST /v1/embeddings向量嵌入查看 →
POST /v1/responsesResponses API查看 →
GET /v1/models模型列表查看 →
GET /v1/me账号余额查询查看 →
GET/POST /v1/notifications平台通知查看 →
GET /v1/_install_check安装自检查看 →