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

视频生成 · API v1

Seedance 2.0 Mini 视频 API

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

POST/api/v1/videos/generations

模型与参数

modelId

seedance-2-0-mini-eco

prompt

视频画面描述，必填

duration

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

imageSize

480p / 720p / 1080p

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 段；素材组合由模型能力校验

duration（自动）

可传 -1 或 auto，由模型选择输出时长；先按最大时长预扣

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-mini-eco",
  "prompt": "参考视频中的镜头运动，使用音频中的声音方向",
  "imageSize": "720p",
  "duration": 5,
  "videoInputMode": "references",
  "referenceVideoUrls": [
    "https://example.com/reference.mp4"
  ],
  "referenceAudioUrls": [
    "https://example.com/reference.mp3"
  ]
}

报价与 API 积分

详细价格表

72 个价格档位
Seedance 2.0 Mini API 调用价格
分辨率时长声音API 积分 / 次
480p4 秒关闭0.2285
480p4 秒开启0.2285
480p5 秒关闭0.2857
480p5 秒开启0.2857
480p6 秒关闭0.3428
480p6 秒开启0.3428
480p7 秒关闭0.3999
480p7 秒开启0.3999
480p8 秒关闭0.457
480p8 秒开启0.457
480p9 秒关闭0.5142
480p9 秒开启0.5142
480p10 秒关闭0.5713
480p10 秒开启0.5713
480p11 秒关闭0.6284
480p11 秒开启0.6284
480p12 秒关闭0.6855
480p12 秒开启0.6855
480p13 秒关闭0.7427
480p13 秒开启0.7427
480p14 秒关闭0.7998
480p14 秒开启0.7998
480p15 秒关闭0.8569
480p15 秒开启0.8569
720p4 秒关闭0.4914
720p4 秒开启0.4914
720p5 秒关闭0.6143
720p5 秒开启0.6143
720p6 秒关闭0.7371
720p6 秒开启0.7371
720p7 秒关闭0.86
720p7 秒开启0.86
720p8 秒关闭0.9828
720p8 秒开启0.9828
720p9 秒关闭1.1057
720p9 秒开启1.1057
720p10 秒关闭1.2285
720p10 秒开启1.2285
720p11 秒关闭1.3514
720p11 秒开启1.3514
720p12 秒关闭1.4742
720p12 秒开启1.4742
720p13 秒关闭1.5971
720p13 秒开启1.5971
720p14 秒关闭1.7199
720p14 秒开启1.7199
720p15 秒关闭1.8428
720p15 秒开启1.8428
1080p4 秒关闭1.1057
1080p4 秒开启1.1057
1080p5 秒关闭1.3821
1080p5 秒开启1.3821
1080p6 秒关闭1.6585
1080p6 秒开启1.6585
1080p7 秒关闭1.9349
1080p7 秒开启1.9349
1080p8 秒关闭2.2113
1080p8 秒开启2.2113
1080p9 秒关闭2.4878
1080p9 秒开启2.4878
1080p10 秒关闭2.7642
1080p10 秒开启2.7642
1080p11 秒关闭3.0406
1080p11 秒开启3.0406
1080p12 秒关闭3.317
1080p12 秒开启3.317
1080p13 秒关闭3.5934
1080p13 秒开启3.5934
1080p14 秒关闭3.8698
1080p14 秒开启3.8698
1080p15 秒关闭4.1462
1080p15 秒开启4.1462

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

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

自动时长先冻结预估金额，成功后按实际时长结算。

默认配置：每次 0.6143 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，不返回内部调用信息。