muse wonder的openai兼容层仅限muse model api通道，wonder full版本不支持sdk调用；需使用meta提供的base_url和专用api key，并指定model="muse-wonder-std"。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想用现有 OpenAI SDK 代码快速对接 Muse Wonder，但发现请求发出去后报错 401 或返回空模型列表——这不是你代码写错了，而是 Muse Wonder 的 OpenAI 兼容层只开放给 Muse Model API 通道，且【Wonder Full 版本完全不支持任何 SDK 调用，仅限 Muse Code 订阅客户端内使用】。
确认可用的接入路径
第一步：打开 Meta Muse Model API 官方文档页，滚动到底部「Supported Clients」章节，确认当前仅列出 Python、TypeScript 两种 SDK 支持状态，其他语言需自行实现协议适配。
第二步：在文档中搜索 “openai-compatible endpoint”，找到形如 https://api.meta.com/v1 的 base_url ——注意这个地址【不是 OpenAI 官方的 https://api.openai.com/v1】，硬编码替换时必须同步更新所有请求入口。
第三步：登录 Meta for Developers 控制台 → 进入 Muse Model API 项目 → 点击「API Keys」→ 复制生成的 key。该 key 仅对 Muse Model API 生效，无法用于 Wonder Full 或 Llama 系列服务。
Python 客户端配置（推荐方式）
方法一：直接复用 openai>=1.45.0 包（无需改业务逻辑）
安装最新版：pip install openai>=1.45.0
初始化 client 时显式指定 base_url 和 model_id：
from openai import OpenAI<br>client = OpenAI(<br> api_key="your_meta_api_key_here",<br> base_url="https://api.meta.com/v1",<br> default_headers={"x-meta-source": "muse-sdk"}<br>)<br>response = client.chat.completions.create(<br> model="muse-wonder-std",<br> messages=[{"role": "user", "content": "你好"}]<br>)
注意：model 字段必须填 muse-wonder-std，填 wonder-full 或 full 会直接返回 404 —— Wonder Full 根本不注册在 Model API 的模型列表中。
TypeScript 客户端配置
方法一：使用官方 @meta/muse-sdk（轻量封装）
执行：npm install @meta/muse-sdk
初始化时传入 OpenAI 兼容参数对象：
import { MuseClient } from "@meta/muse-sdk";<br>const client = new MuseClient({<br> apiKey: "your_meta_api_key_here",<br> baseURL: "https://api.meta.com/v1",<br> defaultModel: "muse-wonder-std"<br>});
方法二：复用 openai npm 包（v4+）
需手动 patch fetch 实现以支持 x-meta-source header，否则部分鉴权中间件会拒绝请求。这一步不能跳过，否则请求会在 Meta 边缘网关被静默丢弃。
关键请求参数适配
temperature、max_tokens、top_p 可照常传入，但以下字段 Muse Model API 不支持：
• response_format：暂不接受 {"type": "json_object"}，JSON 输出需靠 system prompt 强约束；
• tools 数组：虽然接口接收该字段，但 muse-wonder-std 当前版本【不触发任何工具调用逻辑，仅作透传】，实际执行仍由 Muse Code 客户端侧接管；
• parallel_tool_calls：直接忽略，无报错也无效果。
