Responses

Responses 接口适合使用 OpenAI Responses 协议的客户端、编码代理和新一代应用框架。它通常用于需要统一输入结构、工具调用、推理控制或更复杂响应结构的场景。

Endpoint

POST /v1/responses

完整地址：

https://www.routeapi.ai/v1/responses

请求示例

curl https://www.routeapi.ai/v1/responses \
  -H "Authorization: Bearer $ROUTEAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "input": "请说明 RouteAPI 的主要用途"
  }'

常见参数

字段	类型	必填	说明
model	string	是	模型 ID
input	string/array	是	输入内容
instructions	string	否	系统级指令
stream	boolean	否	是否流式输出
tools	array	否	工具定义
tool_choice	string/object	否	工具选择策略
temperature	number	否	采样温度
max_output_tokens	number	否	最大输出 token 数

与 Chat Completions 的区别

项目	Chat Completions	Responses
输入结构	messages	input + instructions
兼容范围	传统 OpenAI SDK 兼容客户端最多	新协议客户端和编码代理更常用
工具调用	支持，取决于所选模型	支持，通常表达能力更强
推荐场景	通用聊天、兼容接入	新项目、编码代理、复杂任务

接入建议

• 如果客户端明确要求 OpenAI Responses 协议，使用 /v1/responses。
• 如果客户端只支持传统 OpenAI Chat Completions，使用 /v1/chat/completions。
• 同一个模型是否支持 Responses 取决于 RouteAPI 模型配置和服务能力。