# 流式文本返回

逐步接收文本内容，避免等待完整回复。

`POST /v1/chat/completions`

<a id="authentication"></a>

## 鉴权

使用 Authorization: Bearer YOUR_API_KEY。所选模型须在该密钥分组内开放；JSON 请求使用 Content-Type: application/json。

<a id="parameters"></a>

## 参数



| 字段 | 类型 | 必填 | 说明 |
| --- | --- | --- | --- |
| model | string | 必填 | 使用支持流式返回的模型。 |
| messages | array | 必填 | 与文本对话相同的 role/content 消息数组。 |
| stream | boolean | 必填 | 设为 true。 |

<a id="request"></a>

## 请求示例



```
export OHGROK_API_KEY='YOUR_API_KEY'

curl --no-buffer --fail-with-body --silent --show-error \
  'https://api.ohgrok.com/v1/chat/completions' \
  -H "Authorization: Bearer $OHGROK_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "grok-4.5",
    "messages": [
      {"role": "user", "content": "Give me three short names for a creative coding project."}
    ],
    "stream": true
  }'
```

<a id="response"></a>

## 响应结构

对于 OpenAI 兼容 SSE 响应，解析完整 data: 事件，并拼接存在的 choices[].delta.content。网络分块不一定等于完整事件；收到 [DONE] 或终止错误后结束。流式用量信息可能缺省。

读取流之前先检查 HTTP 状态。已有部分输出后的断连不代表请求未处理，不要静默重新提交。

<a id="errors"></a>

## 错误处理

结合 HTTP 状态与返回的错误信息排查。鉴权或模型权限错误先检查密钥与分组；额度或限流错误检查余额及上游限制；超时时保留已有任务 ID。

- [排查一次请求](/zh/docs/errors/)