> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hubto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 对话补全

> OpenAI 兼容聊天补全接口。

## 用途

用于发送多轮对话请求，生成文本回复。

## 请求头

<ParamField header="Authorization" type="string" default="Bearer YOUR_API_KEY" required>
  Bearer 鉴权请求头，格式为 `Bearer YOUR_API_KEY`。
</ParamField>

## 请求体

<ParamField body="model" type="string" default="glm-5.1" required>
  模型名称，例如 `gpt-5.4`。
</ParamField>

<ParamField body="messages" type="object[]" default="[{&#x22;role&#x22;:&#x22;user&#x22;,&#x22;content&#x22;:&#x22;你好，请介绍一下 HubTo。&#x22;}]" required>
  对话消息数组，至少包含一条用户消息。
</ParamField>

<ParamField body="temperature" type="number" default="0.7">
  可选，控制生成随机性。
</ParamField>

<ParamField body="stream" type="boolean" default="false">
  可选，是否启用流式返回。
</ParamField>

<ParamField body="max_tokens" type="integer" default="512">
  可选，限制本次生成的最大输出 token 数。
</ParamField>

## 示例请求体

```json theme={null}
{
  "model": "gpt-5.4",
  "messages": [
    {
      "role": "user",
      "content": "你好，请介绍一下 HubTo。"
    }
  ],
  "temperature": 0.7
}
```

## 响应

<ResponseField name="id" type="string">
  请求 ID。
</ResponseField>

<ResponseField name="choices" type="object[]">
  生成结果数组，内容通常位于 `choices[0].message.content`。
</ResponseField>

<ResponseField name="usage" type="object">
  Token 使用统计。
</ResponseField>