ツールの使用 (関数の呼び出し)
ツール使用の価格とトークン
ツール使用リクエストの価格は、他の Claude API リクエストと同様に、モデルに送信される入力トークンの総数(tools
パラメーターを含む)と生成される出力トークンの数に基づいて設定されます。
ツール使用による追加のトークンは以下から発生します:
- API リクエストの
tools
パラメーター(ツール名、説明、スキーマ) - API リクエストとレスポンスの
tool_use
コンテンツブロック - API リクエストの
tool_result
コンテンツブロック
tools
を使用する際、モデルがツール使用を可能にする特別なシステムプロンプトを自動的に含めます。各モデルに必要なツール使用トークンの数を以下に示します(上記の追加トークンは除く):
Model | Tool choice | ツール使用システムプロンプトのトークン数 |
---|---|---|
Claude 3 Opus | auto | 530 トークン |
Claude 3 Opus | any , tool | 281 トークン |
Claude 3 Sonnet | auto | 159 トークン |
Claude 3 Sonnet | any , tool | 235 トークン |
Claude 3 Haiku | auto | 264 トークン |
Claude 3 Haiku | any , tool | 340 トークン |
Claude 3 Opus (legacy beta: tools-2024-04-04 ) | auto | 395 トークン |
これらのトークン数は、通常の入力および出力トークンに追加され、リクエストの合計コストを計算します。現在のモデルごとの価格については、モデル概要表を参照してください。
ツール使用プロンプトを送信する際、他の API リクエストと同様に、レスポンスには報告された usage
メトリクスの一部として入力および出力トークン数の両方が出力されます。
ツール使用では、多くの場合、コードと Claude の間で複数の往復が必要になることに注意してください(ツールを実行し、結果を返すため)。そのため、1つのエンドユーザークエリが複数の API リクエストとそれに関連するトークンコストを発生させる可能性があります。Claude がツールを効果的に使用するのに十分な情報を提供しつつ、ツールとプロンプトをできるだけ簡潔に設計してください。