Skip to content

Responses

创建一个 OpenAI Responses API 请求,兼容 OpenAI Responses API。

请求

POST https://api.mirrorstages.com/openai/v1/responses

请求头

名称类型必填说明
AuthorizationstringBearer your-api-key
Content-Typestringapplication/json

请求体

参数类型必填说明
modelstring模型名称,如 claude-sonnet-4-6-20250514
inputstring/array输入内容,可以是字符串或消息数组
streamboolean是否启用流式输出,默认 false
max_output_tokensinteger最大输出 token 数
temperaturenumber采样温度
top_pnumbernucleus 采样参数
instructionsstring系统指令
toolsarray工具定义列表
tool_choicestring/object工具调用策略
reasoningobject推理配置
previous_response_idstring上一条响应的 ID,用于多轮对话

请求示例

bash
curl https://api.mirrorstages.com/openai/v1/responses \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6-20250514",
    "input": "Hello!"
  }'

响应

非流式响应

json
{
  "id": "resp_abc123",
  "object": "response",
  "created_at": 1677858242,
  "model": "claude-sonnet-4-6-20250514",
  "output": [
    {
      "type": "message",
      "role": "assistant",
      "content": [
        {
          "type": "output_text",
          "text": "Hello! How can I help you today?"
        }
      ]
    }
  ],
  "usage": {
    "input_tokens": 8,
    "output_tokens": 12,
    "total_tokens": 20
  }
}

流式响应

stream: true 时,响应以 SSE 格式返回,事件类型包括:

  • response.created — 响应创建
  • response.in_progress — 响应进行中
  • response.output_item.added — 输出项添加
  • response.content_part.added — 内容块添加
  • response.output_text.delta — 文本增量
  • response.output_text.done — 文本完成
  • response.content_part.done — 内容块完成
  • response.output_item.done — 输出项完成
  • response.completed — 响应完成