为快速预览循环设计
用 Seedance 2.0 Mini API 风格请求测试提示词、比较运动想法,并在进入更长生产渲染前创建紧凑片段。
Seedance 2.0 Mini API 指南
Seedance 2.0 Mini API 页面说明如何基于 Seedance API v2 构建轻量生成流程。使用 fast 模型路径可服务短视频、预览、社交视频和高频产品工作流,无需自建 GPU 基础设施。
适合紧凑任务
使用 v2 Fast 模式
提示词或参考图
HTTPS JSON
Mini 风格请求
curl -X POST 'https://seedanceapi.org/v2/generate' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"model": "seedance-2.0-fast",
"prompt": "A compact product reveal with smooth camera motion",
"duration": 5,
"aspect_ratio": "9:16"
}'Seedance API v2 当前提供 seedance-2.0 和 seedance-2.0-fast。Mini API 工作流建议使用 fast 路由、短时长和聚焦提示词。
当团队更重视速度、可预测成本和简单 REST 集成,而不是长篇电影级渲染时,Seedance 2.0 Mini API 工作流更合适。
用 Seedance 2.0 Mini API 风格请求测试提示词、比较运动想法,并在进入更长生产渲染前创建紧凑片段。
开发者可用 Bearer token 鉴权,通过 POST /v2/generate 创建任务,并用 GET /v2/status 轮询,模式与完整 Seedance 2.0 API 一致。
短时长、明确宽高比和异步状态轮询,让 Seedance 2.0 Mini API 工作流更容易进入产品队列和审核流程。
Mini API 工作流聚焦轻量视频应用和自动预览生成所需的 Seedance 2.0 API 子集。
当你希望获得更快迭代和更小任务的 Mini API 行为时,将 model 设置为 seedance-2.0-fast。
发送精炼提示词、宽高比和时长,为应用、社交媒体和创意测试生成短视频资产。
提供 1 到 4 个图片 URL,为静态参考图添加运动,同时保持 Seedance 2.0 Mini API 请求体紧凑。
支持 5、10 或 15 秒任务;Mini API 预览流程建议从 5 秒开始。
每个请求都会返回 task id,应用可轮询状态、更新 UI,并在完成后获取最终视频 URL。
Seedance 2.0 Mini API 工作流与更完整的 Seedance 2.0 API 使用相同的 v2 鉴权、计费和响应结构。
从现有 Seedance API v2 端点开始,并将请求调成紧凑输出。
登录后打开 API Keys 页面,复制用于服务端调用的密钥。不要把密钥放进浏览器代码或公开仓库。
调用 POST /v2/generate,传入 model seedance-2.0-fast、聚焦提示词、duration 5 和所需宽高比。
用返回的 task_id 调用 GET /v2/status。状态为 SUCCESS 时读取 data.response[0] 并展示或存储视频 URL。
Mini API 流程保持很小:鉴权、创建生成任务,然后轮询完成状态。
创建 Seedance 2.0 Fast 生成任务。文生视频使用提示词,图生视频使用 images。
返回处理状态、失败详情,或包含生成视频 URL 的最终 response 数组。
异步系统可在集成支持时传入公开 callback_url。不要使用 localhost URL。
| 参数 | 推荐值 |
|---|---|
| model | Mini API 工作流使用 seedance-2.0-fast。 |
| prompt | 保持聚焦和具体;最多 2000 字符。 |
| duration | 预览用 5 秒;更完整片段用 10 或 15 秒。 |
| aspect_ratio | 文生视频使用 16:9、9:16、4:3 或 3:4。 |
| images | 图生视频使用 1 到 4 个 HTTPS 图片 URL。 |
| callback_url | 可选的公开 webhook URL,用于异步通知。 |
完整参数请查看 Seedance 2.0 API v2 文档。本页只是把同一 API 收窄成 Mini 风格实现。
当用户需要在现有产品里快速获得运动预览或轻量生成视频时,Mini API 工作流最合适。
为信息流预览、广告创意和创作者工具生成紧凑竖屏片段。
用短图生视频请求为产品图或活动视觉添加动效,再决定最终创意。
让用户快速测试多个提示词版本、比较结果,并把最佳提示词升级到更大渲染。
用短 fast 任务服务批量预览、内容流水线和需要稳定吞吐的应用。
Seedance 2.0 Mini API 工作流仍需要和任何生产视频 API 一样的运维设计。
把 API 密钥存放在服务端,由后端调用 Seedance API,只向客户端暴露你自己的安全端点。
使用队列管理并发、重试临时失败,并在视频任务处理期间保持界面响应。
监控积分消耗、任务状态和错误响应,确保 Mini API 工作流随规模增长仍可预测。
Mini API 是基于 Seedance API v2 的工作流选择。快速短片用它,质量或时长更重要时切换到标准用法。
需要快速反馈时,使用 fast 路由、更短时长和更聚焦提示词。
当电影级质量和更丰富场景是重点时,使用标准 Seedance 2.0 模型路径。
Mini 工作流和标准 v2 用法的鉴权、计费、状态轮询和响应解析保持一致。
| 能力 | Mini 工作流 | 标准 v2 用法 |
|---|---|---|
| 模型提示 | seedance-2.0-fast | seedance-2.0 |
| 最佳时长 | 5 秒 | 10 或 15 秒 |
| 最佳用途 | 预览、批量、快速迭代 | 最终创意、更丰富叙事 |
| API 形态 | 相同 /v2/generate 和 /v2/status | 相同 /v2/generate 和 /v2/status |
面向评估 Seedance 2.0 Mini API 风格集成的开发者。
Mini 风格行为请使用 Seedance API v2 并传入 seedance-2.0-fast 模型提示。当前公开路由是 POST /v2/generate,然后 GET /v2/status。
适合短预览、社交视频测试、产品运动草稿和高频提示词迭代。
支持。把 1 到 4 个图片 URL 放入 images 字段,并用提示词聚焦描述需要的运动。
快速 Mini API 预览建议从 5 秒开始,需要更完整场景时再使用 10 或 15 秒。
文生视频支持 16:9、9:16、4:3 和 3:4。请选择与投放位置匹配的比例。
每次请求都传 Authorization: Bearer YOUR_API_KEY。密钥应保存在后端,不能暴露在客户端代码中。
使用 task_id 轮询 GET /v2/status。状态为 SUCCESS 时,从 data.response[0] 读取第一个视频 URL。
支持。Seedance 2.0 Mini API 工作流使用标准 HTTPS 和 JSON,可用于 cURL、Python、Node.js、Go、Java 等 HTTP 客户端。
不建议。应使用后端或 BFF 保护 API 密钥、校验提示词、限制速率并处理重试。
Seedance API 使用积分。成本取决于模型和时长,因此 Mini 风格的短 fast 任务更容易预测。
可以。保留相同端点,在需要更高质量生产渲染时调整模型提示、时长和提示词策略。
打开 Seedance 2.0 API v2 文档,可查看完整请求结构、响应示例、定价表和错误码。