跳到主要内容

Responses API

当前状态

🟡 路由就绪，渠道尚未开放 —— 请求路径、协议与转发逻辑都已实现，但当前还没有上游渠道提供该能力，调用会返回「模型不支持」类错误。

渠道一开就能用，你的客户端配置和请求格式都不用改。详见 接口开放状态。

POST /v1/responses 与 GET /v1/responses（WebSocket）

HTTP 请求​

curl https://api.yzgz.cn/v1/responses \
  -H "Authorization: Bearer ***" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MiniMax-M3.1-Flash",
    "input": [{"role": "user", "content": "你好"}]
  }'
字段说明
model模型名
input输入消息数组，也支持单个字符串
instructions等价于 system
streamtrue 走 SSE 流式
tools工具定义

WebSocket​

GET /v1/responses（携带鉴权头）建立一个 WebSocket 连接， 用 Responses API 的事件协议做双向通信。适合会话型交互。

相对 Chat Completions 的差异​

  • input / instructions 命名不同（Chat 用 messages / system）
  • 响应用事件序列（response.created、response.output_item.added 等）
  • 支持 compact（压缩上下文）：见 /v1/responses/compact

注意​

Responses 是较新的协议，不同 SDK 支持程度不一。多数常规应用用 /chat/completions 更稳。Responses 主要用于 对齐 Anthropic/OpenAI 新客端的对话语义。