SEEDANCE 2.0

Seedance 2.0 视频生成

Seedance 2.0 Fast / Mini 按秒视频接入说明：720P、16:9、5 秒文生，包含支持范围、价格、异步状态与下载。

最后验证：2026-10-30

使用 RootFlowAI 异步视频接口：先提交任务取得 ID，再查询状态，完成后播放或下载。统一地址为 https://api.rootflowai.com，三个接口均使用自己的 RootFlowAI API Key。

模型与支持范围

模型	API 模型 ID	分辨率	画幅	当前时长
Seedance 2.0 Fast	`doubao-seedance-2.0-fast-720p-sec`	`720p`	`16:9`	5 秒
Seedance 2.0 Mini	`doubao-seedance-2.0-mini-720p-sec`	`720p`	`16:9`	5 秒

完整模型名称必须保留 -720p-sec 后缀。无后缀的型号、固定时长商品和其他渠道的同名模型不能混用；本页两款商品按输出秒数计费，不使用 token 计费入口。

输入或功能	当前支持情况
文本提示词	支持，非空，最多 32000 字符
单张或多张参考图	暂不支持，URL 和 Base64 均不能传入
首帧、尾帧、首尾帧	暂不支持
参考视频、参考音频、混合素材	暂不支持
视频编辑、延长视频	暂不支持
其他时长、480P、1080P、竖屏等画幅	尚未开放
指定音轨、音频开关、随机种子等额外参数	尚未开放，不接受未知字段透传

官方模型的能力范围大于本页已接入范围，不能直接把官方原生 content 素材数组或 H3 的素材字段套用到这两个模型。超出范围会被拒绝，平台不会删除素材后改成文生，也不会偷偷更改时长或规格。

当前成片样本带有音轨，但这不等于支持音频参考，也不保证每次输出都有指定声音。需要已开放的图片、首尾帧或音视频参考时，可查看 MiniMax H3 指引，并主动选择对应模型，不会自动替换模型。

价格与分组

以下是首批确认的每秒价格，待平台配置和验收完成后开放。$ 表示站内额度，并非美元；基础充值 1 元人民币对应 1 站内额度，详见计费说明。

会员	Fast（额度/秒）	Mini（额度/秒）
普通	0.56	0.34
VIP	0.49	0.30
SVIP	0.42	0.26

5 秒任务的普通 / VIP / SVIP 价格：Fast 为 2.80 / 2.45 / 2.10 额度，Mini 为 1.70 / 1.50 / 1.30 额度。价格已包含对应会员档优惠，不要重复打折。调用前以模型价格页的实际模型、分组和计费单位为准；当前未见对应分组时，不要借用其他模型的分组或价格。

计量按请求的输出秒数进行。实际成片播放时长可能略有差异，例如请求 5 秒的样本为约 5.17 秒，不据此额外增加计费秒数。输入素材当前不受理，不能据文生报价推定未来参考素材免费。

模型分组决定可用服务，会员身份决定对应价格。开放后在 API Key 管理选择支持这两个精确模型名的分组，并确认令牌的模型权限。Fast 和 Mini 通过请求中的 model 切换，不能仅修改显示名称。

接口流程

POST /v1/videos
  → 保存返回的任务 ID

GET /v1/videos/{task_id}
  → queued / in_progress / completed / failed

GET /v1/videos/{task_id}/content
  → completed 后播放或下载视频

提交任务

请求参数

字段	必填	说明
`model`	是	上表中的完整模型 ID
`prompt`	是	非空文本，最多 32000 字符
`seconds`	是	JSON 字符串，当前填写 `"5"`
`resolution`	否	`"720p"`；省略时使用模型默认值
`aspect_ratio`	否	`"16:9"`；省略时使用默认横屏

不要传 size、orientation、metadata、input_reference、image_urls、video_urls、audio_urls、first_frame_url、last_frame_url 或官方 content 数组。不使用聊天接口的 messages 或 stream。

先将自己的 Key 设置到环境变量 ROOTFLOWAI_API_KEY。模型开放后可使用下列请求：

curl --connect-timeout 15 --max-time 900 \
  https://api.rootflowai.com/v1/videos \
  -H "Authorization: Bearer ${ROOTFLOWAI_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2.0-fast-720p-sec",
    "prompt": "阳光下木桌上的蓝色陶瓷杯，镜头缓慢推近，柔和自然光，无人物、无文字。",
    "seconds": "5",
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

使用 Mini 时，仅将 model 改为 doubao-seedance-2.0-mini-720p-sec。创建成功后立即保存 id，不要根据相同提示词推断是同一个任务。

查询与异常处理

将返回的 ID 赋给 TASK_ID 后查询：

curl --connect-timeout 15 --max-time 60 \
  "https://api.rootflowai.com/v1/videos/${TASK_ID}" \
  -H "Authorization: Bearer ${ROOTFLOWAI_API_KEY}"

状态	含义与客户端动作
`queued`	排队中，保留 ID，继续查询
`in_progress`	生成或结果准备中，继续查询
`completed`	任务已完成，可尝试播放或下载
`failed`	明确终态失败，读取安全错误说明并核查消费记录
未识别状态或查询请求报错	显示“待确认 / 查询异常”，保留 ID，不要当作生成失败

建议每 10–15 秒查询一次；遇到 429 时遵循 Retry-After（如有），401/403 先检查 Key 和权限。网络超时、5xx、查询异常都不证明生成失败，不应触发新的创建请求。

参数、时长、素材或审核原因在安全处理后尽量保留；敏感账户、鉴权、财务、签名地址、内部标识和原始请求内容不会公开。只展示任务最终失败原因，不把中间异常留作成功任务的错误提示。客户端应显示返回的安全 error.message，不要统一替换成“生成失败”。

视频生成完成后，文件交付可能仍在准备；看到 video storage is preparing 时继续查询。下载或文件交付异常不等于生成失败，不要直接显示“已退款”或重新生成。

播放与下载

curl --connect-timeout 15 --max-time 1260 \
  "https://api.rootflowai.com/v1/videos/${TASK_ID}/content" \
  -H "Authorization: Bearer ${ROOTFLOWAI_API_KEY}" \
  -o seedance.mp4

接口返回视频二进制，通常为 video/mp4，不是需要再次请求的第三方 URL。浏览器播放须经过自己的服务端认证代理或受控下载流程，不要把 Key 放进 URL、公开网页或第三方播放器。

平台开放并完成链路验收后，可在视频任务中查询、预览和下载。沿用平台的 7 天保留规则，请及时保存结果；任务记录不是永久文件备份。文件读取失败时先重试查询或下载原任务，不重发生成。

核对消费与退款

在消费日志中按同一任务 ID 核对扣款、调整及退款，净费用为扣款减退款。一次消费流水不等于一次最终生成结果；时间相近或提示词相同也不证明是同一任务。

明确失败、提交结果不明、查询异常和交付失败需要分别处理。客户端不能自行退款，也不能用“等待超时”推断可退款。实际结算以任务终态及消费流水为准；有疑问请向服务支持提供任务 ID、模型和发生时间，隐藏 Key 与私人输入。

常见问题

为什么官方支持参考图，这里却不支持？

官方模型能力不等于当前按秒商品已开放能力。参考素材需要完成字段、素材转存、实际成片及计费验收；当前入口只接受文本。

能生成 10 秒、15 秒或竖屏吗？

当前仅开放本页明确列出的 5 秒、16:9。不要把上游目录或官方的更大范围直接用于此入口，后续扩展以本页更新为准。

为什么看不到模型或提示不可用？

先检查完整模型名、分组和令牌模型权限；目前仍处于上线前配置与验收阶段，不代表 Key 一定有误。

相关说明：获取 API Key · MiniMax H3 · 服务定价