production runtime and mock removal
This commit is contained in:
inman committed
1 parent
2ef3da7af5
commit
6480e503eb
55 files changed
+581
-540
No files matched your search
@@ -118,11 +118,11 @@ https://你的域名/api/auth/callback
|
||||
|
||||
## 账号、组织用量与计费
|
||||
|
||||
平台用量页统计登录用户使用真实服务商后成功完成的任务；失败、取消、过期、Mock 和开放 API 客户端任务不会计入。普通用户点击页头账号 ID 查看快捷周期和最近记录；管理员通过 `/usage` 按日期、组织、账号、功能类型和服务商查看汇总、趋势及明细。
|
||||
平台用量页统计登录用户使用真实服务商后成功完成的任务；失败、取消、过期和开放 API 客户端任务不会计入。普通用户点击页头账号 ID 查看快捷周期和最近记录；管理员通过 `/usage` 按日期、组织、账号、功能类型和服务商查看汇总、趋势及明细。
|
||||
|
||||
计费目录由平台维护各接口的标准成本与参数档案，超级管理员只调整上浮倍率。真实生成任务提交时按“基础标准成本 × 参数档位系数 × 任务数量 × 组合倍率”报价并从组织余额冻结，单价、参数、倍率、数量和最终金额会快照到任务；每个任务在创作结果和历史任务中显示扣费状态。普通用户余额不足时会被拒绝提交并提示“余额不足，请先充值”，不会提交服务商；超级管理员仍计算并记录生成费用，但不检查或扣减组织额度，也不产生钱包扣费、退款流水。Seedance 成功后按上游 `usage.completion_tokens` 重新结算，多退少补；没有返回用量时保留冻结金额。组织成员通过 `/billing` 查看组织余额、自己的消耗和账务流水，余额属于组织而不是个人；充值和人工余额调整也只记入组织账本，不设置个人上账归属。
|
||||
|
||||
当前组织余额由超级管理员直接上账，充值和人工余额调整不选择个人归属；未来接入用户自主支付时，支付成功回调自动入账，不设置人工审核队列。余额不足或未配置对应计费规则时，真实生成任务不会提交给服务商；本地 Mock 任务免计费。未绑定组织的开放 API 任务暂保持兼容，不纳入组织余额扣费。
|
||||
当前组织余额由超级管理员直接上账，充值和人工余额调整不选择个人归属；未来接入用户自主支付时，支付成功回调自动入账，不设置人工审核队列。余额不足或未配置对应计费规则时，真实生成任务不会提交给服务商。未绑定组织的开放 API 任务暂保持兼容，不纳入组织余额扣费。
|
||||
|
||||
系统首次打开超管计费中心或提交真实任务时会自动补齐平台标准价格目录，不覆盖已有目录。当前默认目录为：百炼 `wan2.7-image-pro` ¥0.50/张，百炼 `wan2.7-i2v-2026-04-25` 720P ¥0.60/秒、1080P ¥1.00/秒；火山方舟 `doubao-seedance-2-0-260128` 480P/720P/1080P/4K 分别为 ¥0.46/秒、¥0.99/秒、¥2.48/秒、¥5.05/秒；EvoLink `gpt-image-2` medium/1K/1:1/无参考图基础估算 ¥0.34/张（固定汇率 1 USD = 7.20 CNY），并列出质量、分辨率、画面比例和参考图数量档位；即梦 `jimeng_seedream46_cvtob` 暂按公开资源包折算参考 ¥0.20/张，官方实时计费以控制台为准。参数化报价按基础成本乘以所选参数档位系数，组合倍率取所选档位中的最高倍率；超管只在 `/billing` 调整倍率，标准成本和参数档案由平台维护。
|
||||
|
||||
@@ -147,7 +147,7 @@ V1 接入图片生成能力：
|
||||
- 提交：`CVSync2AsyncSubmitTask`
|
||||
- 查询：`CVSync2AsyncGetResult`
|
||||
|
||||
未配置火山密钥时，`JIMENG_VISUAL_MOCK=auto` 会自动使用 mock 图，方便先跑通产品流。
|
||||
未配置火山密钥时，服务会明确报告凭据未配置，不会生成占位图片。
|
||||
|
||||
## EvoLink 图片能力
|
||||
|
||||
@@ -157,7 +157,7 @@ V1 接入图片生成能力：
|
||||
- 查询：`GET /v1/tasks/{task_id}`
|
||||
- 默认模型：`gpt-image-2`
|
||||
|
||||
未配置 `EVOLINK_API_KEY` 且 `EVOLINK_MOCK=auto` 时，会自动使用 mock 图。
|
||||
未配置 `EVOLINK_API_KEY` 时，服务会明确报告凭据未配置，不会生成占位图片。
|
||||
|
||||
## AI 生成台与提示词编排
|
||||
|
||||
@@ -171,7 +171,7 @@ V1 接入图片生成能力：
|
||||
- 任务模块：创作页右侧直接展示任务列表，点击任务可查看完整提示词、输入要素、生成参数、状态和结果。
|
||||
- 结果保存：图片和视频生成结果会写入资产记录，并在任务详情和任务卡中提供预览与下载。
|
||||
|
||||
未配置 `SEEDANCE_API_KEY` 时，`SEEDANCE_MOCK=auto` 会自动使用旧模板样片作为 mock 成品，方便先验收工作流。
|
||||
未配置 `SEEDANCE_API_KEY` 时，服务会明确报告凭据未配置，不会生成占位视频。
|
||||
|
||||
## 环境变量
|
||||
|
||||
@@ -214,20 +214,18 @@ cp .env.example .env.local
|
||||
- `EVOLINK_BASE_URL=https://api.evolink.ai`
|
||||
- `EVOLINK_IMAGE_MODEL=gpt-image-2`
|
||||
- `EVOLINK_IMAGE_QUALITY=medium`
|
||||
- `EVOLINK_MOCK=auto`
|
||||
- `SEEDANCE_API_KEY`
|
||||
- `SEEDANCE_BASE_URL`
|
||||
- `SEEDANCE_MODEL`
|
||||
- `SEEDANCE_RATIO`：支持 `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`
|
||||
- `SEEDANCE_DURATION`：Seedance 2.0 支持 `4` 到 `15` 的整数秒，或 `-1` 让模型自动选择
|
||||
- `SEEDANCE_RESOLUTION`：支持 `480p`、`720p`、`1080p`、`4k`；Seedance 2.0 fast 不支持 `1080p`
|
||||
- `SEEDANCE_MOCK`
|
||||
- `ALI_OSS_*`：用于上传素材和生成结果转存
|
||||
- `ZHINIAN_DATA_BACKEND`：生产使用 `postgres`，开发可使用 `local`
|
||||
- `DATABASE_URL`：仅服务端读取的 PostgreSQL 连接串
|
||||
- PostgreSQL 客户端强制使用 `sslmode=disable` 且不读取 CA。ACK 到 RDS 的数据库链路为明文，只应使用 RDS 内网地址，并通过 VPC、安全组和白名单限制访问。
|
||||
|
||||
当 `ZHINIAN_DATA_BACKEND=local` 时，应用使用 `.runtime/data/web-app-state.json` 作为单实例开发数据层。生产 `postgres` 模式缺少连接配置会直接失败，不会静默写入本地 JSON。如果 OSS 未配置，上传和 mock 结果会保存到 `.runtime/uploads` 和 `.runtime/generated-results`，并通过 Go 路由提供访问。
|
||||
当 `ZHINIAN_DATA_BACKEND=local` 时，应用使用进程内单实例开发数据层。生产 `postgres` 模式缺少连接配置或真实服务商凭据会在启动时直接失败，不会静默写入本地数据。如果 OSS 未配置，上传和生成结果会保存到 `.runtime/uploads` 和 `.runtime/generated-results`，并通过 Go 路由提供访问。
|
||||
|
||||
## 数据库
|
||||
|
||||
|
||||
Reference in new issue
Block a user