Responses

使用 OpenAI Responses 风格接口创建多模态响应。

Responses API 使用 input 作为统一输入，适合新的 OpenAI Responses 风格模型，也支持流式输出、工具调用、推理配置和上下文续接。

端点

方法路径说明
POST/v1/responses创建响应
POST/v1/responses/compactResponses 压缩接口，字段较少

请求参数

字段类型必填说明
modelstring是模型 ID
inputstring 或 array是输入内容。可包含 input_text、input_image、input_file
instructionsstring否系统级指令
streamboolean否是否返回 SSE 流
max_output_tokensinteger否最大输出 token 数
temperature、top_pnumber否采样参数
tools、tool_choicearray/object否工具配置
parallel_tool_callsboolean否是否允许并行工具调用
max_tool_callsinteger否最大工具调用次数
previous_response_idstring否续接上一轮响应
reasoningobject否推理配置，例如 effort、summary
textobject否文本输出格式配置
include、truncationany否OpenAI Responses 扩展字段
metadata、userany否元数据或用户标识
store、service_tier、safety_identifierany否OpenAI 扩展字段，可能受渠道设置过滤

curl 示例

curl https://api.tensoraxis.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $TENSORAXIS_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "input": "用两句话解释什么是 API 网关"
  }'

多模态输入示例

{
  "model": "gpt-4o",
  "input": [
    {
      "role": "user",
      "content": [
        {"type": "input_text", "text": "描述这张图片"},
        {"type": "input_image", "image_url": "https://example.com/image.png"}
      ]
    }
  ]
}

压缩接口

/v1/responses/compact 接收更小的请求体：

字段类型必填说明
modelstring是模型 ID
inputany否待压缩输入
instructionsany否指令
previous_response_idstring否上一轮响应 ID

响应结构

响应遵循 OpenAI Responses 风格，核心字段包括 id、model、output、usage。流式响应会以 SSE 事件返回增量内容。

On this page

端点请求参数curl 示例多模态输入示例压缩接口响应结构