LAYSO AI CLI
通过 LAYSO AI 将 LAYSO AI CLI 接入全球主流 AI 模型。本文使用 VitePress 原生 Markdown 编写，右侧“本页目录”可直接定位每个步骤。
一个 Key，访问全平台模型
LAYSO AI 按所选模型的当前价格计费。每个成功请求都有扣费明细，失败任务不会产生扣费。
开始之前
- 类别：快速配置工具
- 推荐协议：OpenAI / Anthropic / Gemini
- 在 LAYSO AI 控制台 创建 API Key。
- 从控制台模型目录复制完整模型 ID，不要猜测模型别名。
配置 LAYSO AI
| 字段 | 填写内容 |
|---|---|
| Provider | LAYSO AI |
| Base URL | https://api.layso.ai/v1 |
| API Key / 环境变量 | LAYSO_API_KEY |
| 请求头 | Authorization: Bearer $LAYSO_API_KEY |
| Model | <MODEL_ID> |
保存后重启客户端，确保新的环境变量与 Provider 配置已经加载。
安装与启动
bash
npm install -g laysoai
laysoai首次调用
先用最小请求确认 API Key、网络和模型 ID，再开始长任务。
bash
curl https://api.layso.ai/v1/models \
-H "Authorization: Bearer $LAYSO_API_KEY"成功后，在客户端发送一条简短消息，并确认返回的模型与控制台选择一致。
认证与排查
检查顺序
- 确认 API Key 没有前后空格、换行或缺失字符。
- 确认 Base URL 没有重复追加
/v1或/v1beta。 - 完全退出并重新打开终端或客户端，让环境变量重新加载。
- 刷新模型目录并复制完整模型 ID。
- 不要在截图、日志、配置示例或代码仓库中暴露完整密钥。
常见错误
| 现象 | 排查方法 |
|---|---|
401 / 403 | 检查 API Key、环境变量和当前协议要求的请求头。 |
404 | 检查 Base URL 与协议路径是否漏写或重复。 |
| 模型不存在 | 使用控制台模型目录中的完整模型 ID。 |
| 没有扣费记录 | 先确认任务是否成功；失败任务不会扣费。 |
计费与安全
- 一个 LAYSO AI API Key 可以访问全平台模型。
- 每个成功请求都可以在任务明细中查看逐笔扣费。
- 失败任务不会产生扣费。
- API Key 只保存在本机环境变量或客户端安全存储中。