LemonFly 文档
一个 API Key，接入 Claude 和 GPT 等主流 AI 模型。LemonFly 为你提供稳定的 API 中转、订阅套餐、额度管理与按量付费能力。
LemonFly 是什么
LemonFly 是一个 AI API 订阅服务平台，让你用一个 API Key 就能调用 Claude、GPT 等多种模型。平台负责账号管理、智能调度、负载均衡和计费，你只需关注开发。
- 多模型统一接入 — 一个 Key 调用 Claude Sonnet/Opus、GPT 系列等主流模型
- 智能调度 — 自动选择最优账号，支持粘性会话和故障转移
- 灵活计费 — 订阅套餐 + 按量付费两种模式，按 Key 控额度
核心能力
🔑 一个 Key 通用
同一个 API Key 可调用多种模型，无需为每家上游分别注册账号
📊 精准计费
Token 级别用量追踪，日限额 / 周限额 / 月限额精细控制
⚡ 智能调度
自动选择最优账号，支持粘性会话，保证连续对话体验
🛡️ 并发控制
按用户和账号限制并发数，防止资源滥用
适合谁用
- 想用 Claude Code / Codex CLI 但不想分别开 Anthropic、OpenAI 账户
- 团队共用 AI 工具，希望统一计费、按 Key 控额度
- 需要稳定的 API 中转服务，避免网络不稳定问题
5 分钟接入指南
从注册到第一次 API 调用，只需 5 分钟。
第 1 步：注册账号
访问 注册页面，使用邮箱注册。
第 2 步：选择套餐或充值
进入 定价页面，选择适合你的套餐：
| 套餐 | 价格 | 日限额 | 适合场景 |
|---|---|---|---|
| 入门 Starter | ¥199/30天 | $20 | 每天 2-3 小时开发 |
| 标准 PRO | ¥799/30天 | $60 | 每天 5-7 小时开发 |
| 专业 MAX | ¥2099/30天 | $150 | 高强度 / 团队使用 |
也可以选择按量充值，按实际用量扣费。
第 3 步：创建 API Key
进入 控制台 → API Keys → 创建新 Key。复制保存，后续接入使用。
第 4 步：配置客户端
根据你使用的工具，选择对应的接入方式：
Claude Code
修改 Base URL 和 API Key 即可
Codex CLI
设置环境变量即可
OpenAI SDK
Python / Node.js SDK 直接兼容
验证连接
用 curl 测试：
curl https://你的域名/v1/chat/completions \
-H "Authorization: Bearer sk-你的key" \
-d '{"model":"claude-sonnet-4-20250514","messages":[{"role":"user","content":"Hi"}]}'Claude Code 接入
Claude Code 是 Anthropic 官方的 AI 编程工具。通过 LemonFly 接入，只需修改两个配置。
配置方式
在终端中设置环境变量：
export ANTHROPIC_BASE_URL="https://你的域名"
export ANTHROPIC_API_KEY="sk-你的key"或者在 ~/.bashrc / ~/.zshrc 中持久化。
验证
claude "Hello, 你好"如果正常返回响应，说明接入成功。
可用模型
| 模型 | 说明 | 输入价格 | 输出价格 |
|---|---|---|---|
| claude-sonnet-4-20250514 | 日常开发首选 | $3/M | $15/M |
| claude-opus-4-20250514 | 复杂任务 | $15/M | $75/M |
| claude-haiku-4-20250514 | 快速响应 | $1/M | $5/M |
Codex CLI 接入
OpenAI Codex CLI 是 OpenAI 的命令行编程工具。
配置方式
export OPENAI_BASE_URL="https://你的域名/v1"
export OPENAI_API_KEY="sk-你的key"验证
codex "Hello, 你好"OpenAI SDK 接入
LemonFly 兼容 OpenAI API 格式，可直接使用 OpenAI 官方 SDK。
Python
from openai import OpenAI
client = OpenAI(
base_url="https://你的域名/v1",
api_key="sk-你的key"
)
response = client.chat.completions.create(
model="claude-sonnet-4-20250514",
messages=[{"role": "user", "content": "Hello!"}]
)
print(response.choices[0].message.content)Node.js
import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://你的域名/v1',
apiKey: 'sk-你的key'
});
const response = await client.chat.completions.create({
model: 'claude-sonnet-4-20250514',
messages: [{ role: 'user', content: 'Hello!' }]
});
console.log(response.choices[0].message.content);计费与订阅
两种计费模式
| 模式 | 说明 | 适合场景 |
|---|---|---|
| 订阅套餐 | 按月付费，含日/周/月限额 | 稳定高频使用 |
| 按量充值 | 按实际 Token 用量扣费 | 偶尔使用、弹性调用 |
按量付费价格
| 模型 | 输入 | 输出 |
|---|---|---|
| Opus 4.8 | $15/M | $75/M |
| Sonnet 4.6 | $3/M | $15/M |
| Opus 4.6 | $5/M | $25/M |
| Haiku 4.5 | $1/M | $5/M |
价格单位：每百万 Token (USD)。
额度重置规则
- 日限额：每天 00:00 (UTC+8) 重置
- 周限额：每周一 00:00 (UTC+8) 重置
- 月限额：每月 1 日 00:00 (UTC+8) 重置
API 基础参考
LemonFly 兼容 OpenAI API 格式，支持以下端点：
基础信息
| 项目 | 说明 |
|---|---|
| API 入口 | https://你的域名/v1 |
| 鉴权方式 | Authorization: Bearer YOUR_API_KEY |
| 格式 | OpenAI 兼容 (JSON) |
支持的端点
| 端点 | 方法 | 说明 |
|---|---|---|
/v1/chat/completions | POST | Chat 对话 |
/v1/messages | POST | Claude 原生格式 |
/v1/models | GET | 列出可用模型 |
/v1/images/generations | POST | 图片生成 |
请求示例
curl https://你的域名/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-你的key" \
-d '{
"model": "claude-sonnet-4-20250514",
"messages": [
{"role": "user", "content": "你好"}
],
"stream": true
}'错误排查
401 Unauthorized
API Key 无效或已过期。检查：
- Key 是否正确复制（以
sk-开头） - Key 是否已过期或被禁用
- Header 格式是否正确：
Authorization: Bearer sk-xxx
403 Forbidden
权限不足。检查：
- Key 绑定的分组是否包含目标模型
- 账号是否被禁用
429 Too Many Requests
请求频率超限。检查：
- 是否超出并发限制
- 是否超出日限额 / 周限额 / 月限额
- 稍等片刻后重试
502 / 503 服务不可用
上游服务暂时不可用。平台会自动重试其他账号，如果持续出现请联系管理员。
常见问题
套餐和按量付费有什么区别？
套餐适合稳定高频使用，包含日/周/月限额；按量付费适合低频、临时或需要弹性控制成本的场景。
适合 Claude Code 使用吗？
完全适合。只需设置 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY 环境变量即可。
额度会自动重置吗？
是的。日限额每天、周限额每周一、月限额每月 1 日自动重置。
支持流式输出吗？
支持。在请求中设置 "stream": true 即可使用 SSE 流式输出。
企业或团队能使用吗？
可以。MAX 套餐更适合高强度开发和团队协作场景。管理员可以为不同用户分配不同的 API Key 和额度。
数据安全吗？
LemonFly 作为中转网关，不存储你的对话内容。所有请求实时转发到上游模型服务。