Seedance 预报价与计费回执

适用于所有生成渠道上的 seedance-2.0、seedance-2.5、seedance-2.0-fast、seedance-2.0-mini。Base URL 为 https://apimaster.ai/v1（https://apimaster.ai/v1）。以下接口均使用 Authorization: Bearer YOUR_API_KEY 鉴权。

获取预报价

POST https://apimaster.ai/v1/videos/quote 接受普通生成请求的 JSON 参数，包括 model、prompt、duration、resolution、video_urls 以及模型支持的其他设置。暂不支持草稿生成、草稿升级及 remix 报价。

curl "https://apimaster.ai/v1/videos/quote" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"seedance-2.0","prompt":"池塘上的小纸船","duration":4,"resolution":"480p","generate_audio":false}'

响应包含 object: "video.quote"、quote_id、expires_at（Unix 秒）、binding: false、funds_reserved: false 和 billing。报价参考有效期五分钟，不扣费、不创建任务、不触发上游生成，billing.reserved_amount 为 "0.000000"。报价编号不是锁价凭证，不需要随生成请求提交。

实际提交时重新确认价格，并冻结任务单价、倍率。估算不是扣费上限，最终费用可能高于或低于估算。自动时长按 30 秒输出估算，requested_output_seconds 为 -1。

生成仍受上游参数校验约束。Seedance 2.5 视频延长请求请显式指定 aspect_ratio: "adaptive"；上游拒绝时按正常退款流程处理。

查询回执

curl "https://apimaster.ai/v1/videos/task_xxx/billing" \
  -H "Authorization: Bearer YOUR_API_KEY"

GET /v1/videos/{task_id}/billing 返回 object: "video.billing_receipt" 和 billing。只有任务所属账户的 API Key 可读取。未知、其他账户及没有新回执的历史任务均返回 HTTP 404；本功能上线后的新任务创建回执，不对历史任务补造账单。

两个查询入口返回同一份明细：GET /v1/videos/{task_id} 的顶层 billing，以及 GET /v1/video/generations/{task_id} 的 data.billing。

settlement_status 为 pending、settled 或 refunded，报价为 estimate。任务完成与资金结算是两个状态，只有 settled／refunded 金额才是最终结果。重复读取不触发生成、结算或退款；最终回执编号和内容保持稳定，退款后仍可读取。

billing 字段

金额和单价均为十进制字符串，时长单位为秒；未确定的可空字段为 JSON null。英文文档 提供逐字段类型表。

字段	含义
schema_version	当前为 "1"
receipt_id、task_id	持久化回执与任务编号；报价没有这些字段
settlement_status	estimate、pending、settled、refunded
model、resolution、tariff_variant	模型、标准化分辨率、计费档位，含视频参考带 -input
tariff_revision	模型、档位、基础单价及计费规则版本的指纹
currency、unit	USD、second
base_unit_rate、effective_unit_rate	基础单价和冻结的最终每秒单价；最终单价保留最多十二位小数
channel_multiplier、account_multiplier	渠道综合价格倍率、账户／分组倍率
requested_output_seconds	请求输出时长；自动为 -1
estimated_output_seconds、estimated_billable_seconds	初始输出估算、输入加输出总计费秒数估算
input_videos	按请求顺序列出的参考视频测量明细
input_videos[].index、.media_id	从零开始的序号、账户范围的媒体哈希或自有素材 ID；不回显来源 URL
input_videos[].measured_seconds	取整前的平台测量时长；旧缓存素材可能为 null
input_videos[].billable_seconds	该参考视频取整后的计费秒数
input_videos[].duration_source	apimaster_probe 或 apimaster_asset_cache
billable_input_video_seconds	各参考视频计费秒数之和
output	成功结算后的输出时长信息，否则为 null
output.actual_seconds	上游报告／平台测量的实际时长；未知为 null
output.billable_seconds	最终采用的输出计费秒数
output.duration_source	provider_reported、apimaster_probe、provider_billable_seconds、requested_duration_fallback、reservation_fallback
billable_seconds	最终输入加输出总计费秒数
rounding	输入、输出、金额取整规则及计算公式
estimated_amount、reserved_amount	初始估算、任务初始预扣；报价预扣为零。预扣是账户扣款，不是银行授权冻结
additional_debit_amount、refunded_amount	初始预扣之外的补扣、从初始预扣退回的金额
final_debit_amount、net_amount	调整后的最终净费用；全额退款为零
initial_quota_units、final_quota_units	精确的初始、最终账户额度单位数
account_unit_usd	每单位 "0.000002" USD
media_charges	image、audio、other_reference 当前为零；input_video_unrounded、output_video_unrounded 分列金额取整前的输入、输出视频费用
final_debit_may_exceed_estimate	当前为 true，估算不是硬性消费上限
created_at、settled_at	Unix 时间戳

复算费用

含参考视频时，视频输入档位单价同时用于输入与输出视频。当前没有独立图片、音频附加费，Token 数和上游成本不参与这四个模型的按秒扣费。

1. 每条参考视频单独向上取整后相加：输入计费秒数 = sum(ceil(每条实际时长))。
2. 输出时长四舍五入到整数秒，正数的半秒向上取整。
3. 输入与输出计费秒数相加。
4. 乘以 effective_unit_rate，除以 account_unit_usd，最后对总额度单位数取整一次，正数的半个单位向上取整。

final_quota_units = round_half_up(billable_seconds × effective_unit_rate / 0.000002)
net_amount = final_quota_units × 0.000002
net_amount = reserved_amount + additional_debit_amount - refunded_amount

请用十进制计算，不要分别对输入、输出金额取整。例如 Seedance 2.0、480P、无参考视频、输出 4 秒，基础单价 0.07031、渠道倍率 1、账户倍率 1.05，最终单价 0.0738255，净费用 0.295302 USD，即 147651 个额度单位。

参考视频时长由 APIMaster 测量，不信任客户端 input_seconds、reference_seconds 等输入时长字段；duration／seconds 指定输出时长。输出优先采用上游报告，缺失时尝试测量生成文件；仍不可用时采用上游计费秒数或请求／预扣时长。回执明确标注来源，不把回退值标成独立测量的实际时长。历史缓存素材或继承旧草稿可能缺少完整逐文件测量明细。

视频响应中的 actual_time 是处理耗时，不是视频时长；usage.completion_tokens 仅供参考。

失败与退款

上游任务失败和当前配置的 24 小时未完成任务超时会自动发起全额退款。退款成功后回执变为 refunded、净费用为零，仍可查询。临时网络／轮询错误不直接退款或取消任务，系统会重试。

提交失败且确认上游未扣费时退还预扣；结果不确定时自动对账，异步首次对账约在 20 分钟后，持续未知超过 24 小时的请求在对账时退款。如果提交未创建公开任务，该次尝试没有任务级回执。报价不冻结资金，无需释放。

当前没有公开 Seedance 取消接口。断开连接或停止轮询不等于取消。任务状态检查防止重复轮询重复结算或退款，回执接口本身只读；这不代表所有基础设施故障下的绝对 exactly-once 保证，pending 不能视为最终结算。