01快速开始
异步任务:提交拿 task_id,轮询到 completed 后取成片。
端点别用错。本系列走 POST /v1/videos,不能用 /v1/chat/completions —— 用对话接口调会直接 404,换任何模型名都无解。
- Base URL
https://www.salpx.com/v1- 鉴权
Authorization: Bearer <SalpX Token>- 提交任务
POST /v1/videos- 查询状态
GET /v1/videos/{task_id}- 代理取片
GET /v1/videos/{task_id}/content- 必填参数
model、prompt、duration(整数秒)- 出片耗时
- 实测 3 – 8 分钟(4 秒 480p:2.0 约 170 秒,2.5 约 270 秒);客户端超时请设 ≥ 600 秒
分辨率与速度版本由模型名决定,不用传。请求体里的 resolution 会被忽略 —— 想要哪一档就选哪个模型名。这样做是为了让报价和实际出片规格严格一一对应。
「480p / 720p / 1080p」指的是画面短边,不是固定的宽高。同一档下实际像素数随画幅变化:720p 档 16:9 出 1280×720,9:16 出 720×1280,而画幅为 adaptive(跟随参考素材)时可能出 720×966 这类非标准尺寸 —— 像素数比 1280×720 少约 24%,观感上就是更糊。如果觉得成片不够清晰,先查画幅、再考虑档位:
① 画幅没锁定是最常见的原因。不传 ratio 时画幅会跟随参考素材,可能出 966×720(4:3)、1650×720(21:9)这类尺寸;你把它放进 16:9 的时间线里就得横向拉伸,多一次上采样,看起来自然就糊了。显式传 ratio(见 5.1)就能拿到原生的 1280×720,不需要任何拉伸。
② 再考虑换 1080p 档(例如 LK-seedance-2.5-ref-1080p)。它把像素数提上去,但请注意:生成式视频的实际细节量主要由模型本身决定,1080p 带来的观感提升通常小于像素数的增幅,价格却是 720p 档的两倍以上。建议先按 ① 把画幅锁好,再判断要不要升档。
02两档报价
同一个规格分两档:不含参考视频与含参考视频,用不同的模型名区分,单价各不相同(见第 03 节)。含参考视频档除出片费外,还按参考视频时长收参考视频附加费(见第 08 节)。
| 档位 | 模型名特征 | 能带什么参考素材 |
|---|---|---|
| 不含参考视频 | LK-seedance-…(名字里没有 -ref-) |
参考图 ✓、参考音频 ✓、首尾帧 ✓、纯文生 ✓ ——不接受参考视频 |
| 含参考视频 | LK-seedance-…-ref-…(名字里有 -ref-) |
必须至少带 1 个参考视频,可同时叠加参考图与参考音频 |
档位和素材必须对上,否则直接 400。用不含参考视频的模型却传了 reference_video,或用 -ref- 模型却一个参考视频都没传,都会被拒绝并提示应改用哪个模型名。
参考图和参考音频不额外收费,两档都能用,不影响单价。只有参考视频会切换档位。
03模型与价格
单价 × 出片秒数 = 总价。价格单位为人民币元 / 秒。
3.1 Seedance 2.0 满血版 · 4 – 15 秒
2.0 多一个速度版本维度:Mini(最省)、fast(快速)、无标记(标准)。同样钉在模型名里。
| 模型名 | 版本 | 分辨率 | 档位 | 单价 | 4 秒 | 15 秒 |
|---|---|---|---|---|---|---|
LK-seedance-2.0-mini-480p | Mini | 480p | 不含参考视频 | ¥0.2898 | ¥1.16 | ¥4.35 |
LK-seedance-2.0-mini-720p | Mini | 720p | 不含参考视频 | ¥0.48312 | ¥1.93 | ¥7.25 |
LK-seedance-2.0-fast-480p | 快速 | 480p | 不含参考视频 | ¥0.4 | ¥1.60 | ¥6.00 |
LK-seedance-2.0-fast-720p | 快速 | 720p | 不含参考视频 | ¥0.7592 | ¥3.04 | ¥11.39 |
LK-seedance-2.0-480p | 标准 | 480p | 不含参考视频 | ¥0.75 | ¥3.00 | ¥11.25 |
LK-seedance-2.0-720p | 标准 | 720p | 不含参考视频 | ¥1.18 | ¥4.72 | ¥17.70 |
LK-seedance-2.0-1080p | 标准 | 1080p | 不含参考视频 | ¥1.7388 | ¥6.96 | ¥26.08 |
LK-seedance-2.0-4k | 标准 | 4K | 不含参考视频 | ¥4.8017 | ¥19.21 | ¥72.03 |
LK-seedance-2.0-mini-ref-480p | Mini | 480p | 含参考视频 | ¥0.2898 | ¥1.16 | ¥4.35 |
LK-seedance-2.0-mini-ref-720p | Mini | 720p | 含参考视频 | ¥0.48312 | ¥1.93 | ¥7.25 |
LK-seedance-2.0-fast-ref-480p | 快速 | 480p | 含参考视频 | ¥0.253 | ¥1.01 | ¥3.79 |
LK-seedance-2.0-fast-ref-720p | 快速 | 720p | 含参考视频 | ¥0.3206 | ¥1.28 | ¥4.81 |
LK-seedance-2.0-ref-480p | 标准 | 480p | 含参考视频 | ¥0.73416 | ¥2.94 | ¥11.01 |
LK-seedance-2.0-ref-720p | 标准 | 720p | 含参考视频 | ¥0.86952 | ¥3.48 | ¥13.04 |
LK-seedance-2.0-ref-1080p | 标准 | 1080p | 含参考视频 | ¥1.7388 | ¥6.96 | ¥26.08 |
LK-seedance-2.0-ref-4k | 标准 | 4K | 含参考视频 | ¥1.8663 | ¥7.47 | ¥27.99 |
Mini 与快速版没有 1080p / 4K。这两档只支持 480p 与 720p,要更高分辨率请用标准版(模型名里不带 mini / fast 的那些)。
3.2 可选模型(需账户开通)
以下模型与上面的 LK- 系列相互独立,各自单独计价。是否可用取决于你的账户分组,未开通时提交会返回 503 No available channel,请联系我们开通。
| 模型名 | 分辨率 | 时长 | 参考素材 | 计费 | 单价 |
|---|---|---|---|---|---|
seedance-2.5-720p-lkh | 720p | 4 – 30 秒任意整数 | 参考图 ✓、参考音频 ✓、首尾帧 ✓;不接受参考视频 | 按秒 | ¥0.886 / 秒 |
seedance-2.5-ref-720p-lkh | 720p | 4 – 30 秒任意整数 | 必须至少带 1 个参考视频,可叠加参考图与参考音频 | 按秒(参考视频不另收) | ¥1.329 / 秒 |
seedance-2.5-bk | 720p | 只收 10 或 30 秒 | 参考图 ≤ 30 张、参考音频 ≤ 10 段;不支持参考视频 | 按次 | ¥10 / 次 |
-lkh 两个模型的请求格式与 LK- 系列完全相同(第 05 节 5.1 – 5.6 照抄,只换模型名);时长用 duration,画幅用顶层 ratio。
seedance-2.5-bk 的请求格式不同,见 5.7,或看独立接入文档:时长必须用 seconds 字段且只能是 10 或 30;传 duration 不生效,会按默认 10 秒出片。
3.3 官方特惠线路(-lkt,需账户开通)
与 LK- 系列规格一一对应(同样的速度版本、分辨率、是否含参考视频档),模型名为 seedance-…-lkt。请求格式与 LK- 系列完全相同(第 05 节照抄,只换模型名)。2.5 时长 4 – 30 秒,2.0 时长 4 – 15 秒。是否可用取决于账户分组,未开通时返回 503 No available channel。
| 模型名 | 版本 | 分辨率 | 档位 | 出片单价 | 参考视频费 |
|---|---|---|---|---|---|
seedance-2.0-mini-480p-lkt | Mini | 480p | 不含参考视频 | ¥0.213 / 秒 | — |
seedance-2.0-mini-720p-lkt | Mini | 720p | 不含参考视频 | ¥0.479 / 秒 | — |
seedance-2.0-fast-480p-lkt | 快速 | 480p | 不含参考视频 | ¥0.337 / 秒 | — |
seedance-2.0-fast-720p-lkt | 快速 | 720p | 不含参考视频 | ¥0.762 / 秒 | — |
seedance-2.0-480p-lkt | 标准 | 480p | 不含参考视频 | ¥0.426 / 秒 | — |
seedance-2.0-720p-lkt | 标准 | 720p | 不含参考视频 | ¥0.957 / 秒 | — |
seedance-2.0-1080p-lkt | 标准 | 1080p | 不含参考视频 | ¥2.391 / 秒 | — |
seedance-2.0-4k-lkt | 标准 | 4K | 不含参考视频 | ¥4.995 / 秒 | — |
seedance-2.0-mini-ref-480p-lkt | Mini | 480p | 含参考视频 | ¥0.254 / 秒 | ¥0.532 / 秒 |
seedance-2.0-mini-ref-720p-lkt | Mini | 720p | 含参考视频 | ¥0.298 / 秒 | ¥0.532 / 秒 |
seedance-2.0-fast-ref-480p-lkt | 快速 | 480p | 含参考视频 | ¥0.409 / 秒 | ¥0.532 / 秒 |
seedance-2.0-fast-ref-720p-lkt | 快速 | 720p | 含参考视频 | ¥0.445 / 秒 | ¥0.532 / 秒 |
seedance-2.0-ref-480p-lkt | 标准 | 480p | 含参考视频 | ¥0.518 / 秒 | ¥0.532 / 秒 |
seedance-2.0-ref-720p-lkt | 标准 | 720p | 含参考视频 | ¥0.55 / 秒 | ¥0.532 / 秒 |
seedance-2.0-ref-1080p-lkt | 标准 | 1080p | 含参考视频 | ¥1.172 / 秒 | ¥1.181 / 秒 |
seedance-2.0-ref-4k-lkt | 标准 | 4K | 含参考视频 | ¥3.001 / 秒 | ¥2.657 / 秒 |
seedance-2.5-480p-lkt | — | 480p | 不含参考视频 | ¥0.603 / 秒 | — |
seedance-2.5-720p-lkt | — | 720p | 不含参考视频 | ¥1.453 / 秒 | — |
seedance-2.5-1080p-lkt | — | 1080p | 不含参考视频 | ¥3.72 / 秒 | — |
seedance-2.5-ref-480p-lkt | — | 480p | 含参考视频 | ¥0.762 / 秒 | ¥0.762 / 秒 |
seedance-2.5-ref-720p-lkt | — | 720p | 含参考视频 | ¥0.797 / 秒 | ¥0.762 / 秒 |
seedance-2.5-ref-1080p-lkt | — | 1080p | 含参考视频 | ¥1.77 / 秒 | ¥1.693 / 秒 |
含参考视频档另收参考视频费:按参考视频总时长计,不足出片时长 2/3 的按 2/3 计。例如出片 30 秒、参考视频只有 5 秒,参考视频费按 20 秒收;参考视频 25 秒则按 25 秒收。提交时先按 30 秒参考视频冻结,任务完成后多退少补。参考图、参考音频不收费。
04参考素材规则
| 素材 | Seedance 2.5 | Seedance 2.0 |
|---|---|---|
| 参考图 | 最多 30 张 | 最多 9 张 |
| 参考视频 | 最多 10 个 | 最多 3 个 |
| 参考音频 | 最多 10 段 | 最多 3 段 |
| 首尾帧 | 最多 2 张 | 最多 2 张 |
| 出片时长 | 4 – 30 秒 | 4 – 15 秒 |
单个素材时长 1.8 – 30.2 秒,参考视频 / 参考音频各自的总时长也不能超过 30.2 秒。所以「10 个参考视频」成立是有前提的:每个都要 ≤ 3 秒。用 4 秒素材放 10 个=40 秒,必然被拒。
Seedance 2.0 不能「只传参考音频」 —— 至少还要有 1 张参考图或 1 个参考视频。想只用参考音频驱动,请用 LK-seedance-2.5-* 系列,2.5 支持仅音频。
audio_url 必须是真音频文件(wav / mp3 等)。传一个 mp4 进去不会被自动抽音轨,会直接判为非法参数。
媒体地址必须是公网可直接下载的 URL(上游服务器要能取到文件),也可用 data: 开头的 base64 Data URI。私有云链接、需要登录或带防盗链的地址会取片失败。
05提交任务
5.1 请求格式
文本放顶层 prompt,媒体放 metadata.content,每项带 role:
| role | 用途 | 可用档位 |
|---|---|---|
reference_image | 参考图(主体 / 风格 / 构图) | 两档都可 |
reference_audio | 参考音频(节奏 / 环境声) | 两档都可 |
reference_video | 参考视频(运镜 / 动作) | 仅 -ref- 档 |
first_frame / last_frame | 首帧 / 尾帧,走首尾帧模式 | 两档都可 |
顶层参数:duration(必填,整数秒)、ratio(可选,见下)。resolution 传了也会被忽略。
ratio 可取:16:9、4:3、1:1、3:4、9:16、21:9、adaptive(跟随参考素材的画幅)。也可以写在 prompt 末尾:--ratio 16:9;两处同时出现时以请求体为准。
要什么画幅,就必须把 ratio 传出来。不传 ratio 时本网关不会替你填任何默认值,画幅交给上游自行决定;而带参考图 / 参考视频时,上游通常跟随参考素材的画幅,成片就可能变成 720×966、1650×720 这类非标准尺寸,而不是你想要的 16:9。
只在提示词里用中文写「16:9 的比例」是不生效的 —— 那是一段文字,不是参数。必须用请求体的 ratio 字段,或 prompt 末尾的 --ratio 16:9。
传了不认识的值(例如 16x9)会直接返回 400 InvalidParameter 并列出可选值,不会被悄悄改成别的画幅。
首尾帧任务的画幅只能是 adaptive(跟随首帧图)。传其它值会被自动改为 adaptive —— 这是上游的硬性规定,不改写的话整单会被拒绝。
白模预演:传 "draft": true 先出 3D 白模,确认场景布局与运动轨迹后再渲染成片,用于降低试错成本。仅 LK-seedance-2.5-* 支持,2.0 系列没有这个能力。
5.2 纯文生视频
curl -X POST https://www.salpx.com/v1/videos \ -H "Authorization: Bearer $SALPX_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "LK-seedance-2.0-mini-480p", "prompt": "霓虹都市夜景,镜头缓缓推进,雨后街道倒映灯光", "duration": 4, "ratio": "16:9" }'
5.3 参考图 + 参考音频(不含参考视频档)
curl -X POST https://www.salpx.com/v1/videos \ -H "Authorization: Bearer $SALPX_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "LK-seedance-2.5-720p", "prompt": "角色与参考图一致,动作节奏贴合参考音频", "duration": 5, "ratio": "16:9", "metadata": { "content": [ {"type":"image_url","image_url":{"url":"https://your-cdn.com/char.png"},"role":"reference_image"}, {"type":"audio_url","audio_url":{"url":"https://your-cdn.com/bgm.mp3"},"role":"reference_audio"} ] } }'
5.4 全能参考:图 + 视频 + 音频(含参考视频档)
注意模型名带 -ref-,且必须至少有一个 reference_video。
curl -X POST https://www.salpx.com/v1/videos \ -H "Authorization: Bearer $SALPX_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "LK-seedance-2.5-ref-720p", "prompt": "角色跟参考图一致,运镜跟参考视频,节奏贴合参考音频", "duration": 5, "ratio": "16:9", "metadata": { "content": [ {"type":"image_url","image_url":{"url":"https://your-cdn.com/char.png"},"role":"reference_image"}, {"type":"video_url","video_url":{"url":"https://your-cdn.com/motion.mp4"},"role":"reference_video"}, {"type":"audio_url","audio_url":{"url":"https://your-cdn.com/bgm.mp3"},"role":"reference_audio"} ] } }'
5.5 首尾帧
curl -X POST https://www.salpx.com/v1/videos \ -H "Authorization: Bearer $SALPX_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "LK-seedance-2.0-720p", "prompt": "从第一张图自然过渡到第二张图", "duration": 4, "metadata": { "content": [ {"type":"image_url","image_url":{"url":"https://your-cdn.com/first.png"},"role":"first_frame"}, {"type":"image_url","image_url":{"url":"https://your-cdn.com/last.png"},"role":"last_frame"} ] } }'
5.6 提交成功的响应
返回的是 SalpX 自己的任务 ID(task_ 开头),不是上游的数字 ID。后续查询和取片都必须用这个 ID。
{
"id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
"task_id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
"object": "video",
"model": "LK-seedance-2.0-mini-480p",
"status": "queued",
"progress": 0,
"created_at": 1789980686
}
id 和 task_id 恒为同一个值,task_id 是兼容旧接口保留的,新接入用 id 即可。
5.7 seedance-2.5-bk 的调用方式
端点同样是 POST /v1/videos,但字段与 LK- 系列不同:时长用 seconds(只能 10 或 30),参考图用 images 数组传公网图片地址,可选 size 为 1280x720 或 720x1280。
curl -X POST https://www.salpx.com/v1/videos \ -H "Authorization: Bearer $SALPX_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "seedance-2.5-bk", "prompt": "角色与参考图一致,在海边奔跑,电影感镜头", "seconds": 30, "size": "1280x720", "images": [ "https://your-cdn.com/char-1.png", "https://your-cdn.com/char-2.png" ] }'
带参考音频时请用 multipart/form-data,audio_urls 可重复提交(也可直接上传 audios 文件):
curl -X POST https://www.salpx.com/v1/videos \ -H "Authorization: Bearer $SALPX_KEY" \ -F "model=seedance-2.5-bk" \ -F "prompt=人物动作跟随参考音频的节奏" \ -F "seconds=10" \ -F "image_urls=https://your-cdn.com/char-1.png" \ -F "audio_urls=https://your-cdn.com/bgm.mp3"
时长传 10 / 30 以外的值,或带了参考视频,会直接返回 400 并全额退款。无论 10 秒还是 30 秒,均按 ¥10 / 次计费。提交后的查询、取片与其它模型相同(第 07 节)。
06能力自省
每个 SKU 的边界都能从接口直接读到,不必硬编码、也不必翻这份文档。
两个地方都会返回 capabilities:
| 接口 | 用途 |
|---|---|
GET /v1/models | 提交前查该 SKU 支持什么,推荐 |
GET /v1/videos/{id} | 查询任务时一并返回,在 metadata.capabilities |
{
"model": "LK-seedance-2.5-ref-720p",
"resolution": { "fixed": "720p", "supported": ["720p"] },
"speed_version": "标准",
"duration": { "min": 4, "max": 30, "unit": "second" },
"aspect_ratio": {
"supported": ["16:9","1:1","21:9","3:4","4:3","9:16","adaptive"],
"default": null,
"default_note": "不传 ratio 时本网关不代填,由上游决定;要锁定画幅必须显式传",
"first_last_frame_forces_adaptive": true
},
"first_last_frame": { "supported": true, "max_images": 2,
"roles": ["first_frame","last_frame"] },
"omni_reference": { "supported": true, "max_images": 30, "max_videos": 10,
"max_audios": 10, "reference_video_required": true,
"audio_only_supported": true },
"media_constraints": {
"max_file_size_mb": 10,
"reference_video_seconds": { "min_per_clip": 2, "max_per_clip": 30, "max_total": 30 },
"reference_audio_seconds": { "max_total": 30 },
"image_formats": ["jpeg","png","webp","bmp","tiff","gif","heic","heif"],
"video_formats": ["mp4","mov"],
"audio_formats": ["wav","mp3"]
},
"white_model": { "supported": true, "parameter": "draft", "type": "boolean",
"default": false, "verified": true },
"billing": { "mode": "per-second", "counted": "出片秒数",
"not_counted": ["参考视频时长","参考图","参考音频"] },
"cancellation": { "supported": true, "window_seconds": 20 },
"prompt_options": { "supported": ["--duration","--resolution","--ratio","--draft"] }
}
各 SKU 的取值不同:2.0 系列时长上限 15 秒、参考上限 9 图 / 3 视频 / 3 音频、不支持纯音频输入、不支持白模;不带 -ref- 的档位 reference_video_required 为 false 且不接受参考视频。以接口返回为准。
07轮询与取片
用 GET /v1/videos/{id} 轮询,建议间隔 15 秒。
curl https://www.salpx.com/v1/videos/task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L -H "Authorization: Bearer $SALPX_KEY"
6.1 状态与进度
status | progress | 含义 |
|---|---|---|
queued | 10 | 排队中,上游尚未开始出片 |
in_progress | 50 | 生成中 |
completed | 100 | 已完成,成片地址在 metadata.url |
failed | 100 | 失败,原因在顶层 error;已自动退款 |
progress 是整数(不是 "50%" 这种字符串),而且只有 10 / 50 / 100 三档,是状态的粗粒度映射,不代表真实完成百分比。请以 status 为准判断是否结束,不要用 progress 估算剩余时间。
6.2 完成时的返回
成片地址在 metadata.url,不在顶层。本系列没有顶层 url / video_url / result 字段,也没有 seconds —— 这些是其它模型系列的结构,照搬会取不到值。
{
"id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
"task_id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
"object": "video",
"model": "LK-seedance-2.0-mini-480p",
"status": "completed",
"progress": 100,
"created_at": 1789980686,
"completed_at": 1789980844,
"metadata": {
"url": "https://video.example.com/20260921/20260921165358_xxxx.mp4"
}
}
取值写法:resp["metadata"]["url"]。任务未完成时 metadata.url 为空字符串。
6.3 失败时的返回
{
"id": "task_KnXwJpBG5mE05tuK0CzN0hDTaAUQChKr",
"object": "video",
"model": "LK-seedance-2.5-ref-480p",
"status": "failed",
"progress": 100,
"error": {
"code": "InternalServiceError",
"message": "参考素材无法下载(请提供公网可直接访问的链接): video[0](已退款)"
}
}
失败会自动退款,不产生实际扣费。error.message 里会带上游原文,方便定位。
6.5 取消任务
POST /v1/videos/{id}/cancel —— 撤销一个还没发给渲染端的任务并全额退款。
提交后有一段缓冲期(默认 20 秒),任务先留在 SalpX 不往下发。在这段时间内取消,本次完全不产生费用,全额退回。缓冲期结束后任务才真正发出去,此时不能再取消。
不用猜还能不能取消 —— 查询接口会直接告诉你。metadata.cancellable 为 true 表示现在取消是零成本的,metadata.cancel_before 是截止的 Unix 时间戳;缓冲期一过就变成 false。不要用 status 判断:缓冲期内和已下发排队中,两者都是 queued。
curl -X POST https://www.salpx.com/v1/videos/task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L/cancel -H "Authorization: Bearer $SALPX_KEY"
| 情况 | metadata.cancellable | 取消结果 | 费用 |
|---|---|---|---|
| 缓冲期内 | true | 成功 200 | 全额退回 |
| 已下发、排队中 | false | 409 | 不退款,任务继续正常出片 |
生成中 in_progress | false | 409 | 不退款 |
| 已完成 / 已失败 / 已取消 | false | 409 | 已是终态 |
取消成功返回:
{
"id": "task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L",
"object": "video",
"status": "cancelled",
"progress": 100,
"refunded": 96450
}
取消后状态是 cancelled(与生成失败的 failed 区分开),轮询立即停止。重复取消返回 409,不会重复退款。refunded 是退回的额度(内部计量单位),实际以账单流水为准。
6.4 取片
| 方式 | 说明 |
|---|---|
| 直链下载 | metadata.url 是公网绝对地址,直接 GET 即可,不需要带鉴权头 |
| 代理取片 | GET /v1/videos/{id}/content,需带 Authorization,走 SalpX 中转返回同一个文件。任务未完成时返回 400 并带上当前状态 |
curl -L -o out.mp4 https://www.salpx.com/v1/videos/task_wD4efMzF414I6eMTQ7j2A3bW1Wluh44L/content -H "Authorization: Bearer $SALPX_KEY"
成片链接请及时转存。上游返回的是对象存储直链,属于临时地址,不要当长期存储用。
08计费与退款
提交成功即冻结额度,任务失败或超时自动全额退回。
| 情形 | 计费公式 |
|---|---|
| 不含参考视频档(文生 / 图生 / 首尾帧 / 带参考图 / 带参考音频) | 该模型单价 × 出片秒数 |
含参考视频档(LK-…-ref-…) | 该模型单价 × 出片秒数 + 参考视频附加费 × 参考视频总秒数 |
seedance-2.5-720p-lkh / seedance-2.5-ref-720p-lkh | 该模型单价 × 出片秒数(参考视频不另收) |
seedance-2.5-bk | ¥10 / 次(与时长无关) |
seedance-…-lkt 含参考视频档 | 出片单价 × 出片秒数 + 参考视频费 × max(参考视频总秒数, 出片秒数 × 2/3) |
参考图、参考音频不收费,数量多少都不影响账单。
LK- 含参考视频档按参考视频时长另收附加费:2.0 全系 ¥0.446 / 秒;2.5 的 480p ¥0.335 / 秒、720p ¥0.372 / 秒、1080p ¥0.966 / 秒。提交时先按 30 秒参考视频冻结,任务完成后按参考视频实际总时长(向上取到 0.1 秒)多退少补。
失败自动退款。上游失败、超时、或任务进入 failed → 自动退还该次冻结额度,不产生实际扣费。
09错误处理
| HTTP | 典型信息 | 处理 | |
|---|---|---|---|
| 404 | bad response status code 404 | 用了 /v1/chat/completions,改用 POST /v1/videos | |
| 400 | 是「不含参考视频」档,不接受参考视频 | 改用同规格的 -ref- 模型名 | |
| 400 | 是「含参考视频」档,必须至少带 1 个参考视频 | 补一个 reference_video,或改用不带 -ref- 的模型名 | |
| 400 | duration 超出范围 | 2.5 为 4 – 30 秒,2.0 为 4 – 15 秒 | |
| 400 | 参考图 / 参考视频 / 参考音频 最多 N 个 | 减少素材数量,上限见第 04 节 | |
| 400 | Seedance 2.0 仅传参考音频不被支持 | 2.0 至少需 1 张参考图或 1 个参考视频;只用音频请改 LK-seedance-2.5-* | |
| 400 | Duration must be between 1.8s and 30.2s | 单个素材时长越界 | |
| 400 | 素材转换失败 / 下载失败 | 媒体 URL 不可公网直接下载,换可直连地址 | |
| 409 | task_not_cancellable | 缓冲期已过,任务已下发或已在生成 | 无法撤销;不退款,任务继续正常出片 |
| 400 | task_not_exist | 任务 ID 拼错或不属于当前账号 | 用提交返回的 id(task_ 开头) |
| 403 | token quota is not enough | 余额不足以冻结,充值或换令牌 | |
| 503 | No available channel | 模型名拼错或令牌分组不对 |