跳到主要内容

Alma 客户端

Alma 支持通过自定义模型服务接入 OpenAI 兼容 API。把 MuskAI 添加为一个独立服务后，就可以在 Alma 里使用本站 API Key 调用可用模型。

准备信息​

进入官网用户中心 -【API密钥】页面，准备两项内容：

  • API Key：创建后复制完整 Key。
  • Base URL：复制页面展示的当前推荐地址。

模型名请以控制台当前可用模型为准。

添加服务​

在 Alma 中进入模型或服务商设置，新增自定义 OpenAI 兼容服务：

字段填写方式
NameMuskAI
API TypeOpenAI Compatible / OpenAI 兼容
API Key官网用户中心 -【API密钥】页面复制的 Key
Base URL官网用户中心 -【API密钥】页面复制的 Base URL
Model控制台可用模型名

保存后，选择刚添加的 MuskAI 服务作为当前会话模型。

验证​

先发送短问题，例如：

请用一句话介绍你当前使用的模型。

如果能正常返回，再运行长上下文、代码生成或多轮任务。首次配置不要直接执行高成本任务，避免错误配置导致重复重试。

常见问题​

  • 模型列表为空：手动添加控制台可用模型名。
  • 无法连接：检查 Base URL 是否从用户中心复制，不要自行追加 /v1/chat/completions。
  • 返回 401/403：检查 Key 是否完整、是否启用、余额或套餐是否可用。
  • 回复模型不符合预期：确认 Alma 当前会话选择的是 MuskAI 服务和正确模型。