更新日期
Responses
OpenAI Responses API 兼容入口,与 /v1/chat/completions 共用 chat 模型与计费。服务端会把 input / instructions 转成 chat messages 交给模型服务;返回 object: "response" 与 output 数组。
支持文本、Vision、文件附件与 function calling。input message 的 content 可为字符串,或含 input_text / input_image / input_file(也会接受 chat 风格的 text / image_url / file)的数组。input_file 可用 file_data(data URL / base64)或公网 file_url;内嵌数据会先转存。网关把 Responses 的 function tools 转成 chat tools 交给模型服务,再把结果放进 output 里的 function_call。网关不执行函数。previous_response_id、有状态 store 以及 web_search 等内置工具会被忽略或返回 400。file_id / /v1/files 不可用,传入返回 400。
请求
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 对外 id(capability = chat) |
input | string | array | 是 | 字符串等价于一条 user 文本;数组为 message / item 列表 |
instructions | string | 否 | 作为 system 消息前置 |
stream | boolean | 否 | true 时 SSE(Responses 事件流) |
temperature | number | 否 | 作用于所选模型 |
max_output_tokens | number | 否 | 映射为所选模型的 max_tokens |
tools | array | 否 | 仅 type: "function",字段为顶层 name / description / parameters / strict。也接受 chat 嵌套的 function.name |
tool_choice | string | object | 否 | none / auto / required,或 { "type": "function", "name": "..." }。设置时必须同时传 tools |
parallel_tool_calls | boolean | 否 | 是否允许并行函数调用。设置时必须同时传 tools |
多轮时在 input 里带回上一次的 function_call(call_id、name、arguments)和 function_call_output(call_id、output)。连续的 function_call 会合成一条带多个 tool_calls 的 assistant 消息。
curl https://tokenmei.com/v1/responses \
-H "Authorization: Bearer $MOMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_CHAT_MODEL",
"instructions": "你是助手",
"input": "你好",
"temperature": 0.7,
"max_output_tokens": 2048
}'响应
同步成功时 status 为 completed(触达 max_output_tokens 时可能为 incomplete)。文本在 output[].content[].text;官方 SDK 可用 output_text 快捷读取。
usage 使用 Responses 字段名:input_tokens / output_tokens / total_tokens。若平台开启对客展示费用,可能附带 usage.cost。
流式
stream: true 时返回 SSE,事件类型包括 response.created、response.output_text.delta、response.completed 等,与 OpenAI Responses 流式约定一致。
curl -N https://tokenmei.com/v1/responses \
-H "Authorization: Bearer $MOMO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "YOUR_CHAT_MODEL",
"input": "写一句问候",
"stream": true
}'