视频任务（Seedance）
视频生成是异步任务：提交后轮询状态，成功后返回可下载的视频地址；账单按输出 token 结算。
创建任务
POST/v1/videos
| 字段 | 类型 | 说明 | |
|---|---|---|---|
| model | string | 必填 | 从 GET /v1/models 或模型广场复制当前已开通视频模型的精确 id；不要根据展示名称猜测。 |
| content | array | 必填 | 输入项：{type:"text", text} 提示词；{type:"image_url", image_url:{url}, role:"first_frame"|"last_frame"|"reference_image"}；{type:"video_url", video_url:{url}, role:"reference_video"}；{type:"audio_url", audio_url:{url}, role:"reference_audio"}。URL 可用 asset://<id>。 |
| duration | integer | 可选 | 2.0 系列为 4–15 秒，API 默认 5 秒；2.5 为 4–30 秒，API 默认 -1（智能时长）。省略值按目录 duration_default 明确发送上游。2.5 编辑必须为 -1，按该型号最大时长预占。网页若已显式选择时长，以网页选择为准。 |
| resolution | string | 可选 | 2.0 支持 480p / 720p / 1080p / 4k；2.5 支持 480p / 720p / 1080p；Fast / Mini 支持 480p / 720p。按实际分辨率落价格档。 |
| ratio | string | 可选 | 16:9 / 9:16 / 1:1 / 4:3 / 3:4 / 21:9 / adaptive。 |
| generate_audio | boolean | 可选 | 是否生成音频（支持的模型）。 |
| watermark | boolean | 可选 | 是否添加水印。 |
| output_format | string | 可选 | mp4 或 mov，仅发送当前模型目录开放的格式。 |
| mode | string | 可选 | LINK42 模式：omni_reference（参考创作）、omni_edit（视频编辑）、omni_extend（视频延长）。按当前模型已启用模式校验，转发前移除。 |
| omni_reference_task_type | string | 可选 | 仅 Seedance 2.5 的上游字段：auto / reference / edit / extend；2.0 系列不要发送。指定类型可提前校验特殊参数，提示词仍须符合所选任务。 |
| seed | integer | 可选 | 随机种子，便于复现。 |
| service_tier | string | 可选 | 只接受 default。flex（以及 execution_expires_after）会让上游把任务排队数小时，超出平台的任务时限与定价，请求会被拒绝（invalid_request）。 |
| callback_url | string | 可选 | 任务终态回调地址：任务进入 succeeded / failed / timeout / cancelled 时由平台 POST 事件，带 X-Signature 签名头（用账户的任务回调签名密钥校验，见 Webhook 文档“任务回调签名”）；它不会转发给上游。需要投递记录与重放请在控制台配置 Webhook 端点。 |
| client_request_id | string | 可选 | 幂等键（也可用 Idempotency-Key 头）。 |
curl https://www.link42.ai/v1/videos \
-H "Authorization: Bearer $LINK42_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "dreamina-seedance-2-0-mini-260615",
"content": [
{"type": "text", "text": "第一人称视角穿过雨后的东京街头，霓虹倒影"},
{"type": "image_url", "image_url": {"url": "asset://1024"}, "role": "first_frame"}
],
"duration": 5,
"resolution": "720p",
"ratio": "16:9",
"generate_audio": true,
"watermark": false
}'{"id": "cgt-2026…", "status": "queued", "created_at": 1788300000}- 只有 model、content 和视频参数（duration、frames、resolution、ratio、seed、camera_fixed、watermark、generate_audio、return_last_frame、draft、service_tier、omni_reference_task_type、output_format）会发给上游；callback_url、client_request_id、mode 等平台字段及其他未列出的字段都不会转发。同一个 client_request_id 换了请求体会返回 409 idempotency_conflict。
- asset://<id> 只引用本人已完成上传的素材。按上游账号配置转为素材库 ID、图片数据或临时签名链接；不能使用其他用户的素材。
- token 计费视频的预扣同时包含参考视频与输出视频；输入时长没有服务端核实数据时，按该型号参考视频总时长上限（2.0 为 15 秒、2.5 为 30 秒）预留。智能输出按型号最长时长预留，终态后以供应商实际 token 用量（包括其最低用量规则）结算并释放差额。
参考素材与任务方式
文生/首尾帧与全模态参考互斥。选择参考创作、编辑或延长时，用 reference_image / reference_video / reference_audio；不要混入 first_frame / last_frame。编辑和延长提示词直接说明对“视频1”的操作，避免写成“参考视频1”而被上游判为参考创作。
2.0 系列最多 9 图、3 视频、3 音频，视频与音频各自合计不超过 15 秒；音频必须与图片或视频同时使用。2.5 最多 30 图、10 视频、10 音频，视频与音频各自合计不超过 30 秒，可只输入音频。视频为 MP4/MOV、不超过 200 MiB；音频为 MP3/WAV、不超过 15 MiB。
| 方式 | 输入 | 参数限制 |
|---|---|---|
| 文生 / 首尾帧 | 纯文本，或 first_frame 加可选 last_frame | 尾帧必须同时提供首帧；2.5 首帧/首尾帧只能使用 adaptive 比例。 |
| omni_reference | 至少一个参考图、视频或音频 | 2.0 不支持纯音频；比例和时长在当前型号范围内选择。 |
| omni_edit | 至少一个参考视频 | 2.5 待编辑视频为 4–30 秒、ratio=adaptive、duration=-1；2.0 保留其通常的比例/时长选项。 |
| omni_extend | 至少一个参考视频 | 2.5 ratio=adaptive，可选 4–30 秒或智能时长；2.0 为 4–15 秒或该型号开放的智能时长。 |
- 网页对本地文件读取时长并提前检查；API URL 与没有时长元数据的素材库文件由服务商最终校验。成功提交仍可能因提示词与声明的任务类型不一致而失败，失败任务按平台规则释放预占。
查询任务
GET/v1/videos/{id}
| 字段 | 类型 | 说明 |
|---|---|---|
| status | string | queued / running / succeeded / failed / cancelled / timeout。 |
| provider_url | string | 供应商原始签名视频地址，有效期有限。 |
| stored_url | string | 成功转存后的平台签名下载地址；按任务保留期有效，读取时重新签发。 |
| storage_status | string | pending / ready / failed；ready 时 stored_url 可下载。 |
| seed / resolution / ratio / duration / framespersecond | … | 实际生成参数。 |
| billing | object | 包含 status、request_id、frozen_micro_usd、charged_micro_usd、settled_at；实际扣费见 charged_micro_usd。 |
| error | object | 失败原因 {code, message}。 |
curl https://www.link42.ai/v1/videos/cgt-2026… \
-H "Authorization: Bearer $LINK42_API_KEY"- 建议 3–5 秒轮询一次，或使用 callback_url 接收终态通知。
- 任务的时限从它提交到上游时算起，在本地排队的时间不计入。提交到上游超过 30 分钟仍未结束的任务会继续查询上游，按上游的实际结果结算；超过 6 小时上游仍未结束时，平台会向上游取消并标记为 timeout：上游尚未开始执行的释放预扣，可能已经执行的按预扣金额结算。
列表与取消
GET /v1/videos?after=&limit=&status= 按游标分页列出任务；DELETE /v1/videos/{id} 取消排队 / 运行中的任务（已冻结费用释放），或删除已完成记录。取消前会先查询上游：上游已经成功的任务按成功结算，并返回 409 task_already_completed；上游已经失败的按失败结束；任务所在的上游账号暂时无法连接时不会取消，返回 503 task_cancel_unavailable，费用保持冻结。
计费说明
tokens ≈ (输入视频秒 + 输出秒) × 宽 × 高 × fps ÷ 1024；720p/24fps 约 21,600 token/秒。海外 Seedance 2.x 按分辨率及是否包含视频输入选择每百万输出 token 的官方档位，最终以供应商返回的 usage 结算；仅成功生成才计费，超过 6 小时仍在上游执行而被放弃的任务按预扣金额结算。折扣按账号模型专属、账号默认、模型默认依次取值，不叠乘。
本地排队
当路由到的上游账号已经跑满并发时，任务不会被拒绝，而是先留在平台本地队列：状态是 local_queued，任务 id 以 lq- 开头，响应带 queue_position（先进先出的位次）。这时费用已按上限冻结，但还没有向上游发出任何请求。
后台任务在账号腾出并发后按顺序提交。提交成功后任务被重新编号为上游任务 id，状态变成 queued；原来的 lq- id 仍然可以继续查询。若提交响应丢失，状态变为 unknown，预扣保留等待运营核对；不要再次提交或取消。任务在本地队列里等待超过自身最大时长会直接进入 timeout 并释放冻结。
| 字段 | 类型 | 说明 |
|---|---|---|
| status | string | local_queued 表示在等上游并发；unknown 表示上游提交待核对；确认后进入 queued / running / succeeded / failed / cancelled / timeout。 |
| queue_position | integer | 本地队列位次，1 表示下一个提交；仅在 local_queued 时出现。 |
- 每个用户同时处于 local_queued / unknown / queued / running 的任务数量有上限；超出时创建任务返回 429 too_many_running_tasks，等待已有任务结束或降低并发后重试即可。
- 取消一个 local_queued 任务会立刻释放冻结。它从未调用上游，因此不计费。unknown 任务在提交结果核对完成前不可取消。
按模型对照
第一列是调用时填进 model 的目录名。Seedance 1.x 与 2.x 的参数写法不同：1.x 把分辨率、时长、运镜写在提示词后缀开关里，2.x 用请求体上的结构化字段。
「素材角色」指 content[] 里 image_url / video_url / audio_url 项上的 role 字段，只有列出的角色对该模型有意义。
| 模型 ID | 名称 | 上游 | 计费 | 差异字段 | 限制与注意 |
|---|---|---|---|---|---|
| seedance-1-0-pro-fast-251015 | Seedance-1.0 | BytePlus Ark | 按输出 token（单一价） | content 只接受 text 与 image_url；分辨率 / 时长 / 运镜写成提示词后缀开关：--resolution 720p --duration 5 --camerafixed false（--resolution=720p 这种等号写法也认）；没有 generate_audio | 输出 token 单价固定，不按分辨率分档 |
| seedance-1-5-pro-251215 | Seedance-1.5 | BytePlus Ark | 按输出 token（音频分价） | 提示词后缀开关同 1.0，另外接受请求体上的 generate_audio | generate_audio 决定用含音频输出还是不含音频输出的单价；结果里没有这个字段时回落到提交时的取值 |
| ep-20260510102134-rjc2n | Seedance-2.0 | 火山方舟（endpoint id） | 按输出 token（分辨率分档） | 结构化字段 resolution / duration / ratio / generate_audio / watermark / seed；content 支持 image_url（role: first_frame、last_frame、reference_image）与 video_url（role: reference_video） | ep- 开头的是账号级 endpoint id，每个部署各不相同，这里的值只是示例，以模型广场里的实际 ID 为准。网关按账号映射把它改写成上游模型 doubao-seedance-2-0-260128（即 Seedance-2.0）再发出；价格档 = 分辨率 × 是否带视频输入 |
| ep-20260510125313-wl5fq | Seedance-2.0 Fast | 火山方舟（endpoint id） | 按输出 token（分辨率分档） | 同 Seedance-2.0 | endpoint id 按部署而异，此处为示例；改写成上游模型 doubao-seedance-2-0-fast-260128（即 Seedance-2.0 Fast）；价格档规则同 Seedance-2.0 |
| ep-20260627145558-xdpxn | Seedance-2.0 Mini | 火山方舟（endpoint id） | 按输出 token（分辨率分档） | 同 Seedance-2.0 | endpoint id 按部署而异，此处为示例；改写成上游模型 doubao-seedance-2-0-mini-260615（即 Seedance-2.0 Mini）；价格档规则同 Seedance-2.0 |
| ep-20260808220821-6fpbk | Seedance-2.5 | 火山方舟（endpoint id） | 按输出 token（分辨率分档） | 同 Seedance-2.0 | endpoint id 按部署而异，此处为示例；改写成上游模型 doubao-seedance-2-5-260628（即 Seedance-2.5）；价格档规则同 Seedance-2.0 |
| seedance-2 | Seedance 2.0 | 国内火山方舟（北京） | 人民币原价按最新 SAFE 汇率折美元，输出 token 分辨率分档 | duration 4–15 秒；resolution 为 480p / 720p / 1080p / 4k；ratio、generate_audio、watermark；content 支持首帧等参考素材 | 上游 doubao-seedance-2-0-260128；480p/720p 原价带视频输入 ¥28、无视频输入 ¥46 / 百万 token，1080p ¥31/¥51，4k ¥16/¥26；按实际用量结算 |
| seedance-2-0-fast | Seedance 2.0 Fast | 国内火山方舟（北京） | 人民币原价按最新 SAFE 汇率折美元，输出 token 分辨率分档 | duration 4–15 秒；resolution 为 480p / 720p；ratio、generate_audio、watermark | 上游 doubao-seedance-2-0-fast-260128；刊例价带视频输入 ¥22、无视频输入 ¥37 / 百万 token；供应商限时活动不是平台永久售价 |
| seedance-2-0-mini | Seedance 2.0 Mini | 国内火山方舟（北京） | 人民币原价按最新 SAFE 汇率折美元，输出 token 分辨率分档 | 4–15 秒；480p / 720p；同步音频、首尾帧及参考素材 | 上游 doubao-seedance-2-0-mini-260615；实时价格与可用能力读取模型广场，含视频输入选择对应价格档。 |
| seedance-2-5 | Seedance 2.5 | 国内火山方舟（北京） | 人民币原价按最新 SAFE 汇率折美元，输出 token 分辨率分档 | 4–30 秒或智能时长；480p / 720p / 1080p；mp4 / mov；参考、编辑与延长 | 上游 doubao-seedance-2-5-260628；编辑/延长跟随源视频比例，编辑使用 duration=-1；实时价格读取模型广场。 |
| dreamina-seedance-2-0-260128 | Seedance 2.0 | BytePlus Ark | 按输出 token | 4–15 秒；480p / 720p / 1080p / 4k；支持同步音频和多模态参考 | 480p/720p 无视频输入 $7/百万 token、带视频 $4.3；1080p $7.7/$4.7；4k $4/$2.4。素材首次导入上游可能使提交变慢。 |
| dreamina-seedance-2-0-fast-260128 | Seedance 2.0 Fast | BytePlus Ark | 按输出 token | 4–15 秒；480p / 720p；支持同步音频与参考素材 | 无视频输入 $5.6/百万 token、带视频 $3.3；供应商的限时优惠是否适用取决于账号和结算方式，平台折扣由管理员另设。 |
| dreamina-seedance-2-0-mini-260615 | Seedance 2.0 Mini | BytePlus Ark | 按输出 token | 4–15 秒；480p / 720p；支持同步音频与参考素材 | 无视频输入 $3.5/百万 token、带视频 $2.1；供应商的限时优惠是否适用取决于账号和结算方式，平台折扣由管理员另设。 |
| dreamina-seedance-2-5-260628 | Seedance 2.5 | BytePlus Ark | 按输出 token | 4–30 秒；480p / 720p / 1080p；支持同步音频与多模态参考 | 480p/720p 无视频输入 $10.7/百万 token、带视频 $6.4；1080p $11.7/$7。素材首次导入上游可能使提交变慢。 |
- 是否带视频输入按一条严格规则判定：content[] 里存在 type 为 video_url、role 为 reference_video 且 url 非空的项。只放 image_url 不算视频输入，价格档也不同。
- 落价格档时优先用结果里的 resolution，取不到才用提交时的 resolution；两者都没有时按基础视频单价结算。
- 表里四个 ep- 开头的 ID 是旧版部署示例，不是当前生产目录；国内目录使用 seedance-2、seedance-2-0-fast、seedance-2-0-mini 与 seedance-2-5，海外目录使用 dreamina- 别名。是否上架以模型广场或 GET /v1/models 的实时结果为准。