模型广场
Seedance 视频

Doubao Seedance 2.5 API

支持文生视频,提供 480p / 720p 分辨率。

  • 文生视频
  • 图生视频
  • 参考视频

Playground

正在加载工作台…

人民币计费

正在读取人民币价格…

接入方式

基础域名 https://api.icodeeasy.cc

  • 创建视频任务POST/v1/videos/generations
  • 查询视频任务GET/v1/videos/tasks/{task_id}
  • 下载视频GET/v1/videos/tasks/{task_id}/content
  • 删除视频任务DELETE/v1/videos/tasks/{task_id}

API 示例

POST/v1/videos/generations
curl -X POST "https://api.icodeeasy.cc/v1/videos/generations" \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-binary @- <<'JSON'
{
  "model": "doubao-seedance-2.5",
  "prompt": "雨夜的未来城市街道,镜头缓慢向前推进,霓虹灯倒映在湿润路面上",
  "resolution": "480p",
  "ratio": "9:16",
  "duration": 4,
  "generate_audio": true
}
JSON

先在本地设置 ICODEEASY_API_KEY。示例中的参考素材链接或任务 ID 请替换为你自己的值。

调用参数

创建视频任务
参数类型说明
model必填string模型 ID,使用页首可复制的值。
prompt必填string描述镜头、动作和期望生成的画面。
resolution可选string480p 或 720p,文生视频默认 480p。
ratio可选string文生视频默认 9:16。无参考视频的首帧、首尾帧模式须使用 adaptive 或省略。
duration可选integer输出时长 4–30 秒,文生视频默认 4 秒。
generate_audio可选boolean是否生成音频,默认开启。
content条件必填array参考素材模式必填。首尾帧使用 first_frame / last_frame。参考视频模式最多 10 个 HTTPS 视频(合计 30 秒以内)及 2 张普通参考图。
查询视频任务
参数类型说明
task_id必填string路径参数,使用创建任务后返回的 task_id。
下载视频
参数类型说明
task_id必填string路径参数,使用创建任务后返回的 task_id。
删除视频任务
参数类型说明
task_id必填string路径参数,使用创建任务后返回的 task_id。

核心功能

文生视频

描述人物动作、镜头移动和画面节奏,从提示词生成片段。

支持
图生视频

从图片出发制作运动画面,在提示词里说明主体或镜头如何移动。

使用首帧,或首帧与尾帧引导生成

支持
首帧

提供起始画面,从确定的主体位置、视角和光线开始生成。

画面比例跟随首帧图片

支持
尾帧

提供目标结尾画面,引导镜头过渡到指定姿态或构图。

与首帧一起使用

支持
生成音轨

把同步音轨随视频一起交付,可用于试听对白、声音和画面的配合效果。

默认生成同步音轨,可关闭

支持
普通参考图

用图片约束角色、服装或场景外观,让新片段围绕参考内容生成。

参考视频模式可搭配最多 2 张图片

支持
视频输入

把视频作为参考或源素材,通过请求声明片段的用途。

最多 10 段参考视频。单段 2–30 秒,合计不超过 30 秒

支持
参考视频

把已有片段的动作、运镜或节奏作为生成新画面的参考。

参考视频的动作、镜头与画面内容

支持

模型亮点

多段运镜参考,最长 30 秒

单次可生成最长 30 秒的片段。参考模式中可用最多 10 段视频提供动作和运镜,视频合计不超过 30 秒,也可搭配最多 2 张参考图。

规格与限制

输出规格
480p / 720p
画面比例
16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9 / 自适应
时长
4–30 秒
图片数量上限
最多 2 张
首帧比例
自适应
核对来源 · 2026-11-15

使用场景

  • 把运镜移到新场景

    提供一段运镜参考及新的场景描述,生成片段后比较推进、停顿和转向。

  • 首尾帧转场

    给定转场起点和终点,让运动过程把两张确定的画面接起来。

  • 复用运镜参考

    提供参考视频,再用文字说明新场景和主体,以原片的运动节奏试做新镜头。

  • 有声分镜预演

    让短片带上音轨,先试听画面和声音的配合,再决定后期录制或剪辑方案。

  • 广告分镜试拍

    用提示词写出产品出场、镜头接近和收尾定格,先看转场与节奏是否合适。

  • 片头动效草稿

    描述背景运动、主体入场和标题留白,生成短片作为剪辑片头的备选。

  • 商品图动起来

    提供产品图片,描述镜头绕拍或缓慢推进,做出一段外观展示。

相关文章

常见问题

第一次生成,用什么输入最容易跑通?

从一句话、一个主体、一个动作开始。比如写清人物推门进入,镜头从门外缓慢推进,然后选模型支持的较短时长。

打开本页 Playground
传首帧以后,为什么固定 16:9 会报错?

首帧或首尾帧模式会沿用首帧图片比例。省略 ratio 或填 adaptive。若要 16:9 输出,先把首帧图片裁成 16:9,再提交。

查看调用参数
成片只有 4 秒,为什么带参考视频时的预占更多?

参考视频模式会把参考视频合计时长和输出时长都算进预占。例如 2 秒参考视频加 4 秒输出,先按 6 秒估算。完成后按实际费用结算。

查看本站计费
图片应该作为首帧还是参考素材?

首帧是视频的起始画面。先裁好图片、确认主体的位置,再描述后续动作。普通参考图用于提供角色或场景外观。提示词还要说明主体如何移动、镜头如何拍摄。参考视频模式可搭配最多 2 张图片。

查看调用参数
生成的视频会带声音吗?

默认生成同步音轨,可关闭。准备后期配旁白时,先试听生成音轨,再在剪辑软件里调整或替换。

查看调用参数
第一次试片,分辨率和时长怎么选?

可先从 480p、4 秒试起,重点看动作和构图。最终导出时再按所选模式确认可用的分辨率、时长和素材组合。

查看调用参数
创建成功了,为什么还没有视频?

创建成功表示任务已接受。用本次返回的 status_url 查询状态,排队或生成时继续等。成功后使用 content_url 下载片段。

查看接入方式
查询任务返回 404,要重新生成吗?

先保留原任务 ID,核对 status_url 和本次生成使用的账号,再看用量明细。查询失败本身不能判断任务结果,重复提交会创建新的任务。

生成中余额已经变少,最终费用怎么看?

视频任务创建时会预占费用。完成后查看任务返回的 cost_rmb 或用量明细。明确失败的任务会退回预占金额。

查看本站计费
为什么换了分辨率、时长或声音设置就报 400?

同一型号的候选规格有时随输入模式改变。先确认横屏或竖屏、是否传了素材,再按调用参数选合法组合。已有报错时优先按错误字段修正。

查看调用参数