Appearance
Chat Completions
已停止支持
Chat Completions 接口目前已不再受支持,请迁移至 Responses 接口。
创建一个 OpenAI 兼容的对话补全请求,兼容 OpenAI Chat Completions API。
请求
POST https://api.mirrorstages.com/openai/v1/chat/completions请求头
| 名称 | 类型 | 必填 | 说明 |
|---|---|---|---|
Authorization | string | 是 | Bearer your-api-key |
Content-Type | string | 是 | application/json |
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 模型名称,如 claude-sonnet-4-6-20250514 |
messages | array | 是 | 消息列表,每条包含 role 和 content |
stream | boolean | 否 | 是否启用流式输出,默认 false |
max_completion_tokens | integer | 否 | 最大输出 token 数 |
temperature | number | 否 | 采样温度,范围 0~2 |
top_p | number | 否 | nucleus 采样参数 |
frequency_penalty | number | 否 | 频率惩罚,范围 -2~2 |
presence_penalty | number | 否 | 存在惩罚,范围 -2~2 |
tools | array | 否 | 工具定义列表 |
tool_choice | string/object | 否 | 工具调用策略 |
response_format | object | 否 | 响应格式约束 |
reasoning_effort | string | 否 | 推理努力程度 |
请求示例
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
}
]
}