Claude ネイティブ形式: ストリーミングと非ストリーミングのレスポンス

Claude のネイティブ形式（/v1/messages）を呼び出すと、レスポンスは OpenAI 互換モードとは完全に異なります。返答は型付きの content ブロック配列であり、ストリーミングでは Anthropic の名前付きイベント SSE プロトコルを使用します。このページでは、両方のモードをどのようにパースするかを説明します。

リクエスト側（エンドポイント、anthropic-version ヘッダー、x-api-key 認証、effort / thinking パラメータ）については、Claude API の基本と Claude Effort & Thinking ガイドを参照してください。このページはレスポンス側のみを扱います。例では軽量モデル claude-haiku-4-5-20251001 を使用します。

ノンストリーミングレスポンス

トップレベルは message オブジェクトであり、回答は content 配列内に格納され、type ごとにブロックに分割されます:

{
  "id": "msg_bdrk_xxx",
  "type": "message",
  "role": "assistant",
  "model": "claude-haiku-4-5-20251001",
  "content": [
    { "type": "text", "text": "1+1 equals 2." }
  ],
  "stop_reason": "end_turn",
  "stop_sequence": null,
  "usage": {
    "input_tokens": 26,
    "output_tokens": 11,
    "cache_creation_input_tokens": 0,
    "cache_read_input_tokens": 0
  }
}

回答を取得するには content 配列を反復処理する必要があります — OpenAI のように単一の文字列フィールドを読み取ることはできません:

import requests

resp = requests.post(
    "https://api.apiyi.com/v1/messages",
    headers={
        "content-type": "application/json",
        "anthropic-version": "2023-06-01",
        "x-api-key": "YOUR_API_KEY",
    },
    json={
        "model": "claude-haiku-4-5-20251001",
        "max_tokens": 100,
        "messages": [{"role": "user", "content": "What is 1+1?"}],
    },
    timeout=60,
)
data = resp.json()
for block in data["content"]:
    if block["type"] == "text":
        print(block["text"])
    elif block["type"] == "thinking":      # only present when thinking is on
        print("[thinking]", block["thinking"])
print(data["usage"])

curl https://api.apiyi.com/v1/messages \
  -H "content-type: application/json" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "What is 1+1?"}]
  }'

stop_reason の値: end_turn (通常)、max_tokens (max_tokens により中断 — テキストが空の場合があります。制限を引き上げてください)、stop_sequence、tool_use (ツール呼び出しを要求)、refusal (セーフティポリシーにより拒否。content は空の配列です — Claude の拒否で空の content が返される理由を参照)。thinking を有効にすると、content 配列に type: "thinking" ブロックが追加され、text ブロックの前に配置されます。

ストリーミング応答（named-event SSE）

Claude のストリーミングでは Anthropic のイベントプロトコルを使います。各メッセージには event: 名と data: ペイロードがあり、OpenAI のように各チャンクを同じように扱うのではなく、イベントタイプでディスパッチします。

event: message_start
data: {"type":"message_start","message":{"id":"...","content":[],"usage":{"input_tokens":26,"output_tokens":8}}}

event: content_block_start
data: {"type":"content_block_start","index":0,"content_block":{"type":"text","text":""}}

event: content_block_delta
data: {"type":"content_block_delta","index":0,"delta":{"type":"text_delta","text":"1+1 equals 2."}}

event: content_block_stop
data: {"type":"content_block_stop","index":0}

event: message_delta
data: {"type":"message_delta","delta":{"stop_reason":"end_turn"},"usage":{"output_tokens":11}}

event: message_stop
data: {"type":"message_stop"}

固定のイベント順序と、それぞれが持つ内容は次のとおりです。

イベント	役割
`message_start`	メッセージの骨組み。`usage.input_tokens` と最初の `output_tokens` がここにあります
`content_block_start`	コンテンツブロックが始まります（`index` + ブロックタイプ text / thinking）
`content_block_delta`	増分。テキストは `delta.text` で、`delta.type == "text_delta"` にあります
`content_block_stop`	現在のブロックが終了します
`message_delta`	最終的な `stop_reason` + 累積された `output_tokens` がここにあります
`message_stop`	メッセージ全体が終了します（`[DONE]` はありません; このイベントが終端です）

要点は、text_delta を content_block_delta の中で蓄積することです。

import json, requests

resp = requests.post(
    "https://api.apiyi.com/v1/messages",
    headers={
        "content-type": "application/json",
        "anthropic-version": "2023-06-01",
        "x-api-key": "YOUR_API_KEY",
    },
    json={
        "model": "claude-haiku-4-5-20251001",
        "max_tokens": 100,
        "stream": True,
        "messages": [{"role": "user", "content": "Write a short poem"}],
    },
    stream=True, timeout=120,
)

text, usage = "", {}
for line in resp.iter_lines(decode_unicode=True):
    if not line or not line.startswith("data: "):
        continue                       # the event: line can be skipped; type is in data's "type"
    evt = json.loads(line[6:])
    t = evt["type"]
    if t == "message_start":
        usage.update(evt["message"]["usage"])
    elif t == "content_block_delta" and evt["delta"]["type"] == "text_delta":
        piece = evt["delta"]["text"]
        text += piece
        print(piece, end="", flush=True)
    elif t == "message_delta":
        usage.update(evt["usage"])     # final output_tokens
    elif t == "message_stop":
        break                          # terminator, no [DONE]

イベントタイプは event: 行と data: ペイロードの "type" フィールドの両方にあります。どちらを使ってもディスパッチできます。公式 anthropic SDK では、base_url を https://api.apiyi.com に向ければ SDK がイベントストリームを処理してくれるため、手書きのループは不要です。

thinking（adaptive thinking）を有効にすると、最初に type: "thinking" ブロックが表示されます。増分は thinking_delta で、ブロックが閉じる前に signature_delta（thinking ブロックのシグネチャー）が表示されます。thinking を表示するには、thinking_delta と text_delta を別々にレンダリングします。Claude Effort & Thinking Guide を参照してください。

OpenAI互換モードとの主な違い

項目	Claudeネイティブ (`/v1/messages`)	OpenAI互換モード (`/v1/chat/completions`)
応答の格納先	`content` ブロック配列、型付き	`choices[0].message.content` 文字列
ストリーミングプロトコル	名前付きイベント (`event:` + `data:`)	均一なチャンクオブジェクト
ストリーム終端	`message_stop` イベント、`[DONE]` なし	`data: [DONE]`
増分フィールド	`content_block_delta.delta.text`	`choices[0].delta.content`
usage フィールド	`input_tokens` / `output_tokens` (message_start と message_delta に分割されます)	`prompt_tokens` / `completion_tokens` / `total_tokens`
終了理由	`stop_reason` (`end_turn` など)	`finish_reason` (`stop` など)
`max_tokens`	必須	任意

移行時に特に陥りやすい落とし穴は 2 つあります: (1) 応答は文字列ではなく配列です — content を反復し、type=="text" ブロックごとに処理します; (2) ストリーミングには [DONE] がありません — 終了は message_stop イベントで検出します。

利用と課金

非ストリーミング: usage は結果とともに返ってきて、input_tokens、output_tokens、cache_creation_input_tokens、cache_read_input_tokens が含まれます。
ストリーミング: input_tokens は message_start にあり、最終的な output_tokens は message_delta にあります — 両方をマージしてください。
キャッシュヒットフィールド（cache_read_input_tokens）の割引と使用量については、Claude Cache Billing を参照してください。

基本

基本API

画像API（公式）

動画API（公式）

マルチモーダル理解API

テキスト生成

音声API（公式）

検索と安全性

Claude ネイティブ形式: ストリーミングと非ストリーミングのレスポンス

ノンストリーミングレスポンス

ストリーミング応答（named-event SSE）

OpenAI互換モードとの主な違い

利用と課金

関連リンク

​ノンストリーミングレスポンス

​ストリーミング応答（named-event SSE）

​OpenAI互換モードとの主な違い

​利用と課金

​関連リンク

ノンストリーミングレスポンス

ストリーミング応答（named-event SSE）

OpenAI互換モードとの主な違い

利用と課金

関連リンク