OptiWaves

Responses API

参考 POST /v1/responses 的输入、流事件、工具和当前限制。

POST /v1/responses 是新接入的推荐入口。它支持文本、当前轮图片、思考摘要、自定义工具与内置搜索。

最小请求

{
  "model": "auto",
  "input": "给我一个两句话的 WebGPU 概览。"
}

已支持的字段

字段说明
model模型 ID,推荐从 auto 开始;auto-fast 等 Fast ID 用于加速
input字符串或 Responses 输入项数组
instructions本次请求的高层指令
stream是否使用 SSE
max_output_tokens输出 token 上限
reasoning思考等级与摘要请求
tools、tool_choice自定义工具和选择策略
temperature、top_p采样参数
prompt_cache_key用于缓存的稳定标识

流式事件

主要事件包括:

  • response.created 和 response.in_progress
  • response.output_text.delta 与 response.output_text.done
  • response.reasoning_summary_text.delta 与对应完成事件
  • response.function_call_arguments.delta 与 response.function_call_arguments.done
  • response.completed、response.incomplete 或 response.failed

客户端应当以终止事件为准,不要只看 HTTP 连接是否关闭。

继续对话与附件

继续对话时,在 input 中附上需要的历史消息。暂不支持 previous_response_id 和 item_reference。

input_file 和 OpenAI file_id 尚不支持。图片请使用当前轮 data URL,详见工具与图片。

售后群 1055897442

本页