洛辞 API 文档
管理密钥
API 文档/Seedance 2.5 Uncensored

视频生成 · API v1

Seedance 2.5 Uncensored 视频 API

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

POST/api/v1/videos/generations

模型与参数

modelId

seedance-2-5-standard

prompt

可选文本；至少提供提示词或一种参考素材。支持 @Image 1、@Video 1、@Audio 1 素材标记；关闭内容审核时必须提供提示词

inputImage

首帧图片 URL 或单元素数组；多张时作为参考图片，最多 30 张

inputImageLast

可选尾帧图片 URL，必须同时提供首帧；不可与 inputImageReference 混用；可搭配视频、音频作为多模态参考

inputImageReference

最多 30 张图片 URL 的数组，不可与首尾帧同时使用

inputVideo

最多 10 段公开 HTTPS 视频 URL；每段 2–30 秒、合计不超过 30 秒，服务端检测实际时长

inputAudio

最多 10 段公开 HTTPS 音频 URL；每段 2–30 秒、合计不超过 30 秒，可单独作为参考

resolution

480p / 720p / 1080p，默认 720p；兼容 imageSize

ratio

adaptive / 1:1 / 9:16 / 16:9 / 3:4 / 4:3 / 21:9；兼容 aspectRatio，参考视频的画面比例由视频素材确定

duration

4–30 的整数或整数字符串；支持 auto 或 -1 自动时长，视频编辑需使用 auto

generateAudio

boolean 或 true/false 字符串，默认 false

outputFormat

mp4 / mov，默认 mp4

seed

可选整数，0–4294967295

bitrateMode

default / standard / high，默认 default

referenceTaskType

auto / reference / edit / extend；编辑和延长需参考视频与 adaptive 比例，edit 使用自动时长

returnLastFrame

boolean，默认 false；完成后 task.lastFrame.url 为携带 API Key 下载的本站地址

webSearch

boolean，默认 false

contentFilter

boolean，默认 true；关闭时仍需遵守本站使用规则

参考媒体支持 MP4/MOV、MP3/WAV，每段不超过 100MB。每次输出一个视频。参考图片数量、首尾帧和参考图模式以模型支持能力为准；不支持的组合会返回参数错误。

参考视频与音频

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

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

报价与 API 积分

详细价格表

3 个价格档位
Seedance 2.5 Uncensored API 调用价格
分辨率无参考视频 · API 积分 / 秒有参考视频 · API 积分 / 秒
480p0.11860.0712
720p0.2010.121
1080p0.3470.207

1 美元 = 1 API 积分。费用 = 每秒单价 × 计费秒数。

无参考视频按输出时长收费；有参考视频按输入视频总时长向上取整加输出时长收费，最低计费秒数为输出时长的 5/3 向上取整。图片、音频不增加计费时长。

自动时长先按 30 秒输出冻结，成功后按实际时长结算并释放剩余冻结金额。

声音、水印、尾帧、联网和码率选项无额外附加费。

按分辨率与参考视频输入选择秒价。向 POST /api/v1/videos/quote 提交相同参数查询 estimatedPoints；报价不创建任务，也不冻结积分。输入视频、输出规格与时长影响费用。

按秒计费，按分辨率与是否包含参考视频选择单价，详见价格表。参考视频计入计费时长，图片与音频不增加计费时长。提交前冻结预估积分，成功后按实际时长结算；自动时长先按 30 秒输出预留。

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，不返回内部调用信息。