01
LIANGBAN API / QUICKSTART
把一个 API Key，
接入你常用的 AI 工具。
凉拌API提供统一的 OpenAI 兼容接口。注册账号、创建密钥，然后把同一套基础参数填进桌面客户端、CLI 或你自己的程序。
01 / FIRST RUN
三步接入
不需要编程基础。能复制粘贴命令，就能完成第一次调用。
02
03
API Key 等同于余额权限。不要截图发群、提交到 Git 仓库或写进前端代码。泄露后立即在密钥页禁用并重新创建。
02 / COMMON SETTINGS
基础参数
所有 OpenAI 兼容客户端都可以先按这张表配置。
| 参数 | 填写内容 | 说明 |
|---|---|---|
| Base URL | https://api.600318.xyz/v1 | 大多数客户端只需要填到 /v1 |
| API Key | sk-你的密钥 | 请求头格式为 Authorization: Bearer <Key> |
| Model | <model-id> | 复制模型广场显示的完整 ID，不要凭感觉改名 |
| 流式输出 | stream: true | 需要逐字输出时开启；排错时可先关闭 |
03 / DESKTOP CLIENTS
桌面工具
先配置一个通用客户端，最容易验证 Key、模型和余额是否正常。
C推荐入门
Cherry Studio
新建一个 OpenAI 兼容供应商，适合聊天、文件和多模型切换。
- 设置 → 模型服务 → 添加「OpenAI」或「OpenAI Compatible」。
- API 地址填
https://api.600318.xyz/v1。 - 粘贴 Key，点击模型列表刷新，选择控制台可用模型。
BChat Completions
ChatBox
在自定义 API / OpenAI 兼容服务中填入以下三项：
API Host
https://api.600318.xyz/v1API Key
sk-你的密钥Model
控制台可用模型 ID如果出现模型列表为空，先手动填入完整模型 ID 再发送一条短消息。
⌘可选总控
CC Switch
用它集中管理 Codex CLI 等命令行工具的供应商。API 密钥页如果出现「导入到 CCS」，可以直接使用。
一工具一 Key切换供应商不改环境变量先配置 Codex，再扩展其他 CLI
了解 CC Switch04 / CLI & SDK
命令行工具
把 Key 放进环境变量，避免写入配置文件或 Shell 历史。
A
Codex CLI 使用 Responses
在 Codex 配置里声明一个 OpenAI Responses 供应商，Key 通过环境变量注入。
model_provider = "liangban"
model = "<model-id>"
[model_providers.liangban]
name = "凉拌API"
base_url = "https://api.600318.xyz/v1"
wire_api = "responses"
env_key = "LIANGBAN_API_KEY"配置后，在当前终端设置 LIANGBAN_API_KEY，重新启动 Codex CLI。模型名必须是控制台可用的完整 ID。
B
OpenCode 使用 OpenAI Compatible
把下面的 provider 合并到你的 opencode.json，并按需补充模型对象。
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"liangban": {
"npm": "@ai-sdk/openai-compatible",
"name": "凉拌API",
"options": {
"baseURL": "https://api.600318.xyz/v1",
"apiKey": "{env:LIANGBAN_API_KEY}"
},
"models": {
"<model-id>": { "name": "<model-id>" }
}
}
}
}如果你的 OpenCode 版本配置结构不同，以本机版本提示为准；核心只需要保持 Base URL、Key 和模型 ID 三项一致。
C
环境变量写法
把密钥保存到用户环境变量，程序配置只引用变量名。
# Windows PowerShell（当前终端）
$env:LIANGBAN_API_KEY = "sk-你的密钥"
# macOS / Linux（当前终端）
export LIANGBAN_API_KEY="sk-你的密钥"不要把真实 Key 写进这个文档、前端 JavaScript、公开仓库或截图。这里只展示占位符。
05 / PROTOCOL ADAPTER
Claude Code
Claude Code 默认使用 Anthropic 协议；如控制台没有原生 Anthropic 路由，需要本机协议适配器。
✦
LiteLLM Proxy 路径
Claude Code → 本机代理 → 凉拌API OpenAI 兼容接口先确认你的凉拌API账号能用目标模型，再启动本机 LiteLLM。LiteLLM 对 Claude Code 暴露 Anthropic 风格接口，内部把请求转成 OpenAI Chat Completions。
1安装 LiteLLM2写入模型映射3让 Claude Code 指向 127.0.0.1:4000
查看 LiteLLM 文档model_list:
- model_name: claude-compatible
litellm_params:
model: openai/<model-id>
api_base: https://api.600318.xyz/v1
api_key: os.environ/LIANGBAN_API_KEY
litellm_settings:
drop_params: true这是协议转换示意，字段以你安装的 LiteLLM 版本为准。Claude Code 侧使用本机代理地址，不要把远程 Key 写进客户端配置。
如果你只需要普通对话或代码补全，优先选择 Cherry Studio、OpenCode 或 Codex CLI，排错路径更短。Claude Code 适配器涉及额外进程和端口，建议确认 OpenAI 兼容调用成功后再配置。
06 / API REFERENCE
接口示例
下面的请求只使用占位 Key。替换模型 ID 后，可直接在本机终端验证路由。
POST
/v1/chat/completions通用聊天与流式输出POST
/v1/responsesCodex / Responses 客户端AUTH
Bearer sk-...所有请求都需要认证curl https://api.600318.xyz/v1/chat/completions \
-H "Authorization: Bearer $LIANGBAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<model-id>",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.LIANGBAN_API_KEY,
baseURL: "https://api.600318.xyz/v1"
});
const result = await client.chat.completions.create({
model: "<model-id>",
messages: [{ role: "user", content: "你好" }]
});
console.log(result.choices[0].message.content);07 / TROUBLESHOOTING
排错与安全
先看错误码，再去控制台「使用日志」确认请求有没有抵达网关。
401Unauthorized / Invalid API key
检查请求头是否为 Authorization: Bearer sk-...，确认没有多写一层 Bearer、换行或空格；再确认 Key 未被禁用且余额可用。
403Forbidden / 无权限
常见原因是账号、Key 分组或模型权限不匹配。打开控制台模型页，使用当前 Key 确实可见的模型 ID；管理员路径不要当作普通 API 路径调用。
429Too Many Requests
降低并发、等待后重试，并检查余额或限流提示。重度并发可以按工具拆分 Key，但不要用脚本无间隔重放请求。
5xx上游或网关异常
先用一个短请求和 stream: false 复现，再查看调用日志。记录时间、端点、模型和 request id，便于定位；不要在没有退避的情况下循环重试。
ModelModel not found
不要猜模型名。进入「模型广场」或控制台可用模型列表，复制完整 ID；模型上下线或权限变化后，旧配置可能仍保留在客户端里。
安全如何管理 Key？
每个应用单独一枚 Key，放环境变量，限制分享范围；定期检查使用日志。任何泄露都按“立即禁用旧 Key → 创建新 Key → 更新客户端”的顺序处理。