Claude API の output-300k ベータ機能で超長文コンテンツを生成する — 設定から実装まで

Claude API に、1回のリクエストで最大 30万トークン（約22万ワード） の出力を生成できるベータ機能が追加されました。対象は Claude Opus 4.6 および Claude Sonnet 4.6 で、output-300k-2026-03-24 というベータヘッダーを付与することで利用できます。

「長大なレポートをまとめて生成したい」「大規模なコードファイルを一括出力したい」「詳細なドキュメントを分割せず一気に書きたい」——そんなニーズに応える機能です。ここでは設定方法から実装コード例まで丁寧に解説します。

output-300k ベータ機能とは

従来の Claude API では、1回のリクエストで出力できるトークン数の上限は 128,000トークン でした（Claude Sonnet 4.6 の場合）。 2026年4月、Anthropic はこの上限を 30万トークン に引き上げるベータ機能をリリースしました。

通常の Messages API（非バッチ）のシングルターンリクエストで、この拡張上限が利用できます。

なお、バッチ処理（Messages Batches API）での 30万トークン対応については Claude Message Batches API 30万トークン出力対応ガイドに詳しく解説しています。

バッチ API との違い

通常の Messages API + output-300k ヘッダー: リアルタイムでストリーミングしながら超長文を生成する用途向け。単発の大きなコンテンツ生成に適しています
Messages Batches API: 非同期・大量処理向け。コストを50%削減しながらまとめて処理するシナリオに適しています

対応モデルと前提条件

output-300k-2026-03-24 ベータ機能は、以下のモデルでのみ利用できます。

claude-opus-4-6-20260401
claude-sonnet-4-6-20250514

Claude Haiku 4.5 など他のモデルでは利用できません。また、本機能はまだ ベータ段階 であるため、将来的に仕様が変更される可能性があります。

APIの料金と利用上限については Claude API 料金ガイド 2026 も参照してください。

ベータヘッダーの設定方法

anthropic-beta ヘッダーに output-300k-2026-03-24 を指定するだけです。

Python SDK での設定（推奨）

import anthropic
 
client = anthropic.Anthropic(api_key="YOUR_API_KEY")
 
message = client.messages.create(
    model="claude-sonnet-4-6-20250514",
    max_tokens=300000,  # 最大 300,000 に設定
    messages=[
        {
            "role": "user",
            "content": "以下のテーマで詳細な技術ドキュメントを作成してください:\n\nテーマ: Python非同期処理の完全リファレンス\n要件: asyncio、aiohttp、Trio、並行性パターン、テスト戦略まで網羅する"
        }
    ],
    betas=["output-300k-2026-03-24"]  # ベータヘッダーを指定
)
 
print(message.content[0].text)
print(f"出力トークン数: {message.usage.output_tokens}")

ポイント: betas パラメータにベータ識別子のリストを渡します。max_tokens を 300,000 まで設定できます。

TypeScript / Node.js での設定

import Anthropic from "@anthropic-ai/sdk";
 
const client = new Anthropic({ apiKey: process.env.ANTHROPIC_API_KEY });
 
async function generateLongContent(prompt: string): Promise<string> {
  const message = await client.beta.messages.create({
    model: "claude-sonnet-4-6-20250514",
    max_tokens: 300000,
    messages: [
      {
        role: "user",
        content: prompt
      }
    ],
    betas: ["output-300k-2026-03-24"]
  });
 
  const textContent = message.content.find((c) => c.type === "text");
  return textContent?.text ?? "";
}
 
// 使用例
const content = await generateLongContent(
  "Next.js 17 のアーキテクチャ設計ガイドを詳細に作成してください"
);
console.log(`生成文字数: ${content.length}`);

ストリーミングとの組み合わせ

30万トークンの出力は時間がかかるため、ストリーミングを併用することをお勧めします。これにより、ユーザーは生成中のコンテンツをリアルタイムで確認できます。

import anthropic
 
client = anthropic.Anthropic(api_key="YOUR_API_KEY")
 
# ストリーミング + output-300k ベータ
with client.beta.messages.stream(
    model="claude-sonnet-4-6-20250514",
    max_tokens=200000,
    messages=[
        {
            "role": "user",
            "content": "Pythonで書かれたECサイトのバックエンドAPIの完全なソースコードを生成してください。FastAPI + PostgreSQL + JWT認証を使い、商品・カート・注文・ユーザー管理の全エンドポイントを含めること。"
        }
    ],
    betas=["output-300k-2026-03-24"]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)
 
final_message = stream.get_final_message()
print(f"\n\n出力トークン数: {final_message.usage.output_tokens}")
# 期待する出力例: 出力トークン数: 148523

主なユースケース

1. 大規模コードベースの一括生成

モジュール構成を持つアプリケーション全体、もしくは複数ファイルにわたるコードを1回のリクエストで生成できます。プロジェクト初期の「ボイラープレート作成」にかかる時間を大幅に削減できます。

2. 長大な技術ドキュメントの作成

APIリファレンスや設計書など、数万字に及ぶドキュメントを分割せず一気に生成できます。分割生成によって生じる「繋ぎ目の不整合」を防げるのも大きなメリットです。

3. 詳細なレポート・分析結果の出力

ビジネスデータの分析レポートや、研究論文の初稿生成など、内容の密度と量の両立が求められるシナリオに有効です。

4. 大量のテストコード生成

100件以上のテストケースを一括生成する際、従来は複数回に分けていたリクエストを1回に集約できます。

コスト計算の考え方

30万トークンの出力を生成する場合のコストの目安（Claude Sonnet 4.6 使用時）を考えてみましょう。

Claude Sonnet 4.6 の出力トークン単価: $3 / 100万トークン
30万トークン出力時の出力トークンコスト: 約 $0.90

入力トークンのコストは別途かかりますが、例えば 1,000トークンの入力なら $0.003 と微小です。大量の長文コンテンツを生成する際は、Claude API コスト最適化ガイドを参照しながらコスト管理を行うことをお勧めします。

また、不要に大きな max_tokens を設定するとコストが増加しますので、実際のユースケースに合わせて適切な値を設定してください。

全体を振り返って

Claude API の output-300k-2026-03-24 ベータ機能を使えば、従来の128Kトークン制限を超えた超長文コンテンツを1回のリクエストで生成できます。

設定方法: betas=["output-300k-2026-03-24"] と max_tokens=300000 を指定するだけ
対応モデル: Claude Opus 4.6 および Claude Sonnet 4.6 のみ
主な用途: 大規模コード生成、長大ドキュメント、詳細レポートなど
コスト: 通常のトークン単価で計算（追加課金なし）

ストリーミングと組み合わせることで、ユーザー体験を損なわずに超長文コンテンツを提供できます。ぜひこのベータ機能を実プロジェクトに取り入れ、コンテンツ生成の効率化にお役立てください。