计费与点数

本平台采用预付费点数：账户余额以「点数」计价，充值由我们线下人工完成（无在线支付）。每次生成按能力/模板的点数价扣费。

扣费规则

• 提交任务时冻结该任务的点数（余额不足则创建失败，返回 402 insufficient_balance，不产生任务、不占用 Idempotency-Key）。
• 任务成功时结算，正式扣除冻结的点数。
• 任务失败、超时时全额退还冻结点数——包括需要两阶段生成的视频，任一阶段失败都全额退还。

任务对象中的 cost 字段即本次任务的点数（成功后实际扣除的数量）。

查询余额与价格

• 点数价随模板返回，见「模板列表」的 price 字段：

GET /v1/templates?capability=image.pose

{
  "data": [
    { "id": "pose_office", "name": "办公室", "price": 30, "cover_url": null }
  ]
}

• 视频模板还会返回时长与各时长的实际点数价 duration_prices：

{
  "data": [
    {
      "id": "video_ltx_dance",
      "name": "跳舞",
      "price": 100,
      "duration_adjustable": true,
      "min_duration": 5,
      "max_duration": 15,
      "duration_prices": { "5": 100, "6": 120, "7": 130, "8": 140 }
    }
  ]
}

视频时长与价格

• 固定时长模板（duration_adjustable: false）：一口价 price，请求中的 duration 会被忽略。
• 可调时长模板（duration_adjustable: true）：可在创建任务时传 duration（min_duration–max_duration 秒）。该时长的实际点数价直接查 duration_prices[duration]（每个时长独立定价，未单独定价的时长按系统默认价）。

例如上表 video_ltx_dance 生成 8 秒 = duration_prices["8"] = 140 点。

余额不足

创建任务时余额不足会返回：

{
  "error": { "code": "insufficient_balance", "message": "点数不足，请联系管理员充值", "request_id": "req_..." }
}

此时任务不会创建，Idempotency-Key 也不会被占用，充值后可用同一个键重新提交。