若干更新迭代

2026-10-02 19:56:32 +08:00
1 parent deb9cc5bcf
commit 4ac786aafb
@@ -80,14 +80,20 @@ curl -X POST https://你的域名/api/v1/jobs \
 | capability | 说明 |
 | --- | --- |
 | `image.generate` | 图片生成 |
-| `video.generate` | Seedance 视频生成 |
+| `video.generate` | Seedance、百炼、MiniMax 视频生成 |

 ## 计费说明

-开放 API 仍按 API Key 和账号分区运行。当前未绑定组织的开放 API 任务保持兼容，不从组织钱包扣费；平台浏览器用户的真实图片/视频任务会按超级管理员配置的服务商标准单价、计费单位和上浮倍率，从所属组织余额冻结。普通用户余额不足时不会提交服务商并返回余额不足错误；超级管理员仍保存计算费用，但不检查、冻结或扣减组织额度，也不产生钱包扣费、退款流水。计费规则与最终金额会随任务保存，任务失败、取消或过期后由 Worker 在最终终态退款；Seedance 成功后按 `usage.completion_tokens` 多退少补，缺少该字段时保留冻结金额。
+开放 API 仍按 API Key 和账号分区运行。当前未绑定组织的开放 API 任务保持兼容，不从组织钱包扣费；平台浏览器用户的真实图片/视频任务会按超级管理员配置的服务商标准单价、计费单位和上浮倍率，从所属组织余额冻结。普通用户余额不足时不会提交服务商并返回余额不足错误；超级管理员仍保存计算费用，但不检查、冻结或扣减组织额度，也不产生钱包扣费、退款流水。计费规则与最终金额会随任务保存，任务失败、取消或过期后由 Worker 在最终终态退款；Seedance 成功后按 `usage.completion_tokens` 多退少补，缺少该字段时保留冻结金额。MiniMax H3 按实际输出秒数及输入图片数结算；Wan 3.0 按 `usage.output_video_duration` 的实际时长结算（无视频输入时可回退 `usage.duration`），缺少有效用量时保留预扣并标记为估算。

 组织余额当前只能由超级管理员通过 `/billing` 的“余额与上账”直接入账。所有充值和人工余额调整都只记入组织账本，不存在个人上账归属；组织管理员和员工共同使用组织额度。未来接入支付时，支付成功回调应使用同一幂等上账逻辑自动入账，不产生待审核申请。余额不足时，平台会拒绝创建真实计费任务并返回错误；未配置真实服务商凭据时也不会生成占位结果。

+创作页通过 `GET /api/billing/balance` 展示当前组织的可用余额。接口仅接受平台会话认证，从服务端刷新后的会话确定组织，忽略客户端组织参数，返回 `organization` 和 `wallet`，不加载账本或价格目录，并设置 `Cache-Control: no-store`。未绑定组织返回 422。页面支持手动刷新，并在提交任务、任务计费状态变化、重新切回页面及可见状态下每 30 秒刷新；超级管理员显示“超管不计额度”。余额提示供用户参考，实际扣费及余额校验仍由服务端执行。
+
+生成失败原因统一由 Go 后端处理，覆盖 Seedance、Seedream、百炼、MiniMax、EvoLink 和即梦视觉服务。`job.error.message` 返回中文原因和处理建议；已知错误码优先于 HTTP 状态，未识别的明确拒绝显示通用说明，不能臆测为真人审核或余额不足。提交失败不自动重新提交；网络中断、无效响应等无法确认服务商是否收到请求时保留防重复提交提示。已知服务商任务的临时查询错误可以继续查询，始终保留 `providerTaskId`。
+
+平台超级管理员和组织管理员可在任务详情展开“错误详情”，查看 `responsePayload.providerError` 中实际存在的 `phase`、`status`、`code`、`requestId` 和经过脱敏、限长的 `detail`。普通用户及公开 API 不返回该诊断对象；失败任务的原始响应也不会向他们返回，成功任务的结果、用量和图层数据不受影响。新失败任务只持久化安全诊断，不保存原始失败响应。旧任务若已经丢失具体错误码，不能据此恢复原因，需要查询当时的服务日志。
+
 首次加载超管计费中心或提交真实任务时会自动补齐内置标准成本目录，默认倍率为 `1.2×`，已有同服务商/能力/模型/变体规则会同步平台维护的标准成本与参数档案，但保留已配置倍率。视频规则按分辨率匹配 `resolution=480p|720p|1080p|4k`；参数化规则按服务下的参数维度选择档位，标准成本为基础成本乘以各档位系数，组合倍率取所选档位中的最高倍率；最终金额使用整数分并向上取整。EvoLink 默认按固定 `1 USD = 7.20 CNY` 换算，并列出质量、分辨率、画面比例和参考图数量档位；即梦 4.6 使用公开资源包折算值作为平台维护的参考标准，实时价格以火山控制台为准。超级管理员只调整倍率，标准成本和参数档案不通过后台修改。

 ### 后台统一调整倍率
@@ -235,8 +241,11 @@ Flare 与 Sunburst 各有独立价格规则。按固定汇率 7.2，1K 基础输
 ```json
 {
  "capability": "video.generate",
-  "prompt": "生成一条 9:16 品牌短视频，节奏明快，适合信息流投放",
+  "engine": "bailian",
+  "model": "wan3.0-video",
+  "prompt": "以图1的商品为主体，采用图2的场景，生成一条品牌短视频",
  "settings": {
+    "inputMode": "reference",
    "ratio": "9:16",
    "duration": 5,
    "resolution": "720p"
@@ -246,16 +255,33 @@ Flare 与 Sunburst 各有独立价格规则。按固定汇率 7.2，1K 基础输
      "type": "image",
      "url": "https://example.com/product.png",
      "label": "@图片1"
+    },
+    {
+      "type": "image",
+      "url": "https://example.com/scene.png",
+      "label": "@图片2"
    }
  ]
 }
 ```

-视频参数限制：
+视频模型和素材限制：

- `duration`：`4` 到 `15` 秒
- `ratio`：`16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`
- `resolution`：`480p`、`720p`、`1080p`、`4k`
+| engine / model | 素材模式 | 输入限制 | 时长 / 分辨率 |
+| --- | --- | --- | --- |
+| `seedance` / `doubao-seedance-2-0-260128` | `reference` | 最多 9 图、3 视频、3 音频；音频须搭配图片或视频 | 4–15 秒或 `-1` 自动；480p/720p/1080p |
+| `seedance` / `doubao-seedance-2-5-260628` | `reference` | 最多 30 图、10 视频、10 音频，合计 50 个 | 4–30 秒或 `-1` 自动；480p/720p/1080p |
+| `bailian` / `wan2.7-i2v-2026-04-25` | `frames` | 1–2 张图片，依次为首帧、尾帧 | 2–15 秒；720p/1080p |
+| `bailian` / `wan3.0-video` | `reference` 或 `frames` | 参考模式最多 10 张图片，可不传图；首尾帧模式 1–2 张图片 | 2–30 秒；480p/720p/1080p |
+| `minimax` / `MiniMax-H3` | `reference` 或 `frames` | 参考模式最多 9 张图片；首帧模式最多 1 张图片；不传图为文生视频 | 4–15 秒；768P/2K |
+
+`settings.inputMode` 省略时，旧百炼及 MiniMax 请求继续使用 `frames`，Wan 3.0 和 Seedance 使用 `reference`。`model` 按引擎校验，不能跨服务商混用。模型、模式和素材顺序保存在任务请求中，报价与提交使用同一份参数。
+
+`ratio` 支持 `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9`、`adaptive`；Wan 2.7 由输入图片确定画幅。MiniMax 首帧模式有图时使用 `adaptive`，多图参考可选择画幅，但文生视频不接受 `adaptive`。参考模式不会将第一张图固定为视频开头；首尾帧和多图参考不能在同一次请求中混用。
+
+Wan 3.0 本次仅开放文字和图片输入，不接受视频、音频或文档。图片须为 JPG/PNG/BMP/WEBP、单张不超过 20 MB、宽高均为 240–8000 像素，PNG 不可透明；MiniMax 图片须为 JPG/JPEG/PNG/WEBP/HEIC/HEIF、单张不超过 30 MB、宽高均为 256–5760 像素、长宽比 0.4–2.5。远程 URL 的真实文件由服务商校验，数量和类型在平台提交前校验。
+
+MiniMax 的实际结算已支持输入图数；预估与预扣也计入第 6 张起的图片费用。Wan 3.0 使用独立的分辨率价格规则，480P/720P/1080P 标准价分别为 ¥0.30/¥0.60/¥1.20 每秒，按官网原价维护，不计限时折扣（来源：[百炼模型价格](https://help.aliyun.com/zh/model-studio/model-pricing)，核对日期 2026-10-01）。参考图片不单独收费；可继续通过价格目录统一调整倍率，再单独覆盖某个模型。相关接口依据：[MiniMax H3](https://platform.minimax.io/docs/api-reference/video-generation-v2-create)、[Wan 3.0](https://help.aliyun.com/zh/model-studio/wan3-video-generation-api-reference)、[Seedance](https://docs.volcengine.com/docs/ark/create-video-generation-task-api?lang=zh)。

 ## 幂等