Grok API 与 SDK

如果你在开发自己的应用，可以直接用 OpenAI SDK 调用本站 Grok。准备 Passion8 Key 和控制台开放的模型即可。本文从最小 Chat Completions 请求开始，再区分 Responses 与官方托管工具。

#配置地址、Key 与模型

macOS / Linux：

export PASSION8_API_KEY="replace-with-your-Passion8-key"
export PASSION8_GROK_MODEL="grok-4.7"

Windows PowerShell：

$env:PASSION8_API_KEY="replace-with-your-Passion8-key"
$env:PASSION8_GROK_MODEL="grok-4.7"

如果控制台提供其他型号，将变量替换为实际 ID。下列代码从环境读取 Key，不读取 Grok Build 或 Codex 配置。

#第一次请求：Chat Completions

在项目虚拟环境中安装：

python -m pip install --upgrade openai

保存为 grok_smoke.py：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["PASSION8_API_KEY"],
    base_url="https://passion8.cc/v1",
)
response = client.chat.completions.create(
    model=os.environ["PASSION8_GROK_MODEL"],
    messages=[{"role": "user", "content": "Reply only OK."}],
)
print(response.choices[0].message.content)

运行 python grok_smoke.py 后，到 控制台 核对模型与请求时间。不要通过问“你是什么模型”判断路由。

#流式输出

在上述初始化代码后改为：

stream = client.chat.completions.create(
    model=os.environ["PASSION8_GROK_MODEL"],
    messages=[{"role": "user", "content": "Explain the purpose of unit tests."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="", flush=True)
print()

流式返回的是增量片段，应用应持续读取，不要按普通 JSON 一次解析整个响应。费用仍然核对控制台记录。

#Responses：按客户端需求选择

xAI 官方目前推荐 Responses 用于新集成，并将 Chat Completions 标记为 legacy。兼容现有编程插件时，仍要按客户端实际请求协议配置。

如果你的账号渠道支持本站 Grok Responses，可把请求部分替换为：

response = client.responses.create(
    model=os.environ["PASSION8_GROK_MODEL"],
    input="Reply only OK.",
)
print(response.output_text)

Responses 使用 input 和 output_text；Chat Completions 使用 messages 和 choices。不要只换接口名字却沿用另一种响应解析。官方 previous_response_id、后台运行等能力需确认本站是否支持，不能从一个文本响应推断。

#推理、工具调用与窗口

Grok 4.7 官方上下文是 500,000 tokens，支持 low、medium、high、xhigh，默认 high。具体如何传推理参数取决于协议，建议最小请求成功后再按该协议文档添加，不要传旧的 none。

函数调用让模型返回工具请求，由你的应用执行并回传结果；官方 Web Search、X Search、Code Execution 则是托管工具。本站渠道未确认开放时，不要直接复制包含这些托管工具的完整官方示例。上下文窗口也不是最大输出 token 数。

#故障定位

编辑器接入见 VS Code 使用 Grok，官方客户端见 Grok Build。

#API 接入问答

#Cline 和 Codex 调用 Grok 时用的是同一个接口吗？

Base URL 都可以是 https://passion8.cc/v1，但 Cline 的 OpenAI Compatible 使用 Chat Completions，本文的 Codex 配置使用 Responses。地址相同不代表请求体相同，也不证明账号渠道同时开放两种协议。编辑器步骤分别见 Cline 多模型配置 和 Grok 的 Codex 配置。

#Grok API 能回答问题，就说明可以搜索 X 或网页吗？

不能。普通文本生成、函数调用和 xAI 托管的 X Search / Web Search 是不同能力。只有当前渠道明确支持对应托管工具时才能使用；不要把文本回答或 Cline 本地工具执行成功当成搜索功能已开放。

#核对来源

核对日期：2026-10-11。

• Grok 官方文本生成
• Chat Completions legacy
• Grok 4.7 能力与推理档位

本站模型与渠道支持以控制台和实际错误响应为准。