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

# Claude Fable 5.1 API

> 1 つの BeatAPI キーで、OpenAI、Anthropic、Gemini 互換 SDK から Claude Fable 5.1 を利用できます。

BeatAPI が公開している Claude モデルには、Claude Fable 5.1、Claude Opus 5.5、Claude Sonnet 5.5、Claude Haiku 5.5 があります。このページでは Claude Fable 5.1 を説明します。他のテキストモデルと同じ Text API のパススルーを使用し、対応するすべての SDK 形式でモデル ID `claude-fable-5-1` を指定します。Claude Haiku 5.5 のモデル ID、上限、料金は、このページの後半で説明しています。

| モデル                | 適した用途                               |         コンテキスト |
| ------------------ | ----------------------------------- | -------------: |
| `claude-fable-5-1` | 文体と構成を重視する長文執筆や文章作成                 | 1,000,000 トークン |
| `claude-haiku-5-5` | 分類、抽出、振り分けなど、大量の処理に適した小型・高速な Claude | 1,000,000 トークン |

> **Tip**
>
> 本番導入前に `GET /v1/models` を呼び出し、最新のモデル ID とアカウントでの利用可否を確認してください。

## 推奨：Anthropic Messages

新しい Claude 連携には、ネイティブの Messages 形式を使用してください。Claude 固有のツール使用とプロンプトキャッシュのフィールドを変換せずに扱えるのは、この形式だけです。

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

```typescript
import Anthropic from "@anthropic-ai/sdk";

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

const message = await client.messages.create({
  model: "claude-fable-5-1",
  max_tokens: 1024,
  messages: [
    { role: "user", content: "Design a resilient webhook retry strategy for a payments API." }
  ]
});

console.log(message.content);
```

BeatAPI キーは `x-api-key` または `Authorization: Bearer` で送信できます。どちらも受け付けるため、既存の Anthropic クライアントではベース URL の変更だけで対応できます。

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

## プロンプトキャッシュ

Claude では、キャッシュ読み取り、5 分間のキャッシュ書き込み、1 時間のキャッシュ書き込みにそれぞれ異なる料金が適用され、BeatAPI も個別に計測します。キャッシュされたプレフィックスは、新規入力ではなくキャッシュ読み取りとして課金されます。`cache_control` は Anthropic を直接利用するときと同じように設定してください。

> **Note**
>
> `claude-fable-5-1` のキャッシュヒットは、通常の入力料金の 0.025 倍で課金されます。キャッシュの書き込みと読み取りは個別に計測されます。

## Claude Haiku 5.5

`claude-haiku-5-5` は、小型で高速な Claude モデルです。1,000,000 トークンのコンテキストウィンドウと最大 128,000 トークンの出力に対応します。このページの Anthropic Messages または OpenAI Chat Completions のリクエスト例で、モデル ID に `claude-haiku-5-5` を指定してください。これらの形式に対応するクライアントや SDK で利用できます。

プロンプトの長さに応じて、2 段階の料金が適用されます。料金は **100 万トークン**あたりの USD 表示です。2026 年 10 月 9 日に確認しました。

| トークンの種類         | プロンプトが 100,000 トークン以下 | プロンプトが 100,000 トークン超 |
| --------------- | --------------------: | -------------------: |
| 入力              |                \$0.05 |               \$0.25 |
| 出力              |                \$0.25 |               \$1.25 |
| キャッシュ入力         |               \$0.005 |              \$0.025 |
| キャッシュ書き込み（5 分）  |              \$0.0625 |             \$0.3125 |
| キャッシュ書き込み（1 時間） |                \$0.10 |               \$0.50 |

プロンプトが 100,000 トークンを超えると、しきい値を超えた部分だけでなく、リクエスト全体に右列の料金が適用されます。処理の予算を立てる前に、[最新の料金表](https://beatapi.io/pricing)を確認してください。

## 既存の SDK 形式

同じ `claude-fable-5-1` モデルを、他の 3 つのリクエスト形式でも利用できます。既存の実装は、ベース 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": "claude-fable-5-1",
  "messages": [
    {
      "role": "user",
      "content": "Design a resilient webhook retry strategy for a payments API."
    }
  ]
}'
```

### 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": "claude-fable-5-1",
  "input": "Design a resilient webhook retry strategy for a payments API.",
  "reasoning": {
    "effort": "medium"
  }
}'
```

### 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/claude-fable-5-1: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": "claude-fable-5-1", "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-5.6](/text-api/gpt-5-6)、[GPT Image 2](/image-api/gpt-image-2)、[Wan 3.0](/video-api/wan-3-0) をはじめ、その他の Image API・Video API を利用できます。別の課金・認証システムを追加する必要はありません。