发起第一次 API 请求

1. 选择合适的模型分组

登录控制台并打开 API 密钥页面。在已启用且包含 grok-4.5 的分组中创建密钥，例如「渠道2 / Grok Cursor（channel2-grok-cursor）」。密钥绑定的分组决定请求路由与价格。

• 在模型详情页查看当前权限与费率。
• 默认分组中的密钥不会自动路由到专用的渠道1或渠道2分组。
• 请将密钥保存在服务端或本地环境中，不要放入公开的浏览器代码包。

2. 发送一个简单请求

在已安装 curl 的终端中，将 YOUR_API_KEY 替换为你的 ohgrok API 密钥，再运行以下请求。该示例请求一段简短回复，并返回 JSON。

export OHGROK_API_KEY='YOUR_API_KEY'

curl --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": false
  }'

3. 读取结果

聊天补全请求成功后，从 choices[0].message.content 读取回复。如响应包含 usage，请一并检查，并在控制台记录中核对请求。

使用兼容 OpenAI 的 SDK 时，将 base URL 设为 https://api.ohgrok.com/v1，并传入相同密钥与准确的模型 ID。调用你所用 SDK 支持的方法即可，无需专用的 ohgrok SDK。

4. 请求报错时怎么办

排查请求时，请同时保留 HTTP 状态码和返回的错误信息。

• 认证错误：检查网站 API 密钥与 Authorization 请求头。
• 模型或分组错误：检查模型 ID，以及创建密钥时选择的分组。
• 配额或限流错误：检查账户权限，以及响应中报告的上游限制。
• 上游错误：保留请求详情，有针对性地重试，避免无限自动重试。