跳转到主要内容

​
Responses API 概览

Responses API 是 OpenAI 推出的新一代 API 格式，旨在简化多步骤任务和工具调用的开发体验。Crazyrouter 完整支持 Responses API。

​
Responses API vs Chat Completions API

特性Responses APIChat Completions API
端点/v1/responses/v1/chat/completions
消息格式input (字符串或数组)messages (数组)
工具调用内置支持，自动管理上下文需要手动管理消息历史
流式格式丰富的事件类型简单的 delta 格式
思考模式reasoning 参数reasoning_effort 参数
Web 搜索内置 web_search 工具通过 tools 参数
兼容性较新，部分模型支持广泛支持所有模型

​
何时使用 Responses API

适合以下场景：
  • 需要内置工具（Web 搜索、文件搜索）
  • 多步骤任务和复杂工具调用
  • 需要丰富的流式事件
  • 使用 GPT-5 等新模型的高级功能

​
何时使用 Chat Completions API

适合以下场景：
  • 需要最广泛的模型兼容性
  • 简单的对话和文本生成
  • 已有基于 Chat Completions 的代码
  • 使用非 OpenAI 模型（Claude、Gemini 等）

​
快速对比示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://crazyrouter.com/v1"
)

response = client.responses.create(
    model="gpt-4o",
    input="解释什么是 REST API"
)

print(response.output_text)
两种 API 可以在同一个项目中混合使用。Crazyrouter 对两种格式都提供完整支持，你可以根据具体需求选择合适的 API。