はじめに
Claude Sonnet 4.6 は、Anthropic のチャットモデルのなかで日々の主力を担うモデルです。ここでは /v1/chat/completions の OpenAI 互換エンドポイント 1 本として提供しています。1 回の呼び出しで最大 1,000,000 トークンを読み、最大 64,000 トークンで返答するので、数百ターン分のロールプレイを要約せずそのまま引き継げます。
推論の強さは low・medium・high・max(既定は medium)で、temperature(0〜1)と top_p も調整できます。メッセージの内容はテキストと画像で、同じリクエストで最大 128 個のツールと SSE ストリーミングを使えます。
主な機能とハイライト
数百ターンをそのまま引き継ぐ
1,000,000 トークンには数百ターン分の元のやり取りが収まります。要約をやめれば、300 ターン目のキャラクターも 10 ターン目に受け入れたことを覚えています。圧縮を始めると、真っ先に抜け落ちるのは、まさにキャラクターの一貫性を支えていた細部です。
読む量は書く量の 16 倍
枠は返答の上限 64,000 トークンの 16 倍で、この形は会話に向いています。毎ターン多くの履歴を読み、1 場面や 1 章を書いて返す形です。1 つの成果物が 64,000 トークンを超えそうなら、章ごとに分けてください。
推論とサンプリングを同じ本文で
low・medium・high・max は、temperature や top_p と同じリクエスト本文に並びます。普段のターンは low に温かめの temperature で回し、伏線をまとめるターンだけ high か max で送ります。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
messages | はい | 順序付きの会話ターンで、内容は文字列、または text と |
max_tokens | いいえ | 返答を 64,000 で抑えます。読み込み枠の 16 分の 1 です。 |
reasoning_effort | いいえ | low / medium / high / max、既定は medium です。モデルが書き出す前に細部を突き合わせる必要があるときは上げてください。 |
stop | いいえ | 最大 4 件の停止シーケンスを、文字列か配列で指定します。モデルがそのいずれかを書いた時点で応答が終わり、一致した文字列そのものは返されません。 1 文字以上 · 1 件以上 · 4 件以内 |
temperature | いいえ | 0〜1、既定 1。返答をコードが解析する場合は 0 に保ってください。 |
top_k | いいえ | 1〜500 です。次に来る確率の高い上位 k 個のトークンだけから選びます。 |
top_p | いいえ | 0.01〜1。同じ比較の中で、これと temperature を同時に動かさないでください。 |
tools | いいえ | 1 リクエストにつき最大 128 個の関数定義。 128 件以内 |
parallel_tool_calls | いいえ | true か false で、既定値は true です。true ではモデルが 1 ターンで複数のツール呼び出しを要求できます。 デフォルト値: |
tool_choice | いいえ | auto / none / required、または呼ぶ関数を名指しするオブジェクト。 |
料金
入力 $3 / 出力 $15 100 万トークンあたり
ユースケース
数百ターン続くロールプレイ
履歴を手を加えずに毎ターン送り返します。キャラクターの約束、根に持っていること、お決まりの冗談がリクエストに残るので、一貫性はプロンプトの覚え書きではなく素材そのものから生まれます。
ツールを使うインタラクティブフィクション
ダイスロール、所持品の確認、設定資料の検索は関数として組み込めます。定義は最大 128 個で、tool_choice で制御します。結果は同じ会話の中に tool メッセージとして戻るため、判定のために場面を離れる必要がありません。
連載の続きを書く
これまでの物語をリクエストに入れ、次の章を依頼します。64,000 トークンの上限で 1 場面を書き切れますし、前提はまだ枠の中にあるので、連載のたびに前提を説明し直す必要はありません。
プロンプトガイドと実践のヒント
登場人物は system メッセージで固定する
各キャラクターの話し方、関係、越えない一線は system メッセージに置き、user のターンには筋だけを載せます。そうすれば物語が分岐しても、変わるのはリクエストの後半だけです。
max_tokens に推論の余地を残す
既定値は 4,096 トークンです。推論トークンも出力として課金されるため、high や max では、見えている返答より余裕のある max_tokens を最大 64,000 の範囲で設定してください。
エンドポイントが受け付けないもの
64,000 を超える max_tokens、動画・音声パート、返答を先に埋めるための assistant メッセージで終わる会話は、いずれもエラーになります。response_format はないので、機械で読む出力が必要なら JSON スキーマをパラメーターにしたツールを強制してください。ツールの結果もほかのメッセージと同じく枠を消費するため、非常に長いセッションではいずれ何を削るかを決める必要があります。
API クイックスタート
curl --fail-with-body -sN https://api.spicyapi.ai/v1/chat/completions \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"model": "anthropic/claude-sonnet-4.6/chat",
"messages": [
{
"role": "user",
"content": "Summarise the following release notes into three bullet points."
}
],
"stream": true
}' \
| jq --unbuffered -Rrj 'select(startswith("data: ")) | .[6:] | select(. != "[DONE]") | fromjson | if .error then "\n[error] \(.error.message)\n" else (.choices[0].delta.content? // empty) end'
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。














