AI 应用接入教程

更新时间：2026-04-28

本文适用于将常见 AI 应用接入到你的站点 https://api.satuo66.online。

站点根地址：https://api.satuo66.online
OpenAI 兼容地址：https://api.satuo66.online/v1

使用前准备

开始前请先准备好这 3 项：

• API Key
• 你要使用的 模型名称
• 对应应用需要的正确地址格式

地址格式有 3 种常见写法：

1. 站点根地址：https://api.satuo66.online
2. OpenAI 兼容地址：https://api.satuo66.online/v1
3. 完整请求地址：https://api.satuo66.online/v1/chat/completions

不要混用这 3 种地址。每个应用该填哪一种，下面已经分别写清楚。

Cherry Studio

填写内容

API 地址：https://api.satuo66.online
API Key：你的 API Key
模型名称：你的模型名

配置步骤

1. 打开 Cherry Studio
2. 进入模型服务商或接口配置页面
3. 新增一个自定义服务商，或选择兼容的服务商类型
4. 按上面的示例填写 API 地址、API Key、模型名称
5. 保存后，在对话页面选择刚添加的模型

提示

• Cherry Studio 这里通常填写站点根地址，不需要额外补 /v1
• 如果模型拉取成功但无法对话，优先检查模型名称是否和平台完全一致

Claude Code

Claude Code 推荐直接使用环境变量方式配置。

需要填写的值

ANTHROPIC_BASE_URL=https://api.satuo66.online
ANTHROPIC_AUTH_TOKEN=你的 API Key

macOS / Linux 配置方法

把下面内容写入 ~/.zshrc 或 ~/.bashrc：

export ANTHROPIC_BASE_URL='https://api.satuo66.online'
export ANTHROPIC_AUTH_TOKEN='你的 API Key'

写完后执行：

source ~/.zshrc

或：

source ~/.bashrc

使用方式

claude

提示

• Claude Code 这里填写站点根地址，不要写成 /v1
• 如果你已经配置过别的 ANTHROPIC_* 变量，记得先检查是否被旧值覆盖

Codex CLI

Codex CLI 需要配置两个文件：~/.codex/config.toml 和 ~/.codex/auth.json。

配置文件 1：config.toml

创建或修改：

~/.codex/config.toml

写入：

model = "gpt-5-codex"
model_provider = "custom"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.custom]
name = "custom"
base_url = "https://api.satuo66.online/v1"
wire_api = "responses"

配置文件 2：auth.json

创建或修改：

~/.codex/auth.json

写入：

{
  "OPENAI_API_KEY": "你的 API Key"
}

使用方式

codex

提示

• base_url 这里要写成 https://api.satuo66.online/v1
• model 可以换成你实际可用的模型名
• wire_api = "responses" 建议保留，不要删掉

LangBot

LangBot 常见会用到 3 类模型：对话模型、画图模型、嵌入模型。

对话模型配置

API 地址：https://api.satuo66.online/v1
API Key：你的 API Key
模型名称：你的对话模型

画图模型配置

API 地址：https://api.satuo66.online/v1
API Key：你的 API Key
模型名称：你的绘图模型

嵌入模型配置

如果你要配置知识库：

1. 先在 模型供应商 中添加嵌入模型
2. 再进入 Knowledge Base
3. 选择嵌入模型
4. 绑定刚刚添加的模型

提示

• LangBot 一般填写 OpenAI 兼容地址，也就是 /v1
• 对话模型、绘图模型、嵌入模型可以分别填写不同模型名

AstrBot

填写内容

提供商类型：OpenAI
API Base URL：https://api.satuo66.online/v1
API Key：你的 API Key
模型名称：你的模型名

配置步骤

1. 打开 AstrBot
2. 进入模型提供商配置
3. 点击 新增模型提供商
4. 提供商类型选择 OpenAI
5. 按上面的示例填写 API Base URL、API Key、模型名称
6. 保存后，在默认模型设置中选择刚创建的模型提供商

提示

• AstrBot 这里填写的是 /v1
• 如果保存后模型列表为空，优先检查 API Key 和模型名是否填写正确

OpenClaw

OpenClaw 一般是在 provider 配置中新增一个自定义服务商。

配置示例

{
  "providers": {
    "qingyunshe": {
      "name": "QingYunshe",
      "baseURL": "https://api.satuo66.online/v1",
      "apiKey": "你的 API Key",
      "models": [
        "你的模型名称"
      ]
    }
  }
}

使用方式

保存后，在 OpenClaw 中选择你定义的 provider 和模型即可。

提示

• baseURL 这里写 /v1
• models 数组里的模型名要和平台支持的模型名完全一致

Hermes

Hermes 官方现在更推荐使用配置向导或 config.yaml，不要再沿用旧版的 OPENAI_BASE_URL、LLM_MODEL 那套写法。

方法 1：使用配置向导

在终端执行：

hermes model

然后按下面的思路填写：

Provider：Custom endpoint
API base URL：https://api.satuo66.online/v1
API key：你的 API Key
Model name：你的模型名

方法 2：手动写入配置文件

创建或修改：

~/.hermes/config.yaml

写入：

model:
  default: 你的模型名
  provider: custom
  base_url: https://api.satuo66.online/v1
  api_key: 你的 API Key

提示

• Hermes 这里推荐填写 /v1
• 如果你之前照旧教程配置过环境变量，建议优先以 config.yaml 为准
• 某些高级功能如果额外需要辅助模型，再按 Hermes 自身提示补充即可

Trae

Trae 目前不同版本对“地址怎么填”的界面提示略有差异。对接 qingyunshe 这类 OpenAI 兼容服务时，最稳的方式是直接填写完整请求地址。

建议先确认版本

• 国内版本：建议 3.3.51 或更高
• 国际版本：建议 3.5.51 或更高

如果你的版本过低，可能看不到“自定义模型”或“自定义请求地址”相关入口。

推荐填写方式

提供商协议：OpenAI
自定义请求地址：https://api.satuo66.online/v1/chat/completions
API Key：你的 API Key
Model ID：你的模型名

配置步骤

1. 打开 Trae
2. 进入模型或 AI 配置页面
3. 选择添加自定义模型，或选择兼容 OpenAI 的自定义提供商
4. 按上面的示例填写 自定义请求地址、API Key、Model ID
5. 保存后，把这个模型设为你要使用的模型

提示

• Trae 这里优先填写完整请求地址：https://api.satuo66.online/v1/chat/completions
• 不建议只填根地址，否则很容易出现保存成功但调用失败的情况
• 如果保存后能连通但没有正常回复，先检查模型名是否准确，再尝试重启 Trae 的 AI 服务

地址速查表

常见问题

1. 为什么有的应用填根地址，有的应用要填 /v1？

因为不同应用对“上游地址”的定义不一样：

• 有些应用自己会在内部补 OpenAI 路径，所以你只填根地址
• 有些应用要求你直接填 OpenAI 兼容地址，所以要补 /v1
• Trae 这类新应用，某些版本甚至要求你直接填完整请求地址

2. 保存成功了，但调用时报错怎么办？

优先检查这 4 项：

1. API Key 是否正确
2. 模型名称是否和平台完全一致
3. 地址格式是否和该应用要求一致
4. 该应用使用的是 chat/completions 还是 responses 协议

3. 模型列表拉不出来怎么办？

通常优先排查：

• 地址写错
• API Key 无效
• 模型名称拼写不对
• 当前应用版本过旧