POST/v1/responses

Responses API

兼容 OpenAI Responses API 的核心请求、流式输出、函数工具与多轮上下文管理。使用 OpenAI SDK 的 client.responses.create() 即可调用。

⚠ 协议限制

Responses API 仅接受模型目录中明确声明 openai/responses 的可用模型；其他模型会在本地直接拒绝，请改用其详情页列出的协议。

当前可调用范围包括百炼白名单中的 Qwen 与 DeepSeek 模型，以及 Azure AI Foundry 的 gpt-6-astra。

请求端点

POSThttps://nexusflow.hk/v1/responses

请求参数

参数	类型	必选	说明
`model`	string	*	模型名称，如 qwen3.8-max、qwen3.7-plus、qwen3.7-max 等
`input`	string \| array	*	纯文本或消息数组（支持 role: user/assistant/system/developer）
`instructions`	string	-	系统指令，插入上下文起始位置
`previous_response_id`	string	-	上一轮响应 ID（有效期 7 天），用于多轮对话
`stream`	boolean	-	是否开启流式输出，默认 false
`store`	boolean	-	是否存储响应（默认 true），false 则不能用 previous_response_id 引用
`tools`	array	-	工具列表。默认开放自定义 function；其他工具需账户白名单和单独成本确认
`tool_choice`	string \| object	-	工具选择策略：auto / none / required
`temperature`	float	-	采样温度，取值 [0, 2)
`top_p`	float	-	核采样概率阈值，取值 (0, 1]
`enable_thinking`	boolean	-	是否开启思考模式
`reasoning`	object	-	思考强度控制，如 {effort: "high"}

代码示例

curl

curl https://nexusflow.hk/v1/responses \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "qwen3.7-plus",
    "input": "你好！"
  }'

工具调用

所有账户默认可使用自定义 function。联网搜索、网页提取和代码解释器属于受管能力，需要账户白名单与额外成本确认；未开通时请求会被明确拒绝。

工具类型	说明
`function`	默认开放。由你定义函数名称和参数，模型需要调用时返回 function_call。
`受管内置工具`	联网搜索、网页提取、代码解释器等仅对已开通账户开放，并可能产生额外的非 Token 费用。

响应格式

非流式请求返回完整的 JSON 对象，object 字段值为 "response"。流式请求返回 SSE 事件流，以 response.completed 事件结束。

字段	类型	说明
`id`	string	响应唯一标识（UUID 格式），有效期 7 天，可用作 previous_response_id
`object`	string	固定为 "response"
`status`	string	completed / failed / in_progress / cancelled
`model`	string	实际使用的模型 ID
`output`	array	输出项数组：message / reasoning / function_call 等
`usage`	object	Token 消耗：input_tokens、output_tokens、total_tokens、input_tokens_details、output_tokens_details

辅助端点

方法	端点	说明
GET	`/v1/responses/{id}`	检索已存储的响应（需 store=true）
DELETE	`/v1/responses/{id}`	删除已存储的响应
GET	`/v1/responses/{id}/input_items`	获取生成响应时使用的输入项列表

支持的模型

协议限制

仅模型详情页明确列出 Responses 的可用模型能够调用此端点。未声明支持时，请改用 /v1/chat/completions 或 /v1/messages。

当前可调用范围包括百炼白名单中的相应 Qwen 与 DeepSeek 模型。预告模型可以展示计划支持的协议，但在状态变为可用前不会进入运行时模型目录。

注意事项

previous_response_id 关联的响应有效期为 7 天。
默认工具白名单只包含 function；其他工具开通前请联系支持确认权限和计费。
设置 store: false 时响应不会被存储，无法被后续引用。
流式输出的最终 response.completed 事件包含完整的 usage 信息。