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 | 原廠對外呼叫不會回傳可讀的原始思考，不能依賴此欄位保留跨輪思考；需要延續時使用 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 的可選分組識別碼；按共享提示前綴設置，不為每個用戶或請求機械生成不同識別碼，以免分散相同前綴的路由 |
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；設置識別碼不代表必然命中 |
| 限制 | 說明 |
|---|
| 圖片 | 單張內聯圖片最大 50 MB（50000000 位元組），每次最多 50 張，且受請求體與上下文限制；圖片內容放在用戶消息中 |
| Spark 1.3 音訊 | 音訊理解尚未完整支援，包含音訊時質量可能下降 |
| 輸出 | 兩款均輸出文字；接收圖片、音訊或影片不代表支援生成這些媒體 |
將 MODEL_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"
}'