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:直接忽略,无报错也无效果。


















