开发文档

快速开始

三步跑通第一条请求，示例用 OpenAI 协议。

1. 创建 API Key

在控制台「API 令牌」新建 Key 并选择渠道，渠道决定它能调哪个模型家族。

2. 发出第一条请求

把 model 换成你 Key 所在渠道里的模型。

curl https://api.lai.vc/chat/completions \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.6-sol", "messages": [{"role": "user", "content": "你好"}]}'

3. 看结果和扣费

控制台「用量日志」逐条列出每次请求的结果、tokens、扣费和耗时。出错时，错误信息末尾会带 request id，排查和提工单都用它。

地址与线路

三条线路

三条线路功能相同、Key 通用，换线路只改域名。线路之间不会自动切换：某条线路异常时，换回 api.lai.vc 即可。拿不准用哪条，打开 lai.vc/netcheck 在自己的浏览器里测一下。

API Key 与渠道

每个请求都在请求头里带 Key：Authorization: Bearer sk-你的Key。

一把 Key 绑定一个渠道

渠道是我们的计价分组，例如「Pro满血官渠」「Max满血官渠」，按模型家族划分。一把 sk- Key 只绑定一个渠道，只能调这个渠道里的模型；调了渠道里没有的模型，会返回 no_available_channel。要用别的家族，在「API 令牌」把 Key 切到对应渠道，或者每个家族各建一把。

余额整个账户共用。Key 只决定能调哪些模型、按哪个渠道的价格扣费。

给 Key 加限制

sk- 与 ak- 是两套

sk- 用于模型调用；ak- 用于图像、视频、音乐接口和 MCP，在控制台「API 与 MCP → 密钥管理」创建。两套互不通用。

Claude Code

只改一个文件：~/.claude/settings.json。重开 Claude Code 生效。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lai.vc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key"
  }
}

变量名是 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY。上面的配置要用绑定 Claude 渠道的 Key。

用其他家族的模型

Claude Code 也能跑 GPT、Grok、DeepSeek、GLM、Kimi 等家族的模型。换成对应渠道的 Key，再把三个默认模型指向这个渠道里的模型，否则 Claude Code 的后台小任务会去找 Claude 的 haiku 模型，报 no_available_channel。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.lai.vc",
    "ANTHROPIC_AUTH_TOKEN": "sk-绑定 DeepSeek 渠道的 Key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4.1-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4.1-flash"
  }
}

Codex CLI

Codex 走 OpenAI 的 Responses 协议。

model = "gpt-5.6-sol"
model_provider = "lai"

[model_providers.lai]
name = "OpenAI"            # 用 OpenAI 这个名字，客户端自动压缩上下文才会生效
base_url = "https://api.lai.vc"
wire_api = "responses"
experimental_bearer_token = "sk-你的Key"

保存后重开 Codex 即可，不用再执行 codex login。桌面版、VS Code 插件读的是同一个文件。

这份配置用 GPT 家族的 Key。DeepSeek 等其他家族也能接：换对应渠道的 Key 和模型名；如果返回 400，在 config.toml 里加一行 model_reasoning_summary = "none"。

DeepSeek dsh

DeepSeek 官方开源的编码 Agent。在它的「自定义模型 API」里接 Lai,三种协议都支持。

先把 Key 写进 ~/.dsh/.env（dsh 每次启动都会读），再写提供商配置，最后启动：

LAI_API_KEY=sk-你的Key

也可以不写文件：启动后在网页里打开「设置 → 模型 → 添加模型提供商 → 自定义模型 API」,填 API 地址、协议、Key 和模型名。地址填 https://api.lai.vc；协议按家族选：Claude 用 Anthropic Messages，其他家族用 OpenAI Chat Completions。

Cursor 与其他客户端

在 Cursor 设置的 Models 页：

其他能填 Base URL 和 API Key 的客户端同理：Base URL 填 https://api.lai.vc，模型名按 Key 所在渠道填。

LaiCode 一键配置

不想手改配置，就让 LaiCode 来：登录后装好并配好 Claude Code、Codex、Grok Build、OpenCode、DeepSeek Harness。

npx @laivc/laicode@latest

• 在浏览器里批准登录，不在命令行输密码。
• 测速选线路，选好 Key 和模型（直接显示实扣单价）。在控制台给 Key 切渠道、换家族之后，运行 laicode sync 让本机跟上。
• 写入前先预览、再备份，比如 ~/.claude/settings.json、~/.codex/config.toml、~/.grok/config.toml；写好后真实调用一次。
• 随时 laicode rollback 撤销；laicode test 验证、laicode doctor 体检、laicode models 查看模型与价格、laicode usage 看近 7 天的花费（按天、按 Key、按模型）。详见 LaiCode 介绍。

用 npx 运行时命令一定带 @latest，npx 会优先用本机缓存的旧版本。Windows 有图形版（测试版），自动准备 Node.js：下载 Windows 版。

CC Switch

在控制台「API 密钥」打开一把 Key 的「接入配置」，选「使用 CC Switch」，点「导入到 Claude Code」或「导入到 Codex」，CC Switch 会弹出确认；导入前可以选线路。

CC Switch 显示的余额来自 GET /user/balance，是账户余额，不是单把 Key 的额度。

模型与价格

下表是各家族主力模型在最便宜渠道的价格，实时读取。完整列表以控制台「模型广场」为准。

Qwen 即将上线。

海外模型按美元计价（平台额度，充值 ¥1 到账 $1），折扣按 ¥7 ≈ $1 折算；国产模型按人民币官方价打折。

查询 Key 能用的模型

GET/models

返回当前 Key 所在渠道里的模型。

curl https://api.lai.vc/models \
  -H "Authorization: Bearer sk-你的Key"

Chat Completions

兼容 OpenAI 的请求与响应结构，大多数 SDK 和客户端直接可用。

POST/chat/completions

其他参数按 OpenAI 规范传；模型不接受的参数会返回 400，错误码见「错误码」。

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "gpt-5.6-sol",
  "choices": [{ "index": 0, "message": { "role": "assistant", "content": "你好！" }, "finish_reason": "stop" }],
  "usage": { "prompt_tokens": 9, "completion_tokens": 3, "total_tokens": 12 }
}

Responses

OpenAI 的新一代接口，Codex CLI 用的就是它。

POST/responses

GPT 家族原生支持；DeepSeek、Kimi 等家族的部分模型也能通过它调用。Claude 模型请用 Messages 或 Chat Completions。

curl https://api.lai.vc/responses \
  -H "Authorization: Bearer sk-你的Key" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.6-sol", "input": "用一句话介绍你自己"}'

Messages

Anthropic 协议。SDK 的地址填 https://api.lai.vc。

POST/messages

Claude 家族原生支持；GPT、Grok、DeepSeek、GLM、Kimi 的模型也能用这个协议调用，Claude Code 接其他家族走的就是它。鉴权用 Authorization: Bearer，对应 SDK 的 auth_token。

curl https://api.lai.vc/messages \
  -H "Authorization: Bearer sk-你的Key" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"model": "claude-sonnet-5-5", "max_tokens": 1024, "messages": [{"role": "user", "content": "你好"}]}'

流式输出

传 stream: true，响应按 SSE 逐块返回，每块是一行 data: {…}，最后一行是 data: [DONE]。想在流里拿到用量，同时传 stream_options: {"include_usage": true}。

stream = client.chat.completions.create(
    model="gpt-5.6-sol",
    messages=[{"role": "user", "content": "写一首四行短诗"}],
    stream=True,
    stream_options={"include_usage": True},
)
for chunk in stream:
    if chunk.choices:
        print(chunk.choices[0].delta.content or "", end="", flush=True)

如果模型在开始输出前就报错，网关返回标准的错误 JSON（HTTP 503 或 429），不会给你一个空的流。

余额查询

GET/user/balance

用任意一把 sk- Key 查询账户余额。

{
  "is_active": true,
  "balance": 62.72,
  "remaining": 62.72,
  "total_used": 37.28,
  "total_granted": 100,
  "currency": "USD"
}

余额是账户余额（美元额度，充值 ¥1 到账 $1），不是单把 Key 的额度。OpenAI 兼容的 /v1/dashboard/billing/subscription 和 /usage 也会返回真实余额，给 CC Switch 这类管理工具用。

概览与密钥

图像、视频、音乐接口走同一个地址，用 ak- 密钥。

每把 ak- 密钥都可以设消费上限、IP 白名单和有效期。给 MCP 或脚本用的密钥，务必设消费上限。

查询余额

GET/v1/account/balance

{
  "account": { "balance_usd": 62.72, "used_total_usd": 1.04 },
  "key": { "name": "…", "limit_usd": 5, "used_usd": 0.1, "remaining_usd": 4.9, "expires_at": null }
}

错误码

图像

curl https://api.lai.vc/v1/images/generations \
  -H "Authorization: Bearer ak-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-image-2-official", "prompt": "晨光穿过玻璃棱镜，在桌面上散成一道彩虹", "aspect": "16:9", "quality": "2k"}'

经 api.lai.vc 同步最长等 90 秒，经 fast.lai.vc / fast-jp.lai.vc 最长 240 秒；超时会返回 processing 和任务号，继续轮询即可，不要重复提交（会再次计费）。

模型与起价

视频

curl https://api.lai.vc/v1/videos/generations \
  -H "Authorization: Bearer ak-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "seedance-2.0-mini", "prompt": "一架纸飞机掠过平静的蓝色海面，电影感", "mode": "text"}'

视频通常要 2–10 分钟，建议走异步，每隔几秒查询一次。mode 取 text（文生）、frame（首帧或首尾帧）、ref（参考图）；duration、resolution、aspect 必须在该模型支持的范围里，否则直接返回 400，不会换档后扣费。

模型与起价

音乐

curl https://api.lai.vc/v1/music/generations \
  -H "Authorization: Bearer ak-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model": "suno6", "prompt": "温暖的 lo-fi，钢琴与轻鼓，适合写代码时听", "action": "auto", "instrumental": true}'

一次生成出 2 首，按次计费，通常 1–3 分钟。action 用 auto（只给风格描述）或 custom（带 lyrics 歌词）；title 传了就用作歌名。

模型与价格

MCP

装上 @laivc/mcp，Claude Code、Codex 等编程工具就能自己生图、生视频、生音乐。

claude mcp add laivc --env LAIVC_API_KEY=ak-你的密钥 -- npx -y @laivc/mcp

装好后，AI 会自己查价目、选档位、提交任务、等结果，返回作品链接。共 11 个工具，覆盖图像、视频、音乐和余额查询；不指定参数时默认用最便宜的档。想走香港直连，加环境变量 LAIVC_BASE_URL=https://fast.lai.vc。

计费规则

• 充值 ¥1 到账 $1 平台额度，按量扣费，没有月费。
• 单价 = 官方价 × 渠道倍率。控制台「模型广场」和上面「模型与价格」里标的，就是实际扣费的单价。
• 折扣口径：海外模型（GPT、Claude、Grok、Gemini）按 ¥7 ≈ $1 折算，折扣 = 倍率 ÷ 7 × 10，例如倍率 0.26 约等于 0.37 折；国产模型按人民币官方价，折扣 = 倍率 × 10。
• 长上下文：GPT 单次上下文超过 272K 时输入 ×2、输出 ×1.5；Grok 超过 200K 时全部 ×2。
• DeepSeek V4.1 Flash 在工作日 9:00-12:00、14:00-18:00（北京时间）按忙时价计费，其余时段按闲时价。

充值

目前支持微信支付、支付宝，单笔 ¥1–¥5000，即时到账。充值码在 lai.vc/redeem 兑换。新账号第一次进入控制台，送 $1 试用额度。

用量与账单

失败和中断的请求也会出现在「用量日志」里。时间一律按北京时间显示。

重试与线路切换

每一次请求都会记录结果和耗时（不保存对话内容）。错误信息末尾的 request id 能对上这条记录。

错误码

错误统一是 OpenAI 风格的 JSON。message 是中英双语，末尾带 request id。

{
  "error": {
    "message": "请求缺少 model 字段。 · Missing required field: model. (request id: 2026…abc)",
    "type": "invalid_request_error",
    "code": "model_required"
  }
}

获取帮助

• 一直报错：在「用量日志」找到那条请求的 request id，到控制台「工单客服」提交。
• 价格、接入、报错的一般问题：直接问 AI 客服来来。
• 线路是否正常：lai.vc/netcheck 在你的浏览器里实测三条线路。