AI 智能体技能故障排查

安装与 API 密钥

问题	解决方法
npx: command not found	安装 Node.js，然后重新运行 npx skills add https://muapi.ai。
智能体没有使用该技能	安装后重启智能体，或明确提出要求：“使用 muapi-models 技能来……”。
缺少 MUAPI_API_KEY	在你的 shell 中导出它，并从同一个终端重启智能体。
401 Unauthorized	请求头必须是 x-api-key。请在 muapi.ai/dashboard 检查密钥。
Windows 上无法识别变量	关闭所有终端（包括 VS Code 和 Cursor 中的终端）后重新打开，或在 PowerShell 中使用 $env:MUAPI_API_KEY。
PowerShell 拒绝 curl 参数	使用 curl.exe；PowerShell 会把 curl 别名为 Invoke-WebRequest。

模型运行

问题	解决方法
选错了模型	在请求中指明模型名称。
任务 failed	阅读智能体报告的错误，然后让它调整参数后重试。
积分不足	在控制台充值后重新运行。
结果链接已过期	结果会保留 30 天。重新运行任务，并让智能体把输出保存到本地。

仍然无法解决？

使用沙盒密钥（POST /api/v1/keys，请求体为 {"is_test": true}）测试同一个调用，以区分是请求参数问题还是账户问题。或通过 muapi.ai 联系支持团队。