> 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.

# GPT-5.6 API

> 1 つの BeatAPI キーで、OpenAI、Anthropic、Gemini 互換 SDK から GPT-5.6 の Sol、Terra、Luna を利用できます。

# GPT-5.6 API

GPT-5.6 は本番向けの 3 つのグレードで提供されています。すべてテキスト・画像入力、テキスト出力、ストリーミング、関数呼び出し、構造化出力、推論の強度の設定に対応しています。

| モデル             | 適した用途                               |         コンテキスト |         最大出力 |
| --------------- | ----------------------------------- | -------------: | -----------: |
| `gpt-5.6-sol`   | 複雑な専門業務、高度な推論、品質を重視するコーディング         | 1,050,000 トークン | 128,000 トークン |
| `gpt-5.6-terra` | モデルの能力、レイテンシー、コストのバランスを重視するプロダクトの処理 | 1,050,000 トークン | 128,000 トークン |
| `gpt-5.6-luna`  | 大量の抽出、分類、振り分け、軽量なエージェント             | 1,050,000 トークン | 128,000 トークン |

> **Tip**
>
> 多くの本番処理では、まず `gpt-5.6-terra` から始めてください。代表的な評価で明確な品質向上が見られる場合は Sol を、処理量とコストを重視する場合は Luna を選びます。

## 推奨：Responses API

新しい推論・ツール呼び出しの実装には Responses API を使用してください。

```typescript
import OpenAI from "openai";

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

const response = await client.responses.create({
  model: "gpt-5.6-terra",
  input: "Design a resilient webhook retry strategy for a payments API.",
  reasoning: { effort: "medium" }
});

console.log(response.output_text);
```

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

推論の強度には `none`、`low`、`medium`、`high`、`xhigh`、`max` を指定できます。まずはバランスのよい `medium` から始め、実際の処理で 1 段階低い設定と高い設定を比較してください。

## 既存の SDK 形式

既存の実装は、ベース URL を変更し、プロバイダーのキーを BeatAPI キーに置き換えることで移行できます。

### OpenAI Chat Completions

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

```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": "gpt-5.6-terra",
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'
```

### Anthropic Messages

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

BeatAPI キーは `x-api-key` または `Authorization: Bearer` で送信してください。

```bash
curl --request POST \
  --url https://api.beatapi.io/v1/messages \
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-5.6-terra",
  "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`

BeatAPI キーは `x-goog-api-key`、Bearer 認証、または Gemini SDK 互換の `key` クエリパラメーターで送信できます。HTTP を直接呼び出す実装では、ヘッダーの使用を推奨します。

```bash
curl --request POST \
  --url 'https://api.beatapi.io/v1beta/models/gpt-5.6-terra: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."
        }
      ]
    }
  ]
}'
```

## ストリーミング

選択した形式に応じてストリーミング用のフィールドを設定してください。BeatAPI は Server-Sent Events のストリームを変換せずに転送するため、イベント名とレスポンスオブジェクトはその SDK 形式との互換性を保ちます。

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

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

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

```json
{
  "object": "list",
  "data": [
    { "id": "gpt-5.6-terra", "object": "model", "owned_by": "beatapi" }
  ]
}
```

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

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

* API キーは信頼できるサーバーに保存し、ログには記録しないでください。
* リクエストのタイムアウトを明示的に設定し、ストリーミングレスポンスの再接続を安全に処理してください。
* サポートへの問い合わせや課金の確認に備え、レスポンスのリクエスト ID を記録してください。
* 実際の運用を代表する入力で、モデルのグレードと推論の強度を評価してください。
* `401`、`402`、`403`、`404`、`429`、`503` はそれぞれ区別して処理し、再試行は `429`、`500`、`503` の場合にのみ行ってください。[エラー](/errors#text-endpoints)を参照してください。

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

同じ BeatAPI アカウントで [GPT Image 2](/image-api/gpt-image-2)、[MiniMax H3](/video-api/minimax-h3)、[Seedance 2.5](/video-api/seedance-2-5) をはじめ、その他の Image API・Video API を利用できます。別の課金・認証システムを追加する必要はありません。