# 发起第一次 API 请求

设置 base URL，添加 API 密钥，然后发送文本请求。

<a id="overview"></a>

## 请求前

先发一个简单的文本请求。通过同一账户和熟悉的 HTTP 接口，将应用接入所选分组中已开放的模型。

需要已有 ohgrok 账户及所选模型分组的访问权限。新用户注册与在线充值暂未开放。

<a id="choose-access"></a>

## 1. 选择合适的模型分组

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

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

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

## 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
  }'
```

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

## 3. 读取结果

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

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

模型出现在目录中不代表上游始终有可用容量。每次请求仍受限额、可用分组与账户余额限制。

<a id="troubleshooting"></a>

## 4. 请求报错时怎么办

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

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