其他工具集成

LAYSO AI 兼容 OpenAI、Anthropic 与 Gemini 三类常用协议。只要工具允许填写自定义 API 地址、API Key 和模型 ID，通常都可以接入 LAYSO AI。

一个 Key，访问全平台模型

LAYSO AI 按所选模型的当前价格计费。每个成功请求都有独立扣费明细，失败任务不会产生扣费。

开始之前

1. 在 LAYSO AI API Key 页面 ↗创建并复制 API Key。
2. 在 LAYSO AI 模型与价格页 ↗复制完整模型 ID。
3. 确认工具支持自定义 Provider、Base URL 或 Endpoint。
4. 确认工具使用的是 OpenAI、Anthropic 还是 Gemini 协议。

通用配置原则

先判断协议

工具使用的协议	Base URL / 根地址	API Key Header
OpenAI 兼容	https://api.layso.ai/v1	Authorization: Bearer <LAYSO_API_KEY>
Anthropic 原生	https://api.layso.ai	x-api-key: <LAYSO_API_KEY>
Gemini 原生	https://api.layso.ai	x-goog-api-key: <LAYSO_API_KEY>

Anthropic 和 Gemini 客户端应填写根地址，由客户端自动拼接原生请求路径。不要额外添加 /anthropic、/gemini 或 /v1beta。

再判断地址字段类型

有些工具要求 Base URL，有些工具要求完整请求地址，两者不能混用：

字段名称或用途	应填写的地址
OpenAI Base URL / API Base	https://api.layso.ai/v1
OpenAI Chat Completions Endpoint	https://api.layso.ai/v1/chat/completions
OpenAI Responses Endpoint	https://api.layso.ai/v1/responses
Anthropic Base URL	https://api.layso.ai
Gemini Base URL	https://api.layso.ai

不要重复路径

如果工具会自动追加 /v1/chat/completions，就只填 https://api.layso.ai/v1。只有字段明确要求完整 Endpoint 时，才填写完整请求地址。

Continue（VS Code / JetBrains）

Continue ↗ 是支持 VS Code 与 JetBrains 的 AI 编码助手。当前版本优先使用 ~/.continue/config.yaml，旧的 config.json 格式已不再推荐。

在 ~/.continue/config.yaml 中添加：

name: LAYSO AI
version: 1.0.0
schema: v1

models:
  - name: LAYSO AI Model
    provider: openai
    model: <MODEL_ID>
    apiBase: https://api.layso.ai/v1
    apiKey: ${{ secrets.LAYSO_API_KEY }}
    roles:
      - chat
      - edit
      - apply

在 Continue 的 Secret 管理中创建 LAYSO_API_KEY，值使用 API Key 页面 ↗生成的 Key。保存后重载 IDE，再从模型选择器中选择 LAYSO AI Model。

Aider

Aider ↗ 支持 OpenAI 兼容接口。建议把密钥放入本机环境变量，不要写入项目仓库。

macOS / Linux / WSL

export OPENAI_API_BASE="https://api.layso.ai/v1"
export OPENAI_API_KEY="<LAYSO_API_KEY>"
aider --model openai/<MODEL_ID>

Windows PowerShell

$env:OPENAI_API_BASE = "https://api.layso.ai/v1"
$env:OPENAI_API_KEY = "<LAYSO_API_KEY>"
aider --model openai/<MODEL_ID>

这里第一个 openai/ 用于告诉 Aider 通过 OpenAI 兼容协议请求；<MODEL_ID> 替换为模型与价格页显示的完整网关模型 ID。你也可以使用 Aider 的 .env 或 .aider.conf.yml 保存相同配置。

BoltAI（macOS）

1. 打开 BoltAI → Preferences → Providers。
2. 添加 Custom OpenAI Provider。
3. Base URL 填写 https://api.layso.ai/v1。
4. API Key 填写从 API Key 页面 ↗复制的 Key。
5. 模型填写 模型与价格页 ↗展示的完整 ID。
6. 保存后发送一条简短消息验证连接。

TypingMind

TypingMind 的自定义模型字段要求完整 Chat Completions Endpoint：

字段	填写内容
Name	LAYSO AI 或自定义名称
Endpoint	https://api.layso.ai/v1/chat/completions
Model ID	<MODEL_ID>
Custom Header	Authorization
Header Value	Bearer <LAYSO_API_KEY>

进入 Models → Add Custom Model，填写上表内容后点击测试并保存。模型 ID 必须使用模型与价格页 ↗提供的完整 ID。

Chatbox

Chatbox 支持 OpenAI 兼容 Provider，API Host 与普通 Base URL 的写法可能不同。请直接阅读Chatbox 配置教程，按教程中的字段填写，避免多写或漏写 /v1。

自定义集成

图形界面工具

1. 打开工具的 Provider、模型服务或 API 设置。
2. 选择 OpenAI Compatible、Anthropic 或 Gemini 协议。
3. 根据字段是 Base URL 还是完整 Endpoint 填写对应地址。
4. 填写从 API Key 页面 ↗复制的 Key。
5. 填写完整 <MODEL_ID>，不要猜测模型别名。
6. 测试连接，保存并将 LAYSO AI 设为当前 Provider。

代码或命令行工具

先用模型列表接口验证 Key 与网络：

curl https://api.layso.ai/v1/models \
  -H "Authorization: Bearer $LAYSO_API_KEY"

再使用最小 Chat Completions 请求验证模型：

curl https://api.layso.ai/v1/chat/completions \
  -H "Authorization: Bearer $LAYSO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<MODEL_ID>",
    "messages": [{"role": "user", "content": "Say hello in one sentence."}]
  }'

请求成功后，可在 LAYSO AI 用量明细 ↗查看模型、Token 和逐笔扣费。

认证与排查

401 或 403

重新复制 API Key，确认没有前后空格或换行；同时检查工具使用的请求头是否与当前协议一致。

404

通常是把 Base URL 与完整 Endpoint 混用了，或工具重复追加了 /v1。先查看工具字段说明，再对照本页地址表。

模型不存在

从模型与价格页 ↗复制完整 ID。一个 LAYSO AI API Key 可以访问全平台模型，无需按模型创建不同 Key。

连接成功但功能不完整

工具可能依赖特定协议能力，例如 Responses API、工具调用、视觉输入或结构化输出。请确认工具与所选模型都支持对应能力；仅能填写 API Key 不代表所有功能都兼容。

没有扣费记录

先确认任务是否成功。成功请求会产生独立扣费明细，失败任务不会产生扣费。