价格与实际费用

使用 GET /v1/pricing 查询当前 API Key 可用的图片和视频费率。响应已包含客户固定价或折扣，以及生效的分组价格。

该接口返回价格目录，不是某次生成请求的报价。它不会预留或锁定价格，也不会根据生成参数估算总费用。

身份验证

查询参数

Seedance 地区版本使用不同的模型 ID。例如，通过 model 查询 seedance-2-5、seedance-2-5-cn 或 seedance-2-5-global。接口没有单独的地区参数。

curl --request GET \
  --url 'https://toapis.com/v1/pricing?model=seedance-2-5' \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "currency": "USD",
  "data": [
    {
      "id": "seedance-2-5",
      "type": "video",
      "prices": [
        {
          "group": "default",
          "conditions": {
            "resolution": "720p",
            "has_video_input": false
          },
          "charge_type": "per_token",
          "price_basis": "total_tokens",
          "unit": "1m_tokens",
          "unit_price": "4"
        }
      ]
    }
  ],
  "has_more": false,
  "next_after": ""
}

以上数值仅用于说明响应结构，请以当前 API Key 实际返回的价格目录为准。

价格字段

价格还可能包含 input_unit_price、input_image_unit_price、free_input_image_count、minimum_charge_usd 或 image_token_prices。分时价格还可能包含 pricing_period、pricing_timezone、pricing_schedule_version 和 pricing_peak_windows。

图片 token 计价中的 image_token_prices 可包含 text_input、cached_text_input、image_input、cached_image_input 和 image_output。每项金额单位均为 USD/100 万 tokens。

目录只返回至少有一个已启用候选渠道与所列条件兼容的价格。该检查不会预留路由，也不会探测渠道实时健康状态。服务无法安全确认完整费率时，模型仍可能返回，但 prices 为空。空数组或缺少某项价格不代表模型免费。

实际费用字段

费用可以确认时，生成响应使用以下对象：

{
  "billing": {
    "status": "settled",
    "credits": "100",
    "cost_usd": "0.5"
  }
}

pending 表示最终金额尚未确认，因此不返回金额字段。refunded 表示已确认净费用为零。缺少整个 billing 对象表示平台无法确认安全的公开值，不代表本次请求免费。

该对象可能出现在：

• 统一图片和视频任务查询 GET /v1/tasks/{task_id}
• 异步图片任务查询 GET /v1/images/generations/{task_id}
• 异步视频任务查询 GET /v1/videos/generations/{task_id}
• 任务 Webhook 的 data.billing
• 兼容的非流式同步图片生成或编辑响应顶层 billing

对于异步任务，任务完成后可将任务查询接口作为获取最终费用的兜底方式。流式图片响应、不支持的供应商响应格式、Playground 请求和延迟批量计费可能不返回该对象。

任务用量字段

图片和视频任务查询在顶层 usage 返回已确认的计费量, 成功 Webhook 在 data.usage 返回同口径字段. 计费量, 模型报告的 token 明细和工具次数可以并存, 按可用性分别返回.

计费量来自本次任务保存的计费记录. 固定计费使用创建时确认的数量, 后置结算使用最终结算数量; 不按当前价格或金额倒推用量. per_request 使用 requests, per_second 使用 output_seconds, per_token 使用 billed_tokens; 输入视频和图片附加项按需返回, 为零时省略.

历史任务若只保存了金额, 未保存可校验的计费数量, 会省略无法确认的字段. 未提供的 token 明细不补零. 按 token 结算后, 视频 token 分项只有在已报告总量与最终计费量一致时才保留. usage 与 billing 的可用性独立, 缺少用量不代表没有扣费, 也不会阻止结果返回. 反之, 返回 charge_type 等计费量时一定同时返回 billing.status=settled 和实际金额. 提交时一次扣清的固定计费任务同样返回 settled. 任务查询和 Webhook 使用同一确认条件和字段取值.

错误

响应使用 Cache-Control: private, no-store。