下载 Markdown

更新日期

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。

请求

字段类型必填说明
modelstring是对外 id(capability = chat)
inputstring | array是字符串等价于一条 user 文本;数组为 message / item 列表
instructionsstring否作为 system 消息前置
streamboolean否true 时 SSE(Responses 事件流)
temperaturenumber否作用于所选模型
max_output_tokensnumber否映射为所选模型的 max_tokens
toolsarray否仅 type: "function",字段为顶层 name / description / parameters / strict。也接受 chat 嵌套的 function.name
tool_choicestring | object否none / auto / required,或 { "type": "function", "name": "..." }。设置时必须同时传 tools
parallel_tool_callsboolean否是否允许并行函数调用。设置时必须同时传 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
}'
Responses · MomoAI算力超市