feat: add local auth billing and usage management
This commit is contained in:
35
docs/API.md
35
docs/API.md
@@ -86,10 +86,16 @@ curl -X POST https://你的域名/api/v1/jobs \
|
||||
| capability | 说明 |
|
||||
| --- | --- |
|
||||
| `image.generate` | 图片生成 |
|
||||
| `image.inpaint` | 局部重绘 |
|
||||
| `image.upscale` | 智能超清 |
|
||||
| `video.generate` | Seedance 视频生成 |
|
||||
|
||||
## 计费说明
|
||||
|
||||
开放 API 仍按 API Key 和账号分区运行。当前未绑定组织的开放 API 任务保持兼容,不从组织钱包扣费;平台浏览器用户的真实图片/视频任务会按超级管理员配置的服务商标准单价、计费单位和上浮倍率,从所属组织余额冻结。普通用户余额不足时不会提交服务商并返回余额不足错误;超级管理员仍保存计算费用,但不检查、冻结或扣减组织额度,也不产生钱包扣费、退款流水。计费规则与最终金额会随任务保存,任务失败、取消或过期后由 Worker 在最终终态退款;Seedance 成功后按 `usage.completion_tokens` 多退少补,缺少该字段时保留冻结金额。
|
||||
|
||||
组织余额当前只能由超级管理员通过 `/billing` 的“余额与上账”直接入账。所有充值和人工余额调整都只记入组织账本,不存在个人上账归属;组织管理员和员工共同使用组织额度。未来接入支付时,支付成功回调应使用同一幂等上账逻辑自动入账,不产生待审核申请。余额不足时,平台会拒绝创建真实计费任务并返回错误;Mock 任务免计费。
|
||||
|
||||
首次加载超管计费中心或提交真实任务时会自动补齐内置标准成本目录,默认倍率为 `1.2×`,已有同服务商/能力/模型/变体规则会同步平台维护的标准成本与参数档案,但保留已配置倍率。视频规则按分辨率匹配 `resolution=480p|720p|1080p|4k`;参数化规则按服务下的参数维度选择档位,标准成本为基础成本乘以各档位系数,组合倍率取所选档位中的最高倍率;最终金额使用整数分并向上取整。EvoLink 默认按固定 `1 USD = 7.20 CNY` 换算,并列出质量、分辨率、画面比例和参考图数量档位;即梦 4.6 使用公开资源包折算值作为平台维护的参考标准,实时价格以火山控制台为准。超级管理员只调整倍率,标准成本和参数档案不通过后台修改。
|
||||
|
||||
## 查询任务
|
||||
|
||||
查询单个任务:
|
||||
@@ -194,29 +200,6 @@ curl -X POST https://你的域名/api/v1/assets \
|
||||
|
||||
图片生成参数会按当前引擎生效:即梦使用 `scale` 控制文本影响,EvoLink 使用 `quality` 控制生成质量。
|
||||
|
||||
智能超清:
|
||||
|
||||
```json
|
||||
{
|
||||
"capability": "image.upscale",
|
||||
"imageUrls": ["https://example.com/input.png"],
|
||||
"resolution": "4k"
|
||||
}
|
||||
```
|
||||
|
||||
局部重绘:
|
||||
|
||||
```json
|
||||
{
|
||||
"capability": "image.inpaint",
|
||||
"prompt": "把选中区域文字替换成新品上市",
|
||||
"imageUrls": [
|
||||
"https://example.com/original.png",
|
||||
"https://example.com/mask.png"
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
## 视频任务示例
|
||||
|
||||
```json
|
||||
@@ -242,7 +225,7 @@ curl -X POST https://你的域名/api/v1/assets \
|
||||
|
||||
- `duration`:`4` 到 `15` 秒
|
||||
- `ratio`:`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`
|
||||
- `resolution`:`480p`、`720p`、`1080p`
|
||||
- `resolution`:`480p`、`720p`、`1080p`、`4k`
|
||||
|
||||
## 幂等
|
||||
|
||||
|
||||
Reference in New Issue
Block a user