把模型接入，保持简单。

01 / QUICK START

完成下面三步即可发起第一条请求。LFAPI 的账户、API Key 和额度均在控制台管理。

1. 1
   注册并登录

   使用符合站点要求的邮箱完成注册。新账户默认额度为 0；审核通过后由管理员发放额度，再创建 API Key。

2. 2
   创建 API Key

   进入控制台的「API 密钥」页面，按需选择分组，创建一枚只用于当前应用的 Key，并妥善保存。

3. 3
   确认可用模型

   先请求模型列表，再在业务侧选择返回列表中的模型 ID。

02 / AUTHENTICATION

所有面向模型的请求都需要在 HTTP 请求头中携带 Bearer Token。不要把 Key 提交到仓库、前端代码或公开日志。

Authorization: Bearer sk-你的密钥

03 / API REFERENCE

以下路径均以 https://ai.liangfeng.net.cn/v1 为基础地址，唯一的例外是 Gemini 兼容端点（位于站点根路径，见下表）。请求字段与对应协议的官方接口保持一致；实际可用模型以模型列表为准。

核心端点

扩展端点

以下端点同样可用，但可用性随分组与上游渠道变化，调用前请先用模型列表确认。

curl https://ai.liangfeng.net.cn/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

04 / MODELS & GROUPS

分组决定一枚 API Key 能调用哪些模型、按什么倍率计费。创建密钥时选择分组，不确定时先使用默认分组。

可选分组会随渠道调整，以控制台「API 密钥」页中的选项为准。

可用模型

默认分组当前提供 21 个模型，下面是其中一部分代表性 id：

curl https://ai.liangfeng.net.cn/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

不同分组返回的模型列表不同，请始终以 GET /v1/models 的返回结果为准，不要照抄文档里的 id。

计费

• 按量计费：费用由输入与输出的 token 数量决定。
• 倍率随分组不同，同一模型在不同分组下的价格可能不一样。
• 实时价格见模型广场。

05 / STREAMING

在 /chat/completions 请求体中设置 stream: true，服务端将通过 Server-Sent Events 逐段返回生成内容。客户端需要持续读取连接直到收到结束事件。

{
  "model": "deepseek-v4.1-flash",
  "messages": [{ "role": "user", "content": "你好" }],
  "stream": true
}

把 model 换成你所在分组实际可用的 id 即可。

06 / ACCOUNT

额度来源：

额度由管理员审核通过后手动充入账户；本站不提供自助充值或在线支付。

请仅使用自己的 API Key。发现 Key 泄露时，应立即在控制台删除旧 Key 并创建新 Key。

07 / RESPONSES

下表是最常见的状态码；更具体的原因通常写在响应体的 error.message 中。

常见问题

08 / OPENCODE

3 分钟把 OpenCode（终端 TUI / 桌面版）接入本站；配置一次，TUI、桌面版和 IDE 插件通用。

安装 OpenCode

桌面版（推荐新手）：

下载页：opencode.ai/download ｜ 官方文档：opencode.ai/docs

终端 CLI：

npm install -g opencode-ai
# 或一键脚本（macOS / Linux）
curl -fsSL https://opencode.ai/install | bash
# 或 Homebrew（macOS）
brew install anomalyco/tap/opencode

创建 API 密钥

1. 1
   进入控制台

   登录本站，打开左侧「API 密钥」页面，点击「新建密钥」。

2. 2
   选择分组

   按需选择分组，例如 ds_flash、glm 或默认分组；分组决定可用模型与计费倍率，见模型与分组。

3. 3
   复制密钥

   复制 sk- 开头的密钥；密钥只显示一次，请妥善保存。

一键配置（推荐）

先从脚本下载获取配置脚本，再按平台运行；脚本会自动写入或合并配置文件，原配置会先备份。

# 在存放脚本的目录打开 PowerShell
.\configure-opencode.ps1 -ApiKey "sk-你的密钥"

chmod +x configure-opencode.sh
./configure-opencode.sh sk-你的密钥

手动配置

配置文件位置：

将以下内容写入 opencode.json；若已有配置，把 provider 段合并进去：

{
  "$schema": "https://opencode.ai/config.json",
  "model": "liangfeng/deepseek-v4.1-flash",
  "small_model": "liangfeng/glm-5.3-flash",
  "provider": {
    "liangfeng": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Liangfeng Relay",
      "options": {
        "baseURL": "https://ai.liangfeng.net.cn/v1",
        "apiKey": "sk-你的密钥"
      },
      "models": {
        "deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash" },
        "deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
        "glm-5.3-flash": { "name": "GLM-5.3 Flash" },
        "qwen3.8-flash": { "name": "Qwen 3.8 Flash" },
        "gpt-5.6-terra": { "name": "GPT-5.6 Terra" }
      }
    }
  }
}

• npm：OpenAI 兼容协议（/v1/chat/completions）使用 @ai-sdk/openai-compatible。
• models 的键必须与本站 GET /v1/models 返回的 id 一致。
• apiKey 可写 {env:LIANGFENG_API_KEY} 避免把密钥明文落盘（需自行设置环境变量）。
• 顶层 model 为默认模型，格式为 <providerID>/<modelID>。

使用与验证

启动 OpenCode，执行 /models 选择 liangfeng/deepseek-v4.1-flash，发送一句话验证即可。

进阶

• 切换模型：直接改顶层 model，或在对话中用 /models 切换。
• 项目级配置：在项目根目录放置 opencode.json 可覆盖全局配置（适合团队共享非敏感设置）。
• 更多官方文档：配置说明 ｜ 供应商。

09 / CLAUDE CODE

Claude Code 使用 Anthropic 协议，本站的 /v1/messages 兼容端点已实测可用；只要设置两个环境变量，它就完全按原有方式工作。

安装

npm install -g @anthropic-ai/claude-code

配置环境变量

setx ANTHROPIC_BASE_URL "https://ai.liangfeng.net.cn"
setx ANTHROPIC_AUTH_TOKEN "sk-你的密钥"

export ANTHROPIC_BASE_URL="https://ai.liangfeng.net.cn"
export ANTHROPIC_AUTH_TOKEN="sk-你的密钥"

使用与验证

在任意项目目录运行 claude，发送一句话确认能正常回复。Windows 的 setx 需要重新打开终端后生效；只想在当前会话生效时，可改用 $env:ANTHROPIC_BASE_URL="https://ai.liangfeng.net.cn" 这种写法。

10 / GEMINI CLI

Gemini CLI 走本站的 Gemini 兼容端点 /v1beta，已实测可用；同样只需要两个环境变量。

安装

npm install -g @google/gemini-cli

配置环境变量

setx GEMINI_API_KEY "sk-你的密钥"
setx GOOGLE_GEMINI_BASE_URL "https://ai.liangfeng.net.cn"

export GEMINI_API_KEY="sk-你的密钥"
export GOOGLE_GEMINI_BASE_URL="https://ai.liangfeng.net.cn"

11 / CODEX + CC SWITCH

用 CC Switch 管理 Codex 的供应商配置，5 分钟完成接入（含远程压缩支持）。

安装

创建 API 密钥

1. 1
   新建密钥

   登录本站，打开左侧「API 密钥」页面，点击「新建密钥」；分组按需选择，不确定时先使用默认分组。

2. 2
   复制密钥

   复制 sk- 开头的密钥；密钥只显示一次，请妥善保存。

一键导入（推荐）

方式 A：CC Switch 深链导入。把下面链接中的 <你的KEY> 替换为实际密钥，在浏览器地址栏粘贴访问（或直接点击），CC Switch 会弹出导入确认：

ccswitch://v1/import?resource=provider&app=codex&name=Liangfeng&endpoint=https%3A%2F%2Fai.liangfeng.net.cn%2Fv1&apiKey=<你的KEY>&model=gpt-5.6-terra

参数说明：name 为显示名、endpoint 为接口地址、apiKey 为你的密钥、model 为默认模型（省略时默认 gpt-5-codex）。

方式 B：一键配置脚本。下载 configure-codex-ccswitch.ps1（Windows）运行；脚本会：

1. 1
   生成导入深链

   输出可直接点击的 CC Switch 导入链接。

2. 2
   可选写入配置

   加 -WriteConfig 可直接写入 ~/.codex/config.toml 与 ~/.codex/auth.json（写入前自动备份）。

.\configure-codex-ccswitch.ps1 -ApiKey "sk-你的密钥"
# 直接写入配置文件（不经 CC Switch 界面）：
.\configure-codex-ccswitch.ps1 -ApiKey "sk-你的密钥" -WriteConfig

手动配置

若不用 CC Switch，直接编辑两个文件（Windows 为 %USERPROFILE%\.codex\，macOS / Linux 为 ~/.codex/）：

model_provider = "liangfeng"
model = "gpt-5.6-terra"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.liangfeng]
name = "Liangfeng"
base_url = "https://ai.liangfeng.net.cn/v1"
wire_api = "responses"
requires_openai_auth = true

{ "OPENAI_API_KEY": "sk-你的密钥" }

• wire_api = "responses"：本站支持 Responses API（也可改为 "chat" 走 Chat Completions 协议）。
• requires_openai_auth = true：让 Codex 从 auth.json 读取 OPENAI_API_KEY。
• 不想用 auth.json 时，可在 [model_providers.liangfeng] 段内改用 experimental_bearer_token = "sk-你的密钥"。

远程压缩（长对话自动压缩）

启用方式（二选一）：

• CC Switch：在供应商编辑页勾选「启用远程压缩」（会把 provider 的 name 写入为 OpenAI 以通过 Codex 的门控检查）。
• 手动：在 [model_providers.liangfeng] 段添加 name = "OpenAI"（Codex 仅对名为 openai 的 provider 启用远程压缩）。

注意：不启用时走本地压缩，效果相同，但会占用更多本地 token。

验证

codex "用一句话介绍你自己"

能正常回复即接入成功。若报 401，检查密钥；若提示模型不存在，用以下命令查看可用模型 id 并同步修改 model：

curl https://ai.liangfeng.net.cn/v1/models \
  -H "Authorization: Bearer sk-你的密钥"

常见问题

12 / SCRIPTS

以下脚本用于快速完成接入配置；运行前请先创建 API 密钥。脚本会写入或合并配置文件，并在修改前自动备份原文件。

说明：configure-opencode.* 对应 OpenCode 接入；configure-codex-ccswitch.ps1 对应 Codex + CC Switch 接入。也可以不使用脚本，按教程手动配置。