> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# Grok API

> 1 つの BeatAPI キーで、OpenAI、Anthropic、Gemini 互換 SDK から Grok 4.7、4.6、4.5 を利用できます。

# Grok API

Grok モデル 3 種を、他の Text API と同じパススルーで利用できます。4 つすべてのリクエスト形式に対応しています。

| モデル        | 適した用途                                 |
| ---------- | ------------------------------------- |
| `grok-4.7` | 推論、ツール使用、長時間のコーディング作業で第一候補となる現在の主力モデル |
| `grok-4.6` | 現在の主力と同じ料金の前世代モデル。既に調整済みの処理パイプライン向け   |
| `grok-4.5` | 既存の連携向けに提供を継続している旧世代モデル               |

3 種すべてがデフォルトで推論を行います。推論に使用したトークン数は `usage.completion_tokens_details.reasoning_tokens` に報告され、`completion_tokens` に含まれ、出力として課金されます。

## OpenAI Chat Completions

`POST https://api.beatapi.io/v1/chat/completions`

```typescript
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.BEATAPI_API_KEY,
  baseURL: "https://api.beatapi.io/v1"
});

const completion = await client.chat.completions.create({
  model: "grok-4.7",
  max_tokens: 2000,
  messages: [
    { role: "user", content: "Design a resilient webhook retry strategy for a payments API." }
  ]
});

console.log(completion.choices[0].message.content);
```

```bash
curl --request POST \
  --url https://api.beatapi.io/v1/chat/completions \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "grok-4.7",
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'
```

## 長いコンテキストの料金

Grok はプロンプトが **200,000 トークン**に達すると上位の料金に切り替わり、そのリクエスト内のすべてのトークンに適用されます。入力、キャッシュ入力、出力がすべて 2 倍になります。しきい値未満では、リクエスト全体に通常料金が適用されます。

> **Note**
>
> このしきい値は 200K であり、GPT-5.6 シリーズの 272K ではありません。誤ったしきい値を基準にプロンプトの長さを調整すると、想定の 2 倍の料金がかかります。

## その他の SDK 形式

### OpenAI Responses

`POST https://api.beatapi.io/v1/responses`

```bash
curl --request POST \
  --url https://api.beatapi.io/v1/responses \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "grok-4.7",
  "input": "Design a resilient webhook retry strategy for a payments API.",
  "reasoning": {
    "effort": "medium"
  }
}'
```

### Anthropic Messages

`POST https://api.beatapi.io/v1/messages`

```bash
curl --request POST \
  --url https://api.beatapi.io/v1/messages \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "grok-4.7",
  "max_tokens": 1024,
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'
```

### Gemini 互換のコンテンツ形式

`POST https://api.beatapi.io/v1beta/models/{model}:generateContent`

```bash
curl --request POST \
  --url 'https://api.beatapi.io/v1beta/models/grok-4.7:generateContent' \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "contents": [
    {
      "role": "user",
      "parts": [
        {
          "text": "Design a resilient webhook retry strategy for a payments API."
        }
      ]
    }
  ]
}'
```

## 認証と利用可能なモデル

本番導入前に、現在有効なテキストモデルの一覧を確認してください。

```bash
curl https://api.beatapi.io/v1/models \
  -H "Authorization: Bearer $BEATAPI_API_KEY"
```

```json
{
  "object": "list",
  "data": [
    { "id": "grok-4.7", "object": "model", "owned_by": "beatapi" }
  ]
}
```

Text、Image、Video、Workflow、Effect、Realtime API は、同じ API キーと USD 残高を共有します。呼び出しは実際のトークン使用量に基づいて課金されます。ダッシュボードの利用状況ログで、リクエスト ID、モデル、トークン総数、ステータス、精算額を確認できます。

## 本番運用前のチェックリスト

* 回答だけでなく、推論にも使われるトークンを出力予算に含めてください。
* プロンプトの 200K のしきい値に注意してください。超えると、リクエスト全体の料金が 2 倍になります。
* API キーは信頼できるサーバーに保存し、ログには記録しないでください。
* サポートへの問い合わせや課金の確認に備え、レスポンスのリクエスト ID を記録してください。
* `401`、`402`、`403`、`404`、`429`、`503` はそれぞれ区別して処理し、再試行は `429`、`500`、`503` の場合にのみ行ってください。[エラー](/errors#text-endpoints)を参照してください。

## 画像・動画モデルの利用

同じ BeatAPI アカウントで [GPT-5.6](/text-api/gpt-5-6)、[Claude](/text-api/claude)、[Gemini](/text-api/gemini) のほか、Image API・Video API を利用できます。別の課金・認証システムを追加する必要はありません。