AGTCloud API Docs
ガイドAPIリファレンス連携とリソース更新とヘルプ
ベンダー別パラメーターの違い

Claude のパラメーターとプロトコルの違い

互換プロトコルにおける Claude のパラメーターの違いと使い方を確認します。

Claude のネイティブは Messages です。Chat Completions では下記 Anthropic 公式互換層の制限を参照してください。プラットフォームの変換は選択した入口に従います。

対象モデル

モデル思考の既定値と切替
claude-haiku-5-5既定で有効、深度 medium。low/medium/high の場合だけ disabled で無効化可能
claude-sonnet-5-5既定で有効、深度 high。disabled は不可。low/medium/high では between_tools で回答前の思考を無効化可能
claude-opus-5-5既定で有効、深度 medium。無効化不可
claude-fable-5-1既定で有効、深度 high。無効化不可
claude-opus-5既定で有効、深度 high。low/medium/high の場合だけ disabled で無効化可能
claude-sonnet-5既定で有効、深度 high。disabled で無効化可能
claude-fable-5既定で有効、深度 high。無効化不可
claude-opus-4-8既定で無効、深度 high。adaptive で有効化

Messages の差分

フィールド差分の説明
thinking.type八モデルは adaptive に対応し、旧 enabled と budget_tokens は拒否。切替可否は上表を参照し、disabled を全モデルに適用しない
between_toolsSonnet 5.5 のみ。回答前の思考を無効化し、ツール間進捗は thinking に返す。オブジェクトは type のみで、display と budget_tokens は不可
output_config.effort八モデルは low/medium/high/xhigh/max に対応し既定値は上表。adaptive は思考型で深度ではない。max_tokens は思考と最終回答の合計を制限
thinking.display思考有効時、八モデルは既定で omitted。空の思考と signature を返す。読める要約は summarized を指定。空でも思考していないとは限らない
tool_choiceOpus 5.5、Sonnet 5.5、Fable 5.1 は any と tool 指定を拒否し、auto/none を使用。他五モデルは強制可能だがその呼び出しの思考を省略。Fable 5 は Fable 5.1 の制限対象外
思考履歴と署名ツール呼び出し後、空テキストも含め前の thinking/redacted_thinking とツールブロックを完全再送。署名を編集・並べ替え・再生成しない。Haiku 5.5、Sonnet 5.5、Opus 5.5、Fable 5.1 は元の system、ツール、過去履歴も照合するため、変更後に元の思考を直接再利用しない
assistant プリフィル八モデルとも末尾の未完了 assistant に 400 を返す。出力制御は指示か output_config.format を使用
temperature/top_p/top_k例では省略。2023-06-01 でも新モデルのサンプリング制限は適用。2026-10-21 はどのモデルでもいずれかの指定に 400。バージョン変更でも自由な調整は戻らない
Computer ツールの版Claude API では Haiku 5.5、Sonnet 5.5、Opus 5.5 は computer_toolset_20260801 を使用。旧型は使用不可。他クラウドの版は公式資料を参照

公式 Chat 互換層の差分

以下は Anthropic の OpenAI SDK 互換層の規則です。ネイティブ Messages と区別するための説明で、全チャネルが同じ変換を採用するとは限りません。

フィールド差分の説明
n1 のみ受け付ける
reasoning_effort無視。深度制御や思考取得は Messages の output_config.effort を使用
response_format、tools[].function.strict無視。ネイティブの構造化出力や厳密ツール検証は有効にならない
presence_penalty/frequency_penalty/logit_bias/seed無視。対応するサンプリング制御は行わない
logprobs/top_logprobs無視。Token 確率は返さない
system/developer先頭 system に改行で連結。会話中の元位置は保持しない
tool_choicerequired と関数指定も上記三モデルの強制呼び出し制限に従う
キャッシュとその他設定ネイティブキャッシュ設定は提供しない。store/service_tier/metadata/prediction/user/audio/modalities などは無視し、同名能力を有効にしない

キャッシュの差分

フィールド差分の説明
cache_controlMessages の type: ephemeral を使用。直下の自動選択かブロック上の明示指定で最大四断点
ttl既定値 5m、選択肢 1h。Chat の prompt_cache_options とは異なる
最小キャッシュプレフィックスHaiku 5.5、Sonnet 5.5、Opus 5.5、Fable 5.1、Opus 5、Fable 5 は入力 512 Token。Sonnet 5、Opus 4.8 は 1024。一致が必要で、閾値未満は書き込まない
思考ブロックthinking に直接断点は不可。履歴の思考は先行 assistant 内容の一部としてキャッシュ可能
キャッシュ使用量usage.cache_creation_input_tokens、usage.cache_read_input_tokens で書き込みと読み込みを確認。設定だけではヒットと判断しない

メディア入力の差分

入力プロトコルのブロック差分の説明
画像Messages imagesource に URL または Base64 を指定。Chat の image_url ではない
文書Messages documentネイティブ構造を user メッセージに配置し、assistant には置かない
画像Chat image_url公式互換層は image_url.url を読み取り、detail を無視
ファイルChat file公式互換層はこの入力を無視。ネイティブ文書機能とは異なる
音声Chat input_audio公式互換層はこの入力を無視。ネイティブ音声機能は得られない

呼び出し例

MODEL_ID を完全なモデル ID に置換してください。Messages は適応型思考と要約を明示有効化し、Chat は基本テキスト呼び出しのみです。

curl 'https://api.agtcloud.ai/v1/messages' \
  -H 'x-api-key: your-api-key' \
  -H 'anthropic-version: 2023-06-01' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "API のタイムアウトの調査方法を三点で説明してください"}],
    "max_tokens": 4096,
    "thinking": {"type": "adaptive", "display": "summarized"},
    "output_config": {"effort": "medium"}
  }'

公式資料

このページの内容