Muse のパラメーターとプロトコルの違い
互換プロトコルにおける Muse のパラメーターの違いと使い方を確認します。
Muse の思考、ツール、キャッシュを調整してください。完全な構造は Chat Completions、Responses、Messages を参照してください。
| モデル | 利用上の要点 |
|---|
| muse-wonder-1.0 | 三プロトコル対応、思考無効化不可。max は深度であり Muse Wonder Full への切替ではない |
| muse-spark-1.3 | 同じ形式で max にも対応。音声のモデル制限はメディア表を参照 |
| フィールド | 差分の説明 |
|---|
reasoning_effort | 両モデルは minimal/low/medium/high/xhigh/max を使用。省略しても思考し、none は 400 |
max_completion_tokens | 思考と可視回答の共有予算。旧別名 max_tokens も受付。Responses の max_output_tokens は使わない |
temperature/top_p | 前者は 0～2、後者は (0,1]。既定値は両方 1。通常は既定値を使うか一方のみ調整。top_p: 0 は 400 |
n | 1 のみ対応。1 超は 400 |
| 非互換設定 | stop、verbosity、logit_bias、prediction、modalities、audio、web_search_options は非対応。一般の例から転用しない |
| ペナルティと Logprobs | frequency_penalty/presence_penalty は非対応でエラーになる場合がある。logprobs: true は 400 |
tool_choice | auto のみ。none、required、関数指定は 400。関数名のピリオドは一つまで |
reasoning_content | 外部 API は読める元思考を返さず、このフィールドでターン間保持はできない。継続は Responses／Messages を使用 |
strict | 関数・構造化出力は既定 false。有効時は各オブジェクトに additionalProperties: false、required に全属性が必要。ルートは通常オブジェクトで oneOf/allOf 不可 |
| フィールド | 差分の説明 |
|---|
reasoning.effort | Chat と同じ六深度で none 非対応。reasoning.summary は要約を要求できるが、暗号化履歴の代替にはならない |
max_output_tokens | 最小 16。思考と可視回答を含み、入力と出力予算の合計もコンテキスト内である必要がある |
include | reasoning.encrypted_content で暗号化思考を要求。既定では返さない。store: false では全出力を手動再送し暗号文を変えない |
previous_response_id | 保存済み履歴・思考をサーバー側で継続。手動再送とどちらかを選び、最終文だけを完全な思考再送とみなさない |
truncation | 既定 disabled のみ。auto は 400。長い履歴は自分で管理 |
background/stream | 作成時に両方を true にすると 400。作成後はバックグラウンドを照会・ストリーム取得可能 |
tool_choice | 同じく auto のみ。web_search と tool_search はサーバー検索・ツール発見用で、Chat にはない |
text.format/strict | Responses 用の構造化設定を使用。トップレベル response_format は互換受付されても形式設定に効かない。厳密設定は上記と同じ |
| Logprobs とストリーミング使用量 | message.output_text.logprobs は 400。最後のストリーム応答は使用量付き。Chat の stream_options.include_usage は無効 |
| フィールド | 差分の説明 |
|---|
max_tokens | 必須で最小 1。思考と回答の余裕を確保。Responses の名称・最小値を流用しない |
thinking/output_config.effort | thinking.type: adaptive と low/medium/high/xhigh/max を推奨。minimal と disabled では思考を無効化できない |
thinking.budget_tokens | 旧 enabled は受付するが深度に変換しない。予算は 1024 以上、max_tokens 未満。深度は output_config.effort で調整 |
thinking.display | summarized は要約、omitted は暗号化思考のみ。返された思考、特に redacted_thinking を変更せず再送 |
temperature | 範囲 0～1。Chat／Responses の上限を使わず、通常は省略 |
| 非互換フィールド | top_k、stop_sequences、inference_geo は明示的に非対応で拒否 |
tool_choice | auto/any/none は受付。{type: "tool"} でツール指定は不可。disable_parallel_tool_use: true は並列を制限 |
output_config.format | {type: "json_schema", schema: ...} で構造化出力。文書ブロックの citations.enabled: true は非対応 |
| 検索と履歴 | 検索は web_search。allowed_domains/blocked_domains/max_uses は 400。元の Messages は会話を保存せず毎回全メッセージ・ツール結果を再送。previous_response_id 相当の入口はない |
| フィールド | 差分の説明 |
|---|
| 自動プレフィックスキャッシュ | スイッチ不要。固定指示・例・資料を先頭、変数を末尾にして再利用プレフィックスを一致させる |
prompt_cache_key | Chat／Responses の任意グループ ID。共有プレフィックス単位で設定し、利用者やリクエストごとに乱立させない |
prompt_cache_retention | Responses の in_memory/24h は保持ヒントで、実際はサーバー管理。新 OpenAI 設定の転用や非推奨扱いはしない |
cache_control | Messages は直下・ブロック・ツールのマーカーを受付。ttl は 5m のみで、Claude の 1h は不可 |
| キャッシュ使用量 | Chat は usage.prompt_tokens_details.cached_tokens、Responses は usage.input_tokens_details.cached_tokens、Messages は usage.cache_read_input_tokens。ID 指定だけではヒットを保証しない |
| 制限 | 説明 |
|---|
| 画像 | インライン画像は一枚最大 50 MB（50000000 バイト）、一回最大 50 枚。本文とコンテキスト制限も適用。user メッセージに配置 |
| Spark 1.3 音声 | 音声理解は完全対応ではなく、音声で品質が低下する場合がある |
| 出力 | 両モデルとも文字出力。画像・音声・動画入力は生成対応を意味しない |
MODEL_ID を完全なモデル ID に置換してください。キャッシュ ID は共有プレフィックス単位で設定。三例とも低深度と明示予算です。
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": "low",
"max_completion_tokens": 4096,
"prompt_cache_key": "YOUR_SHARED_PREFIX"
}'