LogoSD 2.0 API

Seedance 2.5 API 指南

用于AI 视频生成的 Seedance 2.5 API

Seedance 2.5 API 页面说明如何基于 Seedance API v2 构建轻量生成流程。使用 seedance-2.0 模型服务紧凑短片、预览、社交视频和高频产品工作流，无需自建 GPU 基础设施。

获取 API 密钥 阅读 v2 文档
片段时长
5-15s

5-15 秒任务

模型路径
v2

使用 seedance-2.0

输入
T2V + I2V

提示词或参考图

接口
REST

HTTPS JSON

2.5 规划请求

从原生 Seedance 2.0 Mini 模型开始

seedance-2.0 
curl -X POST 'https://seedanceapi.org/v2/generate' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0",
    "prompt": "A cinematic product reveal with smooth dolly-in camera motion",
    "duration": 10,
    "aspect_ratio": "16:9"
  }'

Seedance API v2 提供 seedance-2.0 用于 2.5 任务。轻量生成可使用 5-15 秒时长、480p 或 720p 输出和聚焦提示词。

为什么使用 Seedance 2.5 API 工作流？

当团队更重视速度、可预测成本和简单 REST 集成，而不是长篇电影级渲染时，Seedance 2.5 API 工作流更合适。

为快速预览循环设计

用 Seedance 2.5 API 风格请求测试提示词、比较运动想法，并在进入更长生产渲染前创建紧凑片段。

简单的 API Key 接入

开发者可用 Bearer token 鉴权，通过 POST /v2/generate 创建任务，并用 GET /v2/status 轮询，模式与完整 Seedance 2.0 API 一致。

适合生产的边界

短时长、明确宽高比和异步状态轮询，让 Seedance 2.5 API 工作流更容易进入产品队列和审核流程。

Seedance 2.5 API 能力

2.5 API 工作流聚焦轻量视频应用和自动预览生成所需的 Seedance 2.0 API 子集。

原生 Mini 模型

当你希望获得更快迭代和更小任务的 2.5 API 行为时，将 model 设置为 seedance-2.0。

文生视频短片

发送精炼提示词、宽高比、分辨率和时长，为应用、社交媒体和创意测试生成短视频资产。

图生视频运动

提供 1 到 4 个图片 URL，或 Mini 兼容的参考视频 URL，同时保持 Seedance 2.5 API 请求体紧凑。

短时长任务

支持 4 到 15 秒之间的任意整数时长；2.5 API 预览流程可从 8 秒开始。

异步状态轮询

每个请求都会返回 task id，应用可轮询状态、更新 UI，并在完成后获取最终视频 URL。

共享 v2 基础

Seedance 2.5 API 工作流与更完整的 Seedance 2.0 API 使用相同的 v2 鉴权、计费和响应结构。

如何使用 Seedance 2.5 API

从现有 Seedance API v2 端点开始，并将请求调成紧凑输出。

1

创建 API 密钥

登录后打开 API Keys 页面，复制用于服务端调用的密钥。不要把密钥放进浏览器代码或公开仓库。

2

提交 2.5 任务

调用 POST /v2/generate，传入 model seedance-2.0、聚焦提示词、duration 8、resolution 720p 和所需宽高比。

3

轮询并渲染

用返回的 task_id 调用 GET /v2/status。状态为 SUCCESS 时读取 data.response[0] 并展示或存储视频 URL。

Seedance 2.5 API 请求模式

2.5 API 流程保持很小：鉴权、创建生成任务，然后轮询完成状态。

POST /v2/generate

创建 Seedance 2.0 Mini 生成任务。文生视频使用提示词，图生视频使用 images；需要视频输入时可使用 reference_video_urls。

GET /v2/status

返回处理状态、失败详情，或包含生成视频 URL 的最终 response 数组。

可选 callback URL

异步系统可在集成支持时传入公开 callback_url。不要使用 localhost URL。

推荐的 2.5 API 参数

参数推荐值
model2.5 API 工作流使用 seedance-2.0。
prompt保持聚焦和具体；最多 2000 字符。
duration使用 4 到 15 秒之间的任意整数。
resolutionMini 输出使用 480p 或 720p。
aspect_ratio文生视频使用 16:9、9:16、4:3、3:4、1:1、21:9 或 adaptive。
images图生视频使用 1 到 4 个 HTTPS 图片 URL。
reference_video_urls可选的 Mini 兼容参考视频 URL，用于视频引导生成。
reference_audio_urls可选的参考音频 URL，用于 Mini 兼容生成。
callback_url可选的公开 webhook URL，用于异步通知。

完整参数请查看 Seedance 2.0 API v2 文档。本页只是把同一 API 收窄成 2.5 规划实现。

Seedance 2.5 API 最佳用例

当用户需要在现有产品里快速获得运动预览或轻量生成视频时，2.5 API 工作流最合适。

社交视频预览

为信息流预览、广告创意和创作者工具生成紧凑竖屏片段。

产品运动测试

用短图生视频请求为产品图或活动视觉添加动效，再决定最终创意。

提示词迭代工具

让用户快速测试多个提示词版本、比较结果，并把最佳提示词升级到更大渲染。

高频自动化

用短 fast 任务服务批量预览、内容流水线和需要稳定吞吐的应用。

生产集成注意事项

Seedance 2.5 API 工作流仍需要和任何生产视频 API 一样的运维设计。

从后端发起调用

把 API 密钥存放在服务端，由后端调用 Seedance API，只向客户端暴露你自己的安全端点。

排队和重试任务

使用队列管理并发、重试临时失败，并在视频任务处理期间保持界面响应。

跟踪积分和状态

监控积分消耗、任务状态和错误响应，确保 2.5 API 工作流随规模增长仍可预测。

Seedance 2.5 API 与标准 v2 用法

2.5 API 是基于 Seedance API v2 的工作流选择。快速短片用它，质量或时长更重要时切换到标准用法。

2.5 API 偏速度

需要快速反馈时，使用 fast 路由、更短时长和更聚焦提示词。

标准 v2 偏质量

当电影级质量和更丰富场景是重点时，使用标准 Seedance 2.0 模型路径。

两者共享同一 API 基础

2.5 工作流和标准 v2 用法的鉴权、计费、状态轮询和响应解析保持一致。

能力2.5 工作流标准 v2 用法
模型提示seedance-2.0seedance-2.0
最佳时长5-15 秒5、10 或 15 秒
最佳用途预览、批量、快速迭代最终创意、更丰富叙事
API 形态相同 /v2/generate 和 /v2/status相同 /v2/generate 和 /v2/status

Seedance 2.5 API 常见问题

面向评估 Seedance 2.5 API 风格集成的开发者。

是否有单独的 Seedance 2.5 API 端点？

有。请在 Seedance API v2 中使用 model seedance-2.0。当前公开路由是 POST /v2/generate，然后 GET /v2/status。

Seedance 2.5 API 最适合什么？

适合短预览、社交视频测试、产品运动草稿和高频提示词迭代。

2.5 API 工作流支持图生视频吗？

支持。把 1 到 4 个图片 URL 放入 images 字段，并用提示词聚焦描述需要的运动。

应该从哪个时长开始？

Mini 支持 4 到 15 秒之间的任意整数时长。快速预览可从 8 秒开始，需要更完整场景时再增加时长。

支持哪些宽高比？

Mini 文生视频接受 16:9、9:16、4:3、3:4、1:1、21:9 和 adaptive。请选择匹配投放位置的比例。

请求如何鉴权？

每次请求都传 Authorization: Bearer YOUR_API_KEY。密钥应保存在后端，不能暴露在客户端代码中。

如何拿到最终视频 URL？

使用 task_id 轮询 GET /v2/status。状态为 SUCCESS 时，从 data.response[0] 读取第一个视频 URL。

它支持任意编程语言吗？

支持。Seedance 2.5 API 工作流使用标准 HTTPS 和 JSON，可用于 cURL、Python、Node.js、Go、Java 等 HTTP 客户端。

可以直接从浏览器调用 API 吗？

不建议。应使用后端或 BFF 保护 API 密钥、校验提示词、限制速率并处理重试。

计费如何处理？

Seedance API 使用积分。成本取决于模型和时长，因此 2.5 规划的短 fast 任务更容易预测。

能从 2.5 工作流升级到标准 Seedance 2.0 吗？

可以。保留相同端点，在需要更高质量生产渲染时调整模型提示、时长和提示词策略。

完整 API 文档在哪里？

打开 Seedance 2.0 API v2 文档，可查看完整请求结构、响应示例、定价表和错误码。

构建你的第一个 Seedance 2.5 API 任务

创建 API 密钥，发送一个简短的 Mini 请求，把轻量级 AI 视频生成接入你的产品。

从 API 密钥开始 打开 API 文档对比 Mini API 指南