跳转到主要内容
调用 Responses API,获取模型生成的响应数据。该接口兼容 OpenAI Responses API 的请求与响应格式。

请求地址

POST https://api.stepfun.com/v1/responses

请求参数

  • model string required
    需要使用的模型名称。当前仅支持 step-3.7-flash
  • input string or object array required
    输入内容,可以是纯文本字符串,也可以是按时序排列的消息/事件数组。
图片和视频 URL 必须能被服务端公网访问;如果服务端无法抓取 URL,会返回参数错误。图片输入推荐使用 base64 data URL,以避免外部 URL 鉴权、防盗链或网络访问失败。
  • instructions string optional
    顶层系统级指令。
  • stream bool optional
    是否启用 SSE 流式输出,默认 false
  • temperature float optional
    采样温度,介于 0.0 和 2.0 之间。
  • top_p float optional
    核采样参数。
  • max_output_tokens int optional
    限制本次响应的最大输出 token 数。
max_output_tokens 会同时限制推理过程和最终输出。使用 medium / high 推理强度、JSON Schema、视频等复杂输入时,建议预留更大的输出预算;预算不足时响应可能返回 status="incomplete"output 中可能只有 reasoning 项而没有最终 message
  • reasoning object optional
    推理配置。
  • tools object array optional
    工具定义列表。当前仅支持 function 类型工具。
  • tool_choice string or object optional
    工具调用策略。当前仅支持字符串 "auto"(由模型自行决定是否调用工具)。
  • text object optional
    文本输出格式配置。

响应格式

非流式响应

stream=false(默认)时,返回单个 Response 对象。

属性

  • id string
    响应唯一 ID,格式形如 resp_xxx
  • object string
    固定为 response
  • created_at int
    创建时间的 Unix 时间戳(秒)。
  • completed_at int or null
    完成时间的 Unix 时间戳(秒)。
  • status string
    响应状态,取值为 completedincompletefailed
  • error object or null
    错误信息,仅在 status=failed 时非空。
  • incomplete_details object or null
    未完成详情,仅在 status=incomplete 时非空,常见为 { "reason": "max_output_tokens" }
  • model string
    实际使用的模型 ID。
  • output object array
    输出项数组。元素可能为以下类型:
  • usage object
    token 使用统计。
  • instructions string or null
    回显请求中的顶层指令。
  • max_output_tokens int or null
    回显请求参数。
  • reasoning object or null
    回显推理配置。
  • temperature float or null
    回显采样温度。
  • top_p float or null
    回显核采样参数。
  • text object
    回显文本输出格式配置。
  • tool_choice string or object
    回显工具调用策略。
  • tools object array
    回显工具定义列表。

示例

流式响应

stream=true 时,返回 Server-Sent Events (SSE) 流式数据。每条事件由 event: 行和 data: 行组成。 每个事件的 data 对象都包含 typesequence_numbertypeevent 名称保持一致;sequence_number 从 0 开始递增,可用于客户端按顺序处理事件。

事件类型

事件名触发时机
response.created响应创建
response.in_progress开始生成
response.output_item.added新输出项创建
response.reasoning_part.added推理内容块开始
response.reasoning_text.delta推理文本增量
response.reasoning_text.done推理文本完成
response.reasoning_part.done推理内容块完成
response.content_part.added文本内容块开始
response.output_text.delta文本增量
response.output_text.done文本完成
response.content_part.done内容块完成
response.function_call_arguments.delta工具参数增量
response.function_call_arguments.done工具参数完成
response.output_item.done输出项完成
response.completed响应完成
response.incomplete因输出截断结束
response.failed生成失败
error传输层错误

示例

文本流式输出:
工具调用流式输出(节选):

示例