跳转到主要内容

​
创建模型响应

POST /v1/responses
Responses API 提供了更简洁的接口来创建模型响应。

​
认证

Authorization: Bearer YOUR_API_KEY

​
基本请求

curl https://crazyrouter.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "input": "用一句话解释什么是 API"
  }'

​
响应格式

{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1709123456,
  "model": "gpt-4o",
  "output": [
    {
      "type": "message",
      "id": "msg_abc123",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "API 是一组定义了软件组件之间如何交互的规则和协议，让不同的程序能够相互通信和共享数据。"
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 15,
    "output_tokens": 40,
    "total_tokens": 55
  }
}

​
多轮对话

使用 input 数组传入对话历史：
Python
response = client.responses.create(
    model="gpt-4o",
    input=[
        {"role": "user", "content": "我想学习编程"},
        {"role": "assistant", "content": "很好！你想学习哪种编程语言？"},
        {"role": "user", "content": "Python，从哪里开始？"}
    ]
)

print(response.output_text)

​
流式请求

curl https://crazyrouter.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "input": "写一首关于编程的诗",
    "stream": true
  }'

​
流式事件类型

事件类型说明
response.created响应创建
response.in_progress响应处理中
response.output_item.added新输出项添加
response.content_part.added新内容块添加
response.output_text.delta文本增量
response.output_text.done文本完成
response.content_part.done内容块完成
response.output_item.done输出项完成
response.completed响应完成

​
思考控制

使用 reasoning 参数控制推理深度：
Python
response = client.responses.create(
    model="o4-mini",
    input="证明勾股定理",
    reasoning={
        "effort": "high"
    }
)

print(response.output_text)

​
reasoning 参数

字段类型说明
effortstring推理深度：low、medium、high
summarystring思考摘要模式：auto、concise、detailed

​
请求参数

参数类型必填说明
modelstring是模型名称
inputstring|array是输入内容或消息列表
streamboolean否是否流式输出
temperaturenumber否采样温度
max_output_tokensinteger否最大输出 Token 数
toolsarray否可用工具列表
reasoningobject否推理控制
instructionsstring否系统指令（类似 system message）
Responses API 的 input 参数既可以是简单字符串，也可以是消息数组，使用更灵活。