API 文档接口参考

Seedance 2.0 Fast · 报价

报价分为接口报价和前端报价:接口报价由服务端返回当前可用渠道的费用;前端报价读取 models 的价格与计费字段,在用户修改参数时本地计算。

POST/api/v1/quote公开接口 · 无需 API Key
seedance-2.0-fast视频 · ByteDance模型详情与价格

此模型使用的接口

选择供应商可查看其实际参数限制。自动路由会选择支持所传参数的供应商。示例包含默认值和必填输入,请将示例媒体地址替换为可访问的文件。

接口报价

调用 POST /api/v1/quote,Content-Type 为 application/json,无需 API Key,不扣费。适用于视频、图片和音频生成;聊天费用按 Token 用量计算,见下方前端报价。

请求体必填 model(模型 slug)和 input(生成参数对象)。input 按模型声明填写 prompt、duration、resolution、num_images 等字段,与创建生成任务使用相同参数。可选 provider 指定渠道;可选 project 使用项目 ID 解析项目自定义模型名。省略 provider 时查询自动路由候选渠道。

响应 providers 列出可用渠道的 provider、unit、quantity、price_usd、original_price_usd 和 credits,按后端路由顺序排列,第一项是自动路由首选;unavailable 列出被排除的渠道及原因;请求失败或没有可用渠道时处理接口返回的 error。音频按用量计费时返回预留费用,最终按实际用量结算。

前端报价

获取价格:请求 GET /api/v1/models,可用 type 筛选模型类型。普通目录从 data 中选择 model.slug,再从 providers 中选择渠道,读取该渠道的 prices、params、billing。项目目录请求 GET /api/v1/models?project=项目ID,直接读取 data 中模型的这些字段。接口公开读取,无需 API Key;跨域访问项目目录遵守项目域名限制。

价格字段说明

字段含义与用法
prices[].unit计费单位:request 按次,second 按秒,image 按张,kchar 按千字符,input_token / output_token 按百万 Token。
prices[].priceMicros该规则的单价,单位为微美元。1,000,000 微美元 = 1 美元;Token 单价对应一百万 Token。
prices[].conditions价格适用条件,例如分辨率、mode。Token 的 min_input_tokens 表示输入长度档位,缺省为 0。
params所选渠道支持的输入参数。用 type、required、default、options、min/max 等信息校验输入并补默认值。
billing.modelParams模型层的参数定义,先用它校验用户输入。
billing.upstreamParams可选。存在时,最终按这里的参数定义校验并补默认值。
billing.characterBilling可选的字符计费设置:fields 为统计字段,block 为向上取整的字符块大小,minimum 为最低计费字符数。
billing.metering可选的音频用量计费设置:outputTokenHold 为预留输出 Token 数;providerCost=true 表示最终费用需上游报告。
billing.creditsPerUsd每美元对应的积分数。为 null 时不计算网关积分;不要用 prices[].credits 乘数量。
billing.priceScopegateway 为网关售价;project 为已含项目倍率的转售价,不要再乘项目倍率。
billing.version当前计算规则版本为 1;遇到不支持的版本应停止报价并刷新目录。
billing.unavailableReason非空表示当前配置不能报价,应展示原因,不要按免费处理。
prices[].originalMicros可选的原价,只用于展示,不参与实付金额计算。
fromMicros模型列表的起步单价,不是本次请求总价;具体报价应读取所选渠道的 prices。
maxMicros模型列表的最高单价(单位见 maxUnit),不是本次请求总价;具体报价应读取所选渠道的 prices。

计算前:准备输入并选择价格

准备参数:billing.version=1 为当前计算契约;billing.unavailableReason 非空时不可报价。先按 billing.modelParams 校验模型输入,再按渠道 params 的类型、required、default、options、min/max 等约束校验并补默认值;存在 billing.upstreamParams 时,以其校验结果和默认值作为最终输入。渠道或上游不支持的字段,只有其值等于模型默认值时才忽略,否则报错。mode 根据最终参数定义中的 image/images 字段是否有值推导为 image 或 text,不直接使用用户指定的 mode。

按次、秒、图片和字符计费时,用最终输入匹配 prices[].conditions:条件全部满足才可选,比较时将值转为字符串;匹配规则中条件最多的一条优先,同等条件数量保留接口返回顺序。Token 按下文的输入长度档位选价。

按次数(request)

每次请求计 1 次。总微美元 = round(priceMicros × 1),与时长、图片数量无关。例:单价 20,000 微美元,一次请求为 0.02 美元。

按秒数(second)

数量取补齐默认值后的 input.duration,最低为 1;未提供且模型也无默认值时按 1 计算。总微美元 = round(priceMicros × 秒数)。例:每秒 50,000 微美元,生成 8 秒为 0.40 美元。时长仍须符合模型参数限制。

按图片数量(image)

数量取补齐默认值后的 input.num_images,最低为 1;未提供且模型也无默认值时按 1 计算。总微美元 = round(priceMicros × 图片数)。例:每张 30,000 微美元,生成 4 张为 0.12 美元。图片数量仍须符合模型参数限制。

按字符数(kchar)

单价对应 1,000 个字符。默认统计 input.prompt 的 JavaScript 字符串 length(不是字节数,部分 emoji 会计为 2)。配置了 billing.characterBilling 时,合计 fields 指定字段的字符串长度;有 block 时先向上取整到 block 的倍数,再应用 minimum,最终至少 1 个字符。

计费数量 = 计费字符数 / 1,000;总微美元 = round(priceMicros × 计费数量)。例:统计到 1,200 个字符,block=1,000、minimum=1,000,则按 2,000 个字符计费;每千字符 100,000 微美元时,总价为 0.20 美元。没有 block 时不要自行按整千字符取整。

按 Token(input_token / output_token)

输入、输出分别计价,单价均对应 1,000,000 Token。使用输入 Token 数,分别从两类规则中选择 min_input_tokens 不超过该数量且阈值最高的一条;未设置阈值视为 0,同档位保留返回顺序。输出价格的档位也由输入 Token 数决定。

总微美元 = ceil(输入单价 × 输入 Token 数 / 1,000,000 + 输出单价 × 输出 Token 数 / 1,000,000)。先合计再向上取整,不要分别取整。例:输入单价 1,000,000、输出单价 2,000,000 微美元,输入 1,000 Token、输出 500 Token,总价为 0.002 美元。Token 数不是字符数;未知输出量只能预估。

音频预留:存在 billing.metering 时,先将 prompt 与 style_instructions 拼接,取 UTF-8 字节数 + 256 作为输入 Token 估值,输出 Token 取 outputTokenHold,再用上述 Token 公式计算预留金额。最终按真实用量结算;providerCost=true 时以所需的上游费用报告进行结算。

统一换算:美元与积分

上面的 round 表示四舍五入到整数微美元(Math.round),ceil 表示向上取整(Math.ceil)。美元金额 = 总微美元 / 1,000,000。billing.creditsPerUsd 非空时,积分 = max(1, ceil(美元金额 × creditsPerUsd - 1e-9));最低 1 积分,减去 1e-9 用于避免浮点误差造成多扣。例:0.40 美元、每美元 250 积分,对应 100 积分。

项目售价与报价有效性

项目售价:billing.priceScope=project 的单价已包含项目售价倍率,不要重复加价;billing.creditsPerUsd=null,不能据此计算网关扣费积分。POST /quote 即使携带 project,返回的仍是网关收费价和积分,不包含项目转售加价。

一致性:同一价格配置、指定渠道与输入下,按上述规则计算可与后端保持一致。目录缓存 60 秒,更新价格后需重新获取;前端报价不锁价。自动路由还考虑渠道可用性、优先级和熔断,本地最低价不保证实际成交价。参数不合法、版本不支持或无匹配价格时应提示无法报价,不能显示为免费。

输入参数

JSON 请求体
model
string必填

模型目录中的 slug;项目密钥也可使用项目自定义的模型 slug。

可选值:"seedance-2.0-fast"
input
object必填

模型专属的输入对象。必填字段、默认值和限制见对应模型文档。

provider
string可选

可选供应商 slug。不传时自动路由;项目配置可能固定供应商。

project
string可选

可选项目 ID,使用该项目公开的模型目录和路由配置。

input.prompt
string必填
input.image_url
string<uri>可选

Optional start image (image-to-video)

input.end_image_url
string<uri>可选
input.image_urls
string<uri>[]可选

Reference-to-video images; cite them in the prompt as the model documents

最多数量:9
input.video_urls
string<uri>[]可选

MP4/MOV references, or the clip to edit/extend; input seconds are billed

最多数量:3
input.audio_urls
string<uri>[]可选

Needs a reference image or video

最多数量:3
input.task
enum可选

With video_urls: use them as references, edit the first one, or extend it

可选值:"reference""edit""extend"
input.duration
integer可选
默认值:5
最小值:4
最大值:15
input.resolution
enum可选
默认值:"720p"
可选值:"480p""720p"
input.aspect_ratio
enum可选
默认值:"16:9"
可选值:"16:9""9:16""1:1""4:3""3:4""21:9"
input.generate_audio
boolean可选
默认值:true

输出字段

model
string

模型目录中的 slug;项目密钥也可使用项目自定义的模型 slug。

input
object

模型专属的输入对象。必填字段、默认值和限制见对应模型文档。

providers
array

按后端路由顺序排列的可用供应商,包含 unit、quantity、price_usd、original_price_usd 和 credits;第一项是自动路由首选。

unavailable
array

无法处理此请求的供应商及原因。

示例代码(伪代码)

接口报价
参数.model ← 所选模型 slug
参数.input ← prompt、duration、resolution 等生成参数
参数.provider ← 指定渠道(可选)
参数.project ← 项目 ID(可选)
结果 ← POST /api/v1/quote,JSON 请求体为参数
请求失败时展示 error;成功时展示 providers 中的 price_usd、credits
用 unavailable 说明被排除渠道的原因
前端报价
目录 ← GET /api/v1/models(项目目录加 project 参数)
价格来源 ← 所选模型的 providers 中的渠道;项目目录直接选模型
输入 ← 按 params 和 billing 校验、补默认值、推导 mode
规则 ← 从 prices 中匹配 conditions;Token 计费则选择上下文档位
数量 ← 按 unit 与输入字段计算;音频预留参考 billing.metering
总微美元 ← 普通计费 round(单价 × 数量),Token 计费 ceil(输入费用 + 输出费用)
美元 ← 总微美元 / 1,000,000
积分 ← creditsPerUsd 非空时 max(1, ceil(美元 × creditsPerUsd - 1e-9))
展示报价;用户修改参数时重新本地计算,无需请求 /quote

给 AI 使用

把文档索引或完整接口文档交给 AI 编程助手,包含实时模型参数。