洛辞 API 文档
管理密钥
API 文档/Seedance 2.0 Fast

视频生成 · API v1

Seedance 2.0 Fast 视频 API

通过文字或参考图片生成视频，使用独立 API 积分。

POST/api/v1/videos/generations

模型与参数

modelId

seedance-2-0-fast

prompt

视频画面描述，必填

duration

4–15 秒，步长 1；默认 5 秒

imageSize

480p / 720p

aspectRatio

adaptive / 1:1 / 9:16 / 16:9 / 3:4 / 4:3 / 21:9

referenceUrls

可选，公开图片 URL 数组，最多 9 张；可搭配参考视频或音频

videoInputMode

keyframes / image / references；默认 keyframes

referenceVideoUrls

可选，公开视频 URL 数组，最多 3 段

referenceAudioUrls

可选，公开音频 URL 数组，最多 3 段；素材组合由模型能力校验

bitrateMode

输出码率：default / standard / high；默认 default

returnLastFrame

boolean，是否返回尾帧；默认 false

webSearch

boolean，是否启用联网搜索；默认 false

referenceImageOrder

可选，图片顺序数组；每项为 url: 加对应 referenceUrls 中的完整地址，必须恰好覆盖全部参考图片

generateAudio

boolean，是否生成声音；默认 true

每次输出一个视频。参考图片数量、首尾帧和参考图模式以模型支持能力为准；不支持的组合会返回参数错误。

参考视频与音频

referenceVideoUrls、referenceAudioUrls 为公开 HTTP(S) URL 数组，videoInputMode 使用 references；提供媒体时可省略输入模式。参考视频最多 3 段，每段不超过 15 秒，合计不超过 15 秒，每段不超过 200MB；参考音频最多 3 段，每段不超过 15 秒，合计不超过 15 秒，每段不超过 15MB。素材组合由模型能力校验。时长由服务端检测，不接受客户端上报；首次报价导入并检测素材，后续请求复用已检测素材。

{
  "modelId": "seedance-2-0-fast",
  "prompt": "参考视频中的镜头运动，使用音频中的声音方向",
  "imageSize": "720p",
  "duration": 5,
  "videoInputMode": "references",
  "referenceVideoUrls": [
    "https://example.com/reference.mp4"
  ],
  "referenceAudioUrls": [
    "https://example.com/reference.mp3"
  ]
}

报价与 API 积分

详细价格表

48 个价格档位
Seedance 2.0 Fast API 调用价格
分辨率时长声音API 积分 / 次
480p4 秒关闭0.3656
480p4 秒开启0.3656
480p5 秒关闭0.457
480p5 秒开启0.457
480p6 秒关闭0.5484
480p6 秒开启0.5484
480p7 秒关闭0.6398
480p7 秒开启0.6398
480p8 秒关闭0.7312
480p8 秒开启0.7312
480p9 秒关闭0.8226
480p9 秒开启0.8226
480p10 秒关闭0.914
480p10 秒开启0.914
480p11 秒关闭1.0054
480p11 秒开启1.0054
480p12 秒关闭1.0968
480p12 秒开启1.0968
480p13 秒关闭1.1882
480p13 秒开启1.1882
480p14 秒关闭1.2796
480p14 秒开启1.2796
480p15 秒关闭1.371
480p15 秒开启1.371
720p4 秒关闭0.7863
720p4 秒开启0.7863
720p5 秒关闭0.9828
720p5 秒开启0.9828
720p6 秒关闭1.1794
720p6 秒开启1.1794
720p7 秒关闭1.376
720p7 秒开启1.376
720p8 秒关闭1.5725
720p8 秒开启1.5725
720p9 秒关闭1.7691
720p9 秒开启1.7691
720p10 秒关闭1.9656
720p10 秒开启1.9656
720p11 秒关闭2.1622
720p11 秒开启2.1622
720p12 秒关闭2.3588
720p12 秒开启2.3588
720p13 秒关闭2.5553
720p13 秒开启2.5553
720p14 秒关闭2.7519
720p14 秒开启2.7519
720p15 秒关闭2.9484
720p15 秒开启2.9484

1 美元 = 1 API 积分。售价最多保留 4 位小数；表内为不含参考媒体及附加选项的单个视频售价。

参考视频、参考音频、参考图片及模型支持的附加选项可能影响费用；请向报价接口提交完整参数，以返回的报价为准。

默认配置：每次 0.9828 API 积分（5 秒）。向 POST /api/v1/videos/quote 提交相同参数查询 estimatedPoints；报价不创建任务，也不冻结积分。分辨率、时长、声音与快速模式可能影响价格。

1 美元 = 1 API 积分，支持小数。API 钱包和价格独立，不享受网站会员折扣。提交时冻结 API 积分，任务结束后按模型规则结算。充值 API 积分

查询与下载视频

成功提交返回 HTTP 202 和 taskId。每 3–5 秒请求 GET /api/v1/tasks/{taskId}，queued 和 processing 状态继续等待；succeeded、partial、failed 状态停止轮询。settled 为 true 时，chargedPoints 是最终扣费。

task.videos[].url 是本站视频下载路径，下载也必须携带 API Key。视频遵循本站保留期限，过期返回 410，请及时下载保存。只能访问本人 API 任务。

幂等重试

每个新任务设置不同的 Idempotency-Key，8–128 位字母、数字或 ._:-。超时重试保持相同键和参数，避免重复冻结；改变参数返回 409。有效密钥不设请求频率和网页会员并发上限。

错误处理

400 参数或报价组合无效；401 密钥无效；402 API 积分不足；404 任务不存在或无权访问；409 幂等冲突；410 视频已过期；5xx 服务暂不可用。错误包含 error 和 code，不返回内部调用信息。