Grok Chat Completions

通过 DouDi.ai 的 Grok / xAI API 协议族调用 Grok 模型。这个 Grok / xAI 路由只会调度 Grok-family 模型和上游；文本请求与响应正文采用 xAI 的 OpenAI-compatible Chat Completions JSON / SSE 格式。

该协议描述 Grok / xAI 的路由和调度边界，并不表示它是 OpenAI 上游的别名。请使用 DouDi.ai API Key，而不是 xAI OAuth 凭据，并配置下面的 Grok 入口。

Base URL 与端点

协议根地址：

https://doudi.ai/grok

使用官方 OpenAI SDK 时，请配置以下 SDK Base URL：

https://doudi.ai/grok/v1

Chat Completions 端点：

POST https://doudi.ai/grok/v1/chat/completions

认证

通过 Bearer Token 传递 DouDi.ai API Key：

Authorization: Bearer <你的 DOUDI_API_KEY>

当前可用模型

请使用带 grok/ 前缀的 canonical model ID。

模型 ID	当前用途
grok/grok-4.5	默认前沿通用模型，适合通用任务、编程和 Agent 工作流；上下文窗口为 500,000 token。
grok/grok-composer-2.5-fast	面向 Grok Build 工作流的纯文本编程模型；上下文窗口为 200,000 token，不接受图像输入。

请求示例

cURL

Terminal

curl https://doudi.ai/grok/v1/chat/completions \
  -H "Authorization: Bearer $DOUDI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok/grok-4.5",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "解释 API 网关如何工作。"}
    ]
  }'

Python

grok_chat.py

from openai import OpenAI

client = OpenAI(
    base_url="https://doudi.ai/grok/v1",
    api_key="<你的 DOUDI_API_KEY>",
)

response = client.chat.completions.create(
    model="grok/grok-4.5",
    messages=[
        {"role": "system", "content": "你是一个有帮助的助手。"},
        {"role": "user", "content": "解释 API 网关如何工作。"},
    ],
)

print(response.choices[0].message.content)

TypeScript

grok-chat.ts

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://doudi.ai/grok/v1',
  apiKey: '<你的 DOUDI_API_KEY>'
})

const response = await client.chat.completions.create({
  model: 'grok/grok-4.5',
  messages: [
    { role: 'system', content: '你是一个有帮助的助手。' },
    { role: 'user', content: '解释 API 网关如何工作。' }
  ]
})

console.log(response.choices[0].message.content)

流式响应

设置 stream: true 后，服务会以 xAI-compatible Chat Completions SSE 格式持续返回内容：

grok_stream.py

stream = client.chat.completions.create(
    model="grok/grok-4.5",
    messages=[{"role": "user", "content": "写一段简短的欢迎语。"}],
    stream=True,
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

需要使用 xAI-compatible Responses 格式时，请参考 Grok Responses API。

本页按 DouDi.ai 接入语境整理，覆盖同类教程的结构和步骤。 实际模型、分组、价格和权限以 DouDi 控制台为准。