Hunyuan のパラメーターとプロトコルの違い
互換プロトコルにおける Hunyuan のパラメーターの違いと使い方を確認します。
Hunyuan は本ページに従ってパラメーターを調整してください。完全な構造は Chat Completions、Responses、Messages を参照してください。
| モデル | 適用範囲 |
|---|
| hy4-preview | Chat、Responses、Messages 対応。Chat の深度は none/high、既定値 high |
| hy3 | Chat、Responses、Messages 対応。Chat の深度は none/low/high、既定値 high。思考保持とツール制限は下表を参照 |
| フィールド | 差分の説明 |
|---|
thinking.type | 両モデルは既定で思考有効。enabled/disabled で明示切替。reasoning_effort の対応深度は上表 |
reasoning_effort | Hy3 は tools ありの場合、low を high に変換し、ツールタスクに応じて深度を決定 |
max_tokens、max_completion_tokens | どちらも思考と最終回答の合計を制限し、後者を優先。Hy3 の思考時は最低 16000 を推奨するが、必須最小値ではない |
top_k、repetition_penalty | 指定しても黙って無視。Qwen 型の拡張として使用しない |
n | 思考有効時は 1 が必要 |
preserved_thinking | Hy3 の思考保持スイッチ。tools ありは既定で有効、通常の文字会話は無効。綴りは preserved_thinking |
過去の reasoning_content | ツール結果を返す際は前の assistant 思考と tool_calls を完全保持。思考保持を有効にしても欠けた履歴は補完されない |
tool_choice | 思考時は auto/none を使用し、required や関数指定は使用しない |
web_search_options | Hy3 検索拡張。enable: true を設定。search_source は standard/lite、既定値 standard。対象は Hy3 の検索のみ |
| フィールド | 差分の説明 |
|---|
max_output_tokens | 思考と最終回答を含む。可視文字だけで予算を設定しない |
tool_choice | Hy3 は auto/none のみ対応。required と関数指定オブジェクトは非対応 |
previous_response_id | Hy3 は空でない値に 400 を返す。複数ターンは input に履歴を渡す |
reasoning.preserved_thinking | Hy3 の思考保持スイッチで reasoning 内に配置。既定戦略は Chat と同じ |
text.format | text/json_object/json_schema に対応。Hy3 の JSON Schema は additionalProperties: false が必要 |
tools 内の web_search | Hy3 の検索は type: "web_search" を使用し、Chat の web_search_options とは設定位置が異なる |
| フィールド | 差分の説明 |
|---|
thinking.type、max_tokens | 明示切替は enabled/disabled。max_tokens は思考と最終回答を含む。budget_tokens を設定する際は本文の余裕を確保 |
HY-Preserved-Thinking | Hy3 思考保持用 Header。true/false に対応、省略時は既定戦略。Chat のトップレベル設定を Messages 本文に移さない |
| 過去の thinking ブロック | ツール結果とともに実際の assistant 内容を保持。Hy3 が signature を返さなくても署名を作らない。Claude の署名必須ルールは適用しない |
| フィールド | 差分の説明 |
|---|
prompt_cache_key | Chat のキャッシュ ID 拡張。同じプレフィックスと安定値を保ち、応答でヒットを確認 |
| 思考保持とキャッシュ | 思考保持は推論継続の仕組みで、ヒットを意味しない。完全で安定した履歴はプレフィックス再利用に有効 |
| キャッシュ使用量 | Chat は usage.prompt_tokens_details.cached_tokens、Responses は実際の usage.input_tokens_details.cached_tokens、Messages は実際の usage.cache_read_input_tokens |
MODEL_ID を完全なモデル ID に置換し、自分の API Key を使用してください。以下はすべて文字入力です。
curl 'https://api.agtcloud.ai/v1/chat/completions' \
-H 'Authorization: Bearer your-api-key' \
-H 'Content-Type: application/json' \
--data '{
"model": "MODEL_ID",
"messages": [{"role": "user", "content": "API のタイムアウトの調査方法を三点で説明してください"}],
"reasoning_effort": "high",
"max_completion_tokens": 16384
}'