Seedance 2.0 Mini Text-to-Video API

bytedance/seedance-2.0-mini/text-to-video

Seedance 2.0 Mini Text-to-Video API 将文本提示词生成 4–15 秒的 480p 或 720p 视频。请求可设置七种画面比例,并可发送 generate_audio、return_last_frame、web_search 和 seed;不接收图片、视频或音频输入。

输入

提示词
0/20000
分辨率
时长
画面比例

生成音频

请求模型随视频生成音轨。

高级参数

返回最后一帧

保留视频主结果,并把最后一帧作为额外文件返回。

联网搜索

发送可选的 web_search 布尔字段。

输出

等待运行

生成文件会显示在这里

设置输入、选择时长,然后运行异步视频任务。

5 秒 × 24 积分/秒 = 120 积分 ($0.600)

继续使用

示例

One continuous four-second shot in a rain-wet night market. A fictional adult courier in an amber raincoat starts a small unbranded red delivery scooter beside a steaming noodle stall and pulls away. The camera tracks low beside the rear wheel from a medium-wide view to a medium view. Keep the courier, raincoat, scooter, stall, and camera direction consistent. Use believable acceleration, restrained tire spray, wet neon reflections, and natural cloth motion. Synchronized audio: one engine start, light rain on the awning, tire hiss on wet pavement, and quiet cooking sizzle. No cuts, no extra people entering frame, no dialogue, no readable text, no logos, no products, no advertising, no watermark.

Seedance 2.0 Mini 文生视频 API 概览

Seedance 2.0 Mini Text-to-Video API 只需要文本提示词,不需要上传源媒体。prompt 可包含主体、环境、动作、镜头、光线和声音说明;任务异步执行,生成文件通过状态查询或 callback_url 返回。

为什么使用 Seedance 2.0 Mini Text-to-Video API?

  • 只提交文本提示词。prompt 用于说明主体、环境、动作、镜头、光线和声音,不需要图片、视频或音频输入。

  • 选择 4–15 秒整数时长。duration 接收 4 到 15 之间的整数,包括 4 和 15。

  • 选择七种画面比例。aspect_ratio 接受 auto、16:9、9:16、1:1、21:9、4:3 和 3:4。

  • 按需返回音频和最后一帧。generate_audio 请求生成音轨,return_last_frame 请求额外返回最后一帧文件。

参数

参数要求说明
prompt必填

trim 后 1–20,000 个字符的场景描述。

duration必填

4–15 秒整数;Playground 初始为 5 秒。

resolution可选

API 与 Playground 都以 720p 开始。

默认值720p480p
aspect_ratio可选

Auto 或六种固定画面比例;Playground 初始为 Auto。

auto16:99:161:121:94:33:4
generate_audio可选

boolean。Playground 初始显式发送 true,API 未声明默认值。

return_last_frame可选

请求额外返回最后一帧;Playground 未开启时省略。

web_search可选

boolean;Playground 未开启时不发送该字段。

seed可选

整数,公开契约未声明上下限;空值省略。

使用方法

  1. 定义主体写清主体、环境与必须持续可见的细节。

  2. 描述动作用具体动词说明一个主要动作及其发展过程。

  3. 单独指挥镜头把主体运动与景别、机位和镜头移动分开写。

  4. 补充光线、氛围和声音在提交前明确光线、情绪与所需声音线索。

  5. 提交并跟踪运行请求,然后轮询任务 ID 或接收终态回调。

价格

文生视频只按输出时长和分辨率计费。1 积分 = $0.005;generate_audio、return_last_frame、web_search 和 seed 当前不改变费率。

计费项费率说明
480p 输出10 积分 / 输出秒$0.050/秒;5 秒使用 50 积分,即 $0.250。
720p 输出24 积分 / 输出秒$0.120/秒;5 秒使用 120 积分,即 $0.600。

适用场景

  • 文字分镜预览把文字分镜生成 4–15 秒视频,用于制作前确认动作、镜头和构图。

  • 社交媒体比例变体用同一创意生成横屏、方形、竖屏或电影画幅版本。

  • 镜头设置对比分别提交固定机位、横移、推进或环绕等镜头说明,对比生成结果。

  • 带音轨的视频草案在 prompt 中说明对白、音效或环境声,并将 generate_audio 设置为 true。

提示词技巧

  • 按主体与环境、动作、镜头、光线、氛围、声音的顺序组织提示词。
  • 使用具体动作动词,并把主体运动和镜头移动分开描述。
  • 短片只保留一个主动作,避免多个事件竞争注意力。
  • 节奏重要时,写出开场、发展和结束动作。
  • 先确定交付比例,再描述构图和留白。

注意事项

  • Seedance 2.0 Mini Text-to-Video API 不接收图片、视频、音频或参考素材字段。
  • duration 必填,Playground 提供的 5 秒只是初始值。
  • API 的 resolution 默认为 720p,其他 Playground 初始状态不是 API 默认值。
  • 任务为异步执行,只在 not_started 或 running 时继续轮询。

Seedance 2.0 Mini Text-to-Video API — 常见问题

Seedance 2.0 Mini Text-to-Video API 是什么?

Seedance 2.0 Mini Text-to-Video API 将文本提示词生成视频。请求成功后返回 task_id;任务完成后,data.files 包含生成视频,并可在 return_last_frame 为 true 且服务返回该文件时包含最后一帧图片。

如何调用 Seedance 2.0 Mini Text-to-Video API?

使用 Bearer Key 向 /api/generate/submit 发送 POST,将模型 ID 设置为 seedance-2.0-mini/text-to-video,并把 prompt、duration 等参数放入 input。取得 task_id 后查询任务状态,或提供 callback_url。

Seedance 2.0 Mini Text-to-Video API 如何计费?

480p 每个输出秒使用 10 积分($0.050),720p 每个输出秒使用 24 积分($0.120)。运行按钮同时显示当前参数对应的积分和美元参考金额。

Seedance 2.0 Mini Text-to-Video API 支持哪些输入?

prompt 接受 trim 后 1–20,000 个字符,duration 接受 4–15 的整数,resolution 接受 480p 或 720p,aspect_ratio 接受七个枚举值;还可发送 generate_audio、return_last_frame、web_search 和整数 seed。

如何获取 Seedance 2.0 Mini Text-to-Video API 的生成结果?

仅在状态为 not_started 或 running 时查询 GET /api/generate/status/{task_id}。状态变为 finished 或 failed 后停止查询;成功文件 URL 位于 data.files[].file_url。

三种 Seedance 2.0 Mini API 应该如何选择?

没有源素材时使用 Seedance 2.0 Mini Text-to-Video API;需要首帧和可选尾帧时使用 Seedance 2.0 Mini Image-to-Video API;需要图片、视频或音频参考时使用 Seedance 2.0 Mini Reference-to-Video API。