协议接口
Responses
OpenAI Responses 接口。
Responses 是单独协议入口
Responses 使用 /v1/responses,不是 Chat Completions 的别名。OpenAI 新项目和 Codex 类工具通常优先看这个入口;模型、usage 字段和流式完成事件都按 Responses 协议处理。
路径
| 用途 | 方法与路径 |
|---|---|
| 模型调用 | POST /v1/responses |
请求示例
curl https://dingjiai.com/v1/responses \
-H "Authorization: Bearer YOUR_USER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Responses 可用的 public model id",
"input": "用一句话说明 Responses 接口适合什么场景"
}'流式请求
curl -N https://dingjiai.com/v1/responses \
-H "Authorization: Bearer YOUR_USER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "Responses 可用的 public model id",
"stream": true,
"input": "分三步说明如何排查 API 调用失败"
}'服务端正常读到完成事件时,流式 Responses 会从完成事件里的 response usage 中提取用量;上游断流、客户端取消、usage 缺失或格式异常时不能完成正常结算。
请求字段
Prop
Type
usage 与计费
结算读取 usage.input_tokens、usage.output_tokens,以及可选的 usage.input_tokens_details.cached_tokens。
Responses 以平台开放模型为准
当前没有对外的 /v1/responses 专用模型列表。接入 Responses 时,请使用平台或管理员明确开放给 Responses 协议的 public model id;不要把 GET /v1/models 返回的 Chat Completions 模型直接视为 Responses 可用。
最后更新于