系统设置详细配置

什么是易支付

易支付是聚合支付宝、微信等渠道的第三方收银台。用户充值时通过 `POST /api/user/pay` 获取表单字段，浏览器 POST 至易支付网关完成付款，异步回调更新额度。

易支付配置

填写支付地址、商户 ID/密钥与回调地址；保存后可在钱包页验证 `GET /api/user/recharge/info` 是否返回 pay_methods。

Stripe 配置

在支付设置 Tab 配置 Stripe Secret Key、Webhook Secret 等；用户充值走 `POST /api/user/stripe/pay` 跳转 Checkout。

其他支付方式

支持 Creem 等渠道（取决于 option 开关）；各渠道最低充值与回调路径以接口返回为准。

充值方式设置

通过 JSON 自定义前端展示的充值方式按钮（name、color、type），映射到易支付 type 参数。

字段说明

见下方「易支付参数」与「服务器地址」表格；修改密钥后需重新测试一笔小额充值。

充值金额配置

配置固定档位（如 10/50/100 USD）或允许自定义金额；与 MinTopUp、Price 共同约束用户输入。

自定义充值金额选项

开启后钱包页展示任意金额输入框；关闭则仅展示预设档位。

充值优惠

可按分组配置充值赠送比例（TopUpGroupRatio），如 vip 分组充值 100 美元到账 110 美元等价值额度。

易支付参数

全局限流

在「速率限制设置」Tab 配置全站 QPM/QPD 上限，超限返回 429。适用于保护网关整体容量。

按用户分组限流

为不同 group 设置独立阈值，优先级高于全局限流；未配置的分组沿用全局值。

分组限流配置示例

JSON 示例：`{"default":{"qpm":60},"vip":{"qpm":300}}`。模型级限流可在同 Tab 按 model 名称细化。

倍率体系概述

EasyAPI 通过 model_ratio、completion_ratio、group_ratio、cache_ratio 等组合计算额度消耗；模型元数据与 option 表共同生效。

额度与倍率的关系

用户额度（quota）为统一货币单位；不同模型/分组通过倍率折算为等价值 Token 或次数消耗。

额度计算公式

按量：消耗 ≈ (prompt_tokens × model_ratio + completion_tokens × model_ratio × completion_ratio) × group_ratio × 基准单价；按次：消耗 = model_price × group_ratio。

按量计费（Token）

quota_type = 0；输入与补全 Token 分别计倍率，详见定价文档。

按次计费（固定价格）

quota_type = 1；每次调用扣 model_price，与 Token 数无关。

音频模型（特殊处理）

部分音频模型按时长或字符计费，model_ratio 含义以模型管理配置为准。

预扣费与后扣费机制

预扣费在请求前冻结估算额度，完成后按实际 Token 多退少补；后扣费在响应结束后一次性扣减。

计费类型对照

模型倍率设置

控制各模型输入侧基准倍率（model_ratio）。展示价（美元侧）≈ model_ratio × 2 / 1M Tokens，详见 模型管理。

补全倍率设置

分组倍率设置

分组倍率（group_ratio）决定同一模型在不同令牌分组下的计费折扣，与 分组管理 中的 ratio 字段一致。

{
  "default": 1,
  "vip": 0.8,
  "svip": 0.6,
  "test": 0
}

可视化倍率设置

「倍率设置」Tab 提供表格化编辑，支持搜索、排序与批量保存，无需手写 JSON。Web 控制台正在对接中。

未设置倍率模型

当渠道同步或手动添加带来尚未配置 model_ratio 的模型时，行为由 option accept_unset_model_ratio_model 控制：

• 关闭（默认）：拒绝调用并在日志中提示「模型倍率未设置」，避免误计费。
• 开启：允许调用，按默认倍率 1 或上游返回值计费；适合快速接入新模型后再统一调价。

建议生产环境保持关闭，在「模型管理」或倍率同步完成配置后再开放。

上游倍率同步

从已对接的上游渠道拉取最新 model_ratio，减少手工维护成本。

1. 调用 GET /api/ratio_sync/channels 查看支持同步的渠道列表
2. 选择渠道后调用 POST /api/ratio_sync/fetch 拉取倍率
3. 在可视化表格或 JSON 中核对差异，确认后保存
4. 必要时使用 POST /api/setting/rest_model_ratio 恢复默认倍率

常见问题

配额计算实例

以下示例展示权重计算过程；最终 quota 数值还取决于站点基准单价与展示币种，精确扣费以 使用记录 为准。

聊天应用配置

控制操练场、聊天页默认模型与可见性；保存后影响 `/console/playground` 与演示聊天入口。

聊天集成变量

一键导入 URL 模板中可使用以下占位符，由前端在打开第三方应用时替换为当前用户令牌与站点 API 地址：

• {apiKey} / {token}：当前选中的 EasyAPI 令牌（sk- 开头）
• {baseUrl} / {openAIUrl}：站点 API 基址（NUXT_PUBLIC_API_BASE_URL）
• {openAIBaseUrl}：{baseUrl}/v1，供 OpenAI SDK 兼容客户端使用
• {siteName}：站点名称，用于部分客户端显示标题

聊天应用集成

在令牌管理页「聊天应用集成」区域，支持一键导入至 ChatGPT Next Web、Lobe Chat、OpenCat 等客户端。各应用参数拼接规则见用户指南「聊天应用集成」。

• 导入前需先在令牌页创建并选中目标令牌
• 导入链接在新标签页打开，不会泄露完整 Key 到当前页 URL 历史（部分客户端仍会在 hash 中短暂出现）
• 手动对接时使用 Authorization: Bearer {apiKey} 与 {openAIBaseUrl}

完整步骤见 聊天应用集成 用户指南。

Midjourney 配置

控制 MJ 代理行为、通知与账号过滤；需先在「渠道管理」配置 Midjourney 类型渠道。

绘图计费

Midjourney 等绘图模型通常按次计费（quota_type=1），在模型管理中设置 model_price；分组倍率 group_ratio 同样生效。

• imagine / upscale / variation 等动作各计一次或按模型配置扣费
• 任务提交后先预扣额度，失败任务按网关策略退还
• 用户可在 `/console/tasks` 查看 mj_id、进度与扣费记录
• 详见用户指南「任务中心」与「定价」中的按次计费说明

相关文档： 任务中心、 定价。

看板配置 - 基础设置

控制仪表盘默认时间范围、是否展示额度/请求量等核心指标卡片。

看板配置 - 图表设置

配置折线图/柱状图的数据粒度与展示项，便于运营分析高峰时段与模型分布。

看板配置 - 高级选项

面向 Root/管理员的扩展能力：原始日志导出、跨用户汇总等。

• 数据导出：支持按时间范围导出 CSV（具体字段以控制台为准）
• 管理员视图：可查看全站汇总；普通用户仅看本人数据
• 缓存刷新：修改看板选项后建议清除 CDN/浏览器缓存以立即生效

模型显示设置

影响模型广场 `/models` 与控制台下拉列表的展示内容。

模型行为设置

全局影响 API 网关路由、重试与未配置倍率模型的处理方式。

模型同步设置

从渠道自动发现模型名称并写入模型表；可与倍率同步配合使用。

• 在「渠道管理」启用渠道后，可在模型设置中触发「从渠道同步模型列表」
• 同步仅更新模型名称与元数据，倍率需单独配置或通过 `POST /api/ratio_sync/fetch` 拉取
• 模型映射（model_mapping）在渠道级配置，不在本 Tab 重复维护

渠道与模型列表维护见 渠道管理、 模型管理。

基础运营配置

控制新用户注册、初始额度与站点运营模式。

充值配置

与支付 Tab 联动，控制钱包页 `/console/wallet` 充值能力。

兑换码配置

控制用户自助兑换与管理端批量发码能力。

• 管理端批量生成见「兑换码管理」文档（管理 API：`/api/redeem_codes`）
• 用户兑换入口：`/console/wallet`，接口 `POST /api/user/redeem`

管理端操作见 兑换码管理。

首页配置

营销首页与落地页内容，公开接口只读返回。

其他功能配置

OAuth、通知、页脚等杂项；详细 OAuth 提供商见「自定义 OAuth」文档（若已启用）。