GET STARTED
三步完成首次请求
先创建令牌，再确认接口地址，最后读取模型列表。
01
创建力量API 令牌
登录力量API 控制台，为当前设备或应用单独创建令牌。建议按用途命名，并设置合适的额度与有效期。
- 打开令牌管理，点击“创建 API Key”。
- 使用清晰名称，例如“个人电脑”“Codex”或“Cherry Studio”。
- 创建后立即复制，并保存到安全的凭据管理工具中。
保护令牌：不要把完整令牌发到聊天、截图、工单或公开仓库。教程中的占位内容必须替换为你自己的令牌。
02
记住接口地址
OpenAI 兼容 SDK 和大多数客户端应填写带 /v1 的地址。
Base URL
https://llxzz.cfd/v1避免重复路径：如果客户端会自动追加
/v1，请填写根地址 https://llxzz.cfd。03
查询可用模型
模型与分组会随账户权限变化。先读取当前令牌实际可用的模型 ID，再用于客户端配置。
Terminal
curl https://llxzz.cfd/v1/models \
-H "Authorization: Bearer $LILIANG_API_KEY"连接成功：响应中出现
data 模型数组，说明 Base URL 与令牌均可用。CLAUDE CODE
接入 Anthropic 兼容接口
使用标准环境变量，不改动 Claude Code 本身。
01
安装 Node.js
Claude Code 需要 Node.js 18 或更高版本。按操作系统安装后检查版本。
macOS · Homebrew
brew install nodeWindows · Winget
winget install OpenJS.NodeJS.LTSUbuntu / Debian
sudo apt update && sudo apt install nodejs npm验证版本
node --version
npm --version02
安装 Claude Code CLI
Terminal
npm install -g @anthropic-ai/claude-code
claude --version03
配置力量API
先在令牌管理创建 API Key，并选择包含目标 Claude 模型的可用分组。
Windows 文件路径：%USERPROFILE%\.claude\settings.json
macOS / Linux 文件路径：~/.claude/settings.json
settings.json
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "粘贴你的力量API令牌",
"ANTHROPIC_BASE_URL": "https://llxzz.cfd"
}
}配置生效：保存文件后完全退出并重新启动 Claude Code。
04
启动 Claude Code
Terminal
cd your-project-folder
claude首次启动：按界面完成主题、安全须知与工作目录信任设置，然后发送一条测试消息。
OPENAI CODEX
配置 Responses API
力量API 已验证支持 /v1/responses 路径。
01
安装 Node.js 22+
macOS · Homebrew
brew install nodeWindows · Winget
winget install OpenJS.NodeJS.LTSUbuntu / Debian
sudo apt update && sudo apt install nodejs npm02
安装 Codex CLI
Terminal
npm install -g @openai/codex@latest
codex --version03
一键接入力量API
推荐 Windows 一键配置
安装器会自动验证令牌、选择可用模型、备份原有配置，并使用 Windows 当前用户的 DPAPI 加密保存令牌；不需要管理员权限。
Windows CMD / PowerShell
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "Invoke-WebRequest 'https://docs.llxzz.cfd/downloads/install-liliang.ps1' -OutFile ([IO.Path]::Combine([IO.Path]::GetTempPath(),'install-liliang.ps1')); & ([IO.Path]::Combine([IO.Path]::GetTempPath(),'install-liliang.ps1'))"- 这条命令可直接粘贴到 CMD、PowerShell 或 Windows Terminal。
- 运行后粘贴力量API令牌；输入过程不会显示在屏幕上。
- 脚本会从
/v1/models自动选择当前令牌可用的 Codex 模型。 - 已有
config.toml会先备份，其他服务商和个性化设置会保留。
安装完成：看到“力量API Codex 配置完成”后，无需再设置环境变量，直接运行
codex。macOS / Linux 手动配置
编辑 ~/.codex/config.toml，模型名请替换为 /v1/models 返回的可用模型 ID。
config.toml
model = "替换为 /v1/models 返回的模型ID"
model_provider = "liliang"
[model_providers.liliang]
name = "力量API"
base_url = "https://llxzz.cfd/v1"
env_key = "LILIANG_API_KEY"
wire_api = "responses"
supports_websockets = falseTerminal
export LILIANG_API_KEY="替换为你的令牌"模型要求：Codex 使用 Responses API，请选择账户中已确认支持 Responses 的模型。
04
启动 Codex
Terminal
cd your-project-folder
codexWindows 用户以后需要更换令牌时，在新终端运行 liliang --reset-key。
配置完成：交互界面能够正常回复，即代表 Codex 已通过力量API 工作。
OPENAI COMPATIBLE
API 与 SDK 调用
统一使用 HTTPS、JSON 与 Bearer Token。
01
基础参数
Base URL
https://llxzz.cfd/v1API Key
在力量API 控制台创建的令牌
认证头
Authorization: Bearer 你的令牌模型
从 GET /v1/models 返回值选择
02
Python 示例
安装 SDK
pip install openaiexample.py
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["LILIANG_API_KEY"],
base_url="https://llxzz.cfd/v1",
)
response = client.responses.create(
model="替换为可用模型ID",
input="你好，请用一句话介绍你自己。",
)
print(response.output_text)03
JavaScript 示例
安装 SDK
npm install openaiexample.mjs
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.LILIANG_API_KEY,
baseURL: "https://llxzz.cfd/v1",
});
const response = await client.responses.create({
model: "替换为可用模型ID",
input: "你好，请用一句话介绍你自己。",
});
console.log(response.output_text);04
原生 cURL 示例
Responses API
curl https://llxzz.cfd/v1/responses \
-H "Authorization: Bearer $LILIANG_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"替换为可用模型ID","input":"你好"}'CC SWITCH
图形化切换供应商
分别为 Claude Code 与 Codex 建立力量API 配置。
01
下载 CC Switch
CC Switch 支持 Windows、macOS 与 Linux，可集中管理 Claude Code、Codex 等工具的连接配置。
官方 Releases
https://github.com/farion1231/cc-switch/releases/latest安装包：Windows 选
.msi，macOS 选 .dmg，Ubuntu / Debian 选 .deb。02
创建专用令牌
- 在力量API 令牌管理点击创建 API Key。
- 按用途命名，并选择包含目标模型的分组。
- 按实际使用量设置额度和到期时间。
- 创建后立即复制令牌；Codex 还应先查询真实模型 ID。
03
添加力量API 供应商
| 工具 | 连接地址 | 配置要点 |
|---|---|---|
| Claude Code | https://llxzz.cfd | 使用 Anthropic 兼容配置与力量API 令牌 |
| Codex | https://llxzz.cfd/v1 | 使用 Responses API 与真实模型 ID |
- 供应商名称填写“力量API”。
- Claude Code 使用不带
/v1的根地址。 - Codex 使用带
/v1的 OpenAI Base URL。
04
启用并验证
- 在主界面选中“力量API”并点击启用。
- 重新启动对应 CLI，进入项目目录运行
claude或codex。 - 发送简单测试请求，确认能获得正常回复。
切换完成：之后可直接从 CC Switch 主界面或系统托盘切换供应商。
CHERRY STUDIO
添加 OpenAI 兼容服务
通过图形界面获取模型并开始对话。
01
下载 Cherry Studio
02
获取 API Key
- 打开力量API 令牌管理并创建 API Key。
- 名称可填写“Cherry Studio”，并选择需要的模型分组。
- 设置额度与有效期后，复制令牌并安全保存。
注意：API Key 相当于账户凭据，请勿发送给他人或放入截图与公开仓库。
03
添加 API 服务商
在 Cherry Studio 设置中进入“模型服务”，新增 OpenAI 或 OpenAI 兼容服务商。
| 设置项 | 填写内容 |
|---|---|
| 服务商名称 | 力量API |
| API 地址 | https://llxzz.cfd/v1 |
| API 密钥 | 你的力量API 令牌 |
| 模型 ID | 从模型列表中获取的真实 ID |
版本差异：如果客户端会自动追加
/v1，API 地址改填 https://llxzz.cfd。点击“检测”或“获取模型”，勾选需要的模型并保存。
04
开始对话
- 返回主界面，选择“力量API”服务商和已启用模型。
- 新建会话并发送测试消息。
- 模型检测成功且消息能正常返回，表示配置完成。
TROUBLESHOOTING
快速定位连接问题
从地址、令牌、模型和协议四个方向依次排查。
01
按顺序检查
- 确认 Base URL 没有写成重复的
/v1/v1。 - 重新复制令牌，排除前后空格、引号或换行。
- 调用
GET https://llxzz.cfd/v1/models，确认令牌和模型 ID。 - 确认客户端选择 OpenAI 兼容协议；Claude Code 使用 Anthropic 兼容配置。
- 新建对话后重试，排除旧会话上下文或客户端缓存。
02
常见状态码
401认证失败
令牌缺失、错误、过期或已禁用。重新复制或创建令牌。
403权限不匹配
模型、分组或 IP 不在令牌允许范围内。检查令牌限制。
429请求过多
触发速率或额度限制。降低并发并检查账户额度。
5xx服务异常
上游暂时不可用或路由异常。稍后重试或切换模型。
03
提交有效信息
寻求协助时，请提供发生时间、客户端及版本、请求路径、模型 ID、HTTP 状态码和响应中的 request ID。
请勿提交：完整 API Key、账号密码、Cookie、私密对话或包含敏感信息的原始日志。