Skip to content

Responses ​

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

请求 ​

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

请求头 ​

名称类型必填说明
Authorizationstring是Bearer your-api-key
Content-Typestring是application/json

请求体 ​

参数类型必填说明
modelstring是模型名称,如 claude-sonnet-4-6-20250514
inputstring/array是输入内容,可以是字符串或消息数组
streamboolean否是否启用流式输出,默认 false
max_output_tokensinteger否最大输出 token 数
temperaturenumber否采样温度
top_pnumber否nucleus 采样参数
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 — 响应完成