POST/v1/chat/completions

创建对话补全

使用 OpenAI Chat Completions 格式生成回复。

API Key application/json

Request

请求

/v1/chat/completions

Body

必填

Bodyobject

modelstring必填

从 GET /v1/models 返回的模型 ID。

messagesarray必填

按时间顺序排列的对话消息。

streamboolean

为 true 时使用 SSE 流式返回。

temperaturenumber

模型支持时控制输出随机性。

路径、查询与 Header 参数

此接口没有额外的路径、查询或 Header 参数。

请求示例application/json

curl -X POST https://top.qingyuntop.ai/v1/chat/completions \
+  -H "Authorization: Bearer ${QINGYUN_TOP_API_KEY}" \
+  -H "Content-Type: application/json" \
+  -d '{
  "model": "your-model-id",
  "messages": [
    {
      "role": "user",
      "content": "你好"
    }
  ],
  "stream": false
}'

Response

返回响应 `200`

成功响应

响应 200object

idstring

示例chatcmpl_example

objectstring

示例chat.completion

choicesarray<object>

元素object

indexinteger

示例0

messageobject

rolestring

示例assistant

contentstring

示例你好，有什么可以帮你？

finish_reasonstring

示例stop

响应示例application/json

{
  "id": "chatcmpl_example",
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好，有什么可以帮你？"
      },
      "finish_reason": "stop"
    }
  ]
}