Skip to content

Chat Completions

已停止支持

Chat Completions 接口目前已不再受支持,请迁移至 Responses 接口。

创建一个 OpenAI 兼容的对话补全请求,兼容 OpenAI Chat Completions API。

请求

POST https://api.mirrorstages.com/openai/v1/chat/completions

请求头

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

请求体

参数类型必填说明
modelstring模型名称,如 claude-sonnet-4-6-20250514
messagesarray消息列表,每条包含 rolecontent
streamboolean是否启用流式输出,默认 false
max_completion_tokensinteger最大输出 token 数
temperaturenumber采样温度,范围 0~2
top_pnumbernucleus 采样参数
frequency_penaltynumber频率惩罚,范围 -2~2
presence_penaltynumber存在惩罚,范围 -2~2
toolsarray工具定义列表
tool_choicestring/object工具调用策略
response_formatobject响应格式约束
reasoning_effortstring推理努力程度

请求示例

bash
curl https://api.mirrorstages.com/openai/v1/chat/completions \
  -H "Authorization: Bearer your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6-20250514",
    "messages": [
      {"role": "user", "content": "Hello!"}
    ]
  }'

响应

非流式响应

json
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "created": 1677858242,
  "model": "claude-sonnet-4-6-20250514",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Hello! How can I help you today?"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 8,
    "completion_tokens": 12,
    "total_tokens": 20
  }
}

流式响应

stream: true 时,响应以 SSE 格式返回,每个事件的 data 字段为一个 JSON 对象:

json
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion.chunk",
  "created": 1677858242,
  "model": "claude-sonnet-4-6-20250514",
  "choices": [
    {
      "index": 0,
      "delta": {
        "content": "Hello"
      },
      "finish_reason": null
    }
  ]
}