计算生成费用

可下载生成费用API文档，交给 AI 编程助手接入费用预估。

生成前提交模型和生成参数，读取预计消耗、计算公式及候选线路的费用范围。视频费用复用「视频生成」页面的计算方式，包含分辨率、原生/增强画质、参考视频时长折扣和账号价格比例；图片支持按尺寸定价和多张生成。

请求接口

POST /api/platform/generation-cost
Authorization: Bearer sk-你的令牌
Content-Type: application/json

使用站点根地址，无需在路径前加 /v1。使用有效接入密钥，无需浏览器登录或 Cookie。此接口只计算费用，不创建生成任务、不扣费，也不读取远程素材。

curl 'https://your-domain.example/api/platform/generation-cost' \-H 'Authorization: Bearer sk-你的令牌' \-H 'Content-Type: application/json' \-d '{"model":"seedance-2.5","seconds":15,"resolution":"720p","videoQualityMode":"native","videoUrls":["https://your-service.example/input.mp4"],"videoDurations":[14.9]}'

模型值从模型列表获取。只支持图片、视频及对应处理工具，模型能力由服务端目录识别。

请求字段

请求体中仅 model 必填。按秒、分辨率、尺寸或素材时长计费时，需补充对应参数才能获得完整费用；信息不足时返回 estimated: false。

不需要填写提示词。接口从服务端读取价格、默认画质、用户选线偏好及账号倍率，客户端提交的自定义价格或倍率不参与计算。

图片示例：

{"model":"aik-image-2","size":"1024x1024","n":2}

返回结果

以下为计费示意：某线路按每秒 ¥0.85 计费，输出 15 秒、输入 14.9 秒、输入价格比例 50%，预计扣除 ¥19.0825。实际价格和线路 ID 以当前账号返回为准。金额和公式统一使用人民币。

{
  "success": true,
  "data": {
    "model": "seedance-2.5",
    "capability": "video",
    "estimated": true,
    "quota": 9541250,
    "minimum_quota": 9541250,
    "maximum_quota": 9541250,
    "amount": "¥19.0825",
    "formula_lines": [
      "线路 A：输出 15 秒×¥0.85/秒＋参考 14.9 秒×¥0.85/秒×50%＝¥19.0825，预计扣 ¥19.0825"
    ],
    "lines": [
      {
        "line_id": 12,
        "name": "线路 A",
        "quota": 9541250,
        "amount": "¥19.0825",
        "formula_lines": ["输出 15 秒×¥0.85/秒＋参考 14.9 秒×¥0.85/秒×50%＝¥19.0825，预计扣 ¥19.0825"]
      }
    ],
    "balance": "¥1,000.00",
    "note": "费用仅为预估，最终按成功线路、实际生成数量与服务端实测时长结算。"
  }
}

quota 是原始额度，保留用于数值计算。人民币金额按 quota / quota_per_unit × price 换算，参数可通过 /api/platform/status 获取；示例使用 quota_per_unit=500000、price=1。本接口的金额、公式和余额始终使用人民币展示。不要解析 amount 做数值计算。

计费口径与缺失信息

• 自动选线使用账号当前策略和候选范围，排除已知算力不足或暂不可用的线路；指定 lineId 时只计算该线路。
• 按次视频使用一次的价格；图片先按单张额度取整，再乘以 n。
• 按秒视频未开启输入计费时，仅计算向上取整后的输出秒数。开启输入计费时，计算「输出秒数＋参考视频秒数×输入价格比例」，保留小数，最终额度向上取整。
• 处理工具沿用各自的时长口径和页面默认工具档位，不重复累加输入时长；口型对齐按视频与音频较短时长预估。
• 未提供必需的素材时长、价格未配置或没有候选线路时，返回 HTTP 200、estimated: false、quota: null，在公式中说明原因。前端应展示公式及补充信息提示。
• 素材时长由调用方提供，接口不会访问素材 URL。预估不锁价、不保证线路算力或余额足够，最终费用以任务结算和使用记录为准。

错误处理

错误响应包含 success: false 和 message。所有响应禁止缓存。