方式一
通过 EvoLink API 接入
适合：产品后端、批量任务、自动化工作流
在你的服务端直接调用 EvoLink 统一视频 API，自己控制模型 ID、参数、任务队列、callback 和结果存储。
- 1在 Playground 用真实 brief 验证效果和成本
- 2在控制台创建 EvoLink API Key
- 3根据输入选择 T2V、I2V 或 R2V 模型 ID
- 4提交任务并通过轮询或 HTTPS callback 获取结果
Seedance 2.5 API
ByteDance / BytePlus-视频生成-Seedance 2.5 视频最低档低至 ~$0.084 / 秒-可用
文生视频图生视频参考生视频4-30 秒真人质感视频视频 + 音频
生产路由已上线
模型特点
4-30 秒视频 · 最多 50 个多模态参考 · 480p / 720p
适用场景
广告、UGC、真人质感口播、短剧
输入
文本、图片或参考素材
输出
视频
在接入 API 之前，先试试 Seedance 2.5 的效果。
测试 Seedance 2.5 的输出质量，估算积分消耗，在正式接入前生成一个样本。
创建样本
选择视频模式，输入提示词，设置参数。Mature Mode
默认关闭。开启可放宽内容限制（计费 +10%）；违法及违规内容始终拦截。
关
时长5s
画质
输出格式
画面比例
生成音频
同步音频，无额外费用。
网络搜索
可选，使用时单独计费。
预估：~$1.47100.5 cr
就绪
历史记录
生成历史会显示在这里
充值前，先了解测试成本。
从一次样本的成本开始，选择测试预算。如需详细费率可展开查看。
首次测试成本
文生视频 - 5s - 480p积分46.7
一条 5s 480p 样本
大约费用$0.68
充值 $10 大约可测试 14 次。
用 480p 低成本迭代提示词，最终质量检查再切到 720p。
测试预算参考
按预计测试次数选择金额。$10
约 14 次
适合首次验证。
$50
约 73 次
适合提示词迭代。
$100
约 146 次
适合正式接入前使用。
常见成本示例
草稿迭代480p~$0.68
质量检查720p~$1.47
视频参考720p · 按 10 秒计费~$1.79
以 5 秒输出估算。最终费用可能因模式、参考素材和附加项而异。
模型定价
Standard| 模式 | 480p | 720p | 计费方式 |
|---|---|---|---|
| 文生视频标准 | $0.136/s9.34 cr/s | $0.293/s20.09 cr/s | 输出视频秒数 |
| 图生视频标准 | $0.136/s9.34 cr/s | $0.293/s20.09 cr/s | 输出视频秒数 |
| 参考生视频图片或音频参考 | $0.136/s9.34 cr/s | $0.293/s20.09 cr/s | 输出视频秒数 |
| 参考生视频视频参考 | $0.083/s5.71 cr/s | $0.179/s12.23 cr/s | 输入+输出秒数 |
| 视频编辑视频参考 | $0.083/s5.71 cr/s | $0.179/s12.23 cr/s | 输入+输出秒数 |
| 视频延长视频参考 | $0.083/s5.71 cr/s | $0.179/s12.23 cr/s | 输入+输出秒数 |
文生视频
标准 · 输出视频秒数
480p $0.136/s · 9.34 cr/s
720p $0.293/s · 20.09 cr/s
图生视频
标准 · 输出视频秒数
480p $0.136/s · 9.34 cr/s
720p $0.293/s · 20.09 cr/s
参考生视频
图片或音频参考 · 输出视频秒数
480p $0.136/s · 9.34 cr/s
720p $0.293/s · 20.09 cr/s
参考生视频
视频参考 · 输入+输出秒数
480p $0.083/s · 5.71 cr/s
720p $0.179/s · 12.23 cr/s
视频编辑
视频参考 · 输入+输出秒数
480p $0.083/s · 5.71 cr/s
720p $0.179/s · 12.23 cr/s
视频延长
视频参考 · 输入+输出秒数
480p $0.083/s · 5.71 cr/s
720p $0.179/s · 12.23 cr/s
按视频时长和分辨率计费。视频参考输入可能按输入+输出时长计费。自动时长（duration: -1）与 Video Edit 按实际产出时长结算，向上取整到 0.1 秒。
| 项目 | 适用场景 | 价格 | 积分 |
|---|---|---|---|
| Web Search每次请求 | 当提示词需要时事、产品或真实世界参考时使用。 | $0.0006 / request | 0.04 cr |
大多数首次测试只需支付视频生成费用。登录用户可在控制台查看分组实时价格。
Seedance 2.5 API 是什么？
Seedance 2.5 是 ByteDance / BytePlus 的多模态视频生成模型，API 已于 2026 年 8 月 7 日开放。EvoLink 现已提供文生视频、图生视频、参考生视频、视频编辑和视频延长五条 API 路由，用于生成 4–30 秒、480p 或 720p 视频。它更适合需要长镜头、多参考素材、角色或产品一致性以及同步音频的广告、UGC、对话和故事工作流。
Seedance 2.5 API 功能与五种生成模式
不是参考素材越多越好。真正决定首次成片率的，是路由选择是否正确，以及角色、产品、场景、动作和音频参考是否职责清晰。
文生视频 API
seedance-2.5-text-to-video适合从脚本、广告 brief 或分镜生成 4–30 秒视频，支持同步音频与可选网络搜索。
图生视频 API
seedance-2.5-image-to-video使用 1 张图片作为首帧，或用 2 张图片约束首尾帧，适合产品图、人物图和已确定的构图。
参考生视频 API
seedance-2.5-reference-to-video可组合图片、视频和音频参考，适合角色、产品、运镜、动作与声音需要共同约束的任务。
视频编辑 API
seedance-2.5-video-edit用提示词编辑已上传的视频——增删、替换或重绘画面元素，输出时长与比例跟随输入视频。
视频延长 API
seedance-2.5-video-extend把已上传的视频向前或向后延长，动作与运镜连贯，单次最多新增 30 秒。
4–30 秒长镜头
可为广告、对话或故事保留进场、主动作和收尾素材。
最多 50 个参考
最多 30 张图片、10 个视频和 10 段音频。
同步音频
将画面、对话、音效和节奏放在同一生成任务中验证。
异步任务
通过 task ID、轮询和 HTTPS callback 管理长耗时视频生成。
两种方式接入 Seedance 2.5：EvoLink API 或 Agent
需要嵌入产品、运行批量任务时，直接使用 EvoLink API；需要快速创作、试验或让 Agent 完成接入时，可在 Codex、Claude 或 Gemini 中调用。两种方式共用 EvoLink API Key、余额、模型路由和任务记录。
方式二
通过 Agent 调用
适合：Codex、Claude、Gemini 中的创作和开发任务
把生成目标、素材与验收条件交给 Agent，让它选择模型路由、组装请求、跟踪任务并返回结果。你不需要手写每一步接入代码。
- 1在本地环境配置 EVOLINK_API_KEY，不要把 Key 写进代码或 Prompt
- 2在 Agent 中说明输出目标、参考素材、时长和分辨率
- 3让 Agent 调用 Seedance 2.5 路由并保存 task ID
- 4由 Agent 轮询终态、下载结果并汇报失败原因
Seedance 2.5 功能与能力：能做什么？工作流与评测示例
用于准备 Prompt 与评测集的示例片段，并非已验证的 Seedance 2.5 API 输出。
Seedance 2.5 API 代码示例与错误处理
这里只展示最短可运行流程：创建任务、保存返回的 task ID，然后轮询或等待 HTTPS callback。完整参数和响应结构请进入 API 标签查看。
cURL
curl -X POST https://api.evolink.ai/v1/videos/generations \
-H "Authorization: Bearer $EVOLINK_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "seedance-2.5-text-to-video",
"prompt": "A premium product film with controlled camera motion",
"duration": 8,
"quality": "720p",
"aspect_ratio": "16:9",
"generate_audio": true,
"callback_url": "https://your-domain.com/webhooks/video"
}'
# Save the returned task ID, then query:
curl https://api.evolink.ai/v1/tasks/{task_id} \
-H "Authorization: Bearer $EVOLINK_API_KEY"参数校验失败
检查 duration 是否在 4–30，quality 是否为 480p/720p，以及素材数量和文件格式是否符合路由要求。
认证或余额问题
检查 Authorization Bearer Token，并在控制台确认当前余额与任务账单。
内容或素材被拒绝
检查人物权利、品牌素材、可读文字、敏感内容与输入素材的合规性。
任务失败或超时
Seedance 2.5 任务最终状态为失败时不收取该次生成费用。请保留 task ID 并查看终态，先确认是参数、审核还是执行失败，再决定是否重试。
Callback 未收到
callback_url 必须是公开 HTTPS URL，不能指向 localhost 或私有网段；同时要保存 task ID 作为轮询回退方案。
Seedance 2.5、Seedance 2.0 和 MiniMax H3 怎么选？
2.5 不是所有任务的默认升级。用同一份 brief、相同输入素材和统一验收标准，比较可用镜头率、重跑次数和项目总成本。
| 选型维度 | Seedance 2.5 | Seedance 2.0 | MiniMax H3 |
|---|---|---|---|
| 更适合 | 16–30 秒长镜头、多参考、UGC、广告和对话 | 成熟 Seedance 工作流、短镜头和快速迭代 | 2K 短镜头、动作和高细节画面 |
| 时长 | 4–30 秒 | 4–15 秒 | 4–15 秒 |
| 分辨率 | 480p / 720p | 480p / 720p / 1080p（部分 Standard 档更高） | 2K |
| 输入方式 | 文本、首尾帧、图片/视频/音频参考 | 文本、图片和多模态参考 | 文本、首尾帧和多模态参考 |
| 成本决策 | 核算可用镜头成本，重点看长镜头是否减少拼接与重跑 | 保留现有基线，通过同 brief 测试是否值得升级 | 用同一 brief 比较 2K 成片的可用率与实时价格 |
为什么通过 EvoLink 接入 Seedance 2.5？
Seedance 2.5 API 接入的难点不只是发出一次请求，而是在上线后继续管理模型选择、价格、参考素材、异步任务、Webhook、失败排查和替代路由。EvoLink 把这些工作放进一套统一视频 API 和控制台，让团队可以先测试，再接入，最后根据可用镜头率和项目总成本决定路由。
一个 API Key 管理 Seedance 2.5 与其他视频模型
文生视频、图生视频和参考生视频共用 EvoLink 的鉴权、账户余额和任务基础。团队只需在服务端安全管理一个 EVOLINK_API_KEY，再按输入类型选择对应模型 ID。
如果业务还需要 Seedance 2.0、MiniMax H3 或其他视频模型，不必为每个供应商重复维护账户、Key、余额和鉴权代码。产品可以保留同一套任务与账单框架，再根据镜头时长、清晰度和用例切换模型路由。
先在 Playground 测试，再把 Seedance 2.5 接入生产
在真正接入之前，可以先用真实的广告 brief、人物图、产品图、运镜参考和音频素材在 Playground 里测试。这比用一条演示 Prompt 猜测生产效果更可靠。
评测时应同时记录可用镜头率、重跑次数和人工返工，而不只看每秒价格。先暴露角色漂移、Logo 变形、动作模糊、素材冲突和声画不同步，再确定路由、Prompt 结构与验收标准。
Seedance 2.5 失败任务不扣费，任务与账单可核对
Seedance 2.5 任务最终状态为失败时，EvoLink 不收取该次生成费用。创建任务后仍应保存 task ID，并在控制台核对任务终态、失败原因和账单记录。
视频生成是异步任务。生产接入应通过轮询或公开 HTTPS callback 获取终态，并为 callback 丢失、重复通知和超时设置回退逻辑；遇到失败时，再根据参数、审核或执行原因决定是否重试。
API 与 Agent 共用同一套生成基础
产品后端可以直接调用 EvoLink API 运行批量视频任务；创作和开发团队也可以将任务交给 Codex、Claude 或 Gemini。两种方式共用 API Key、模型路由、余额和任务记录。
开发者、运营和内容团队可以基于同一套生成基础协作，不需要为手写代码和 Agent workflow 维护两套分离的账户与成本记录。用户可以直接复制页面中的 Agent 提示词。
Seedance 2.5 API 常见问题
围绕 API 可用性、模型 ID、价格、生成限制、模型选择与失败排查的高意图问题。
Seedance 2.5 API 现在可以接入吗？
可以。EvoLink 已提供文生视频、图生视频和参考生视频三条 Seedance 2.5 路由。你可以先在 Playground 验证效果，再使用同一个 EvoLink API Key 接入。
Seedance 2.5 有哪些 API 模型 ID？
当前模型 ID 为 seedance-2.5-text-to-video、seedance-2.5-image-to-video 和 seedance-2.5-reference-to-video。请根据输入类型选择路由，不要向文生视频路由传入媒体 URL。
可以通过 Agent 使用 Seedance 2.5 吗？
可以。在 Codex、Claude 或 Gemini 中配置 EVOLINK_API_KEY 后，可以让 Agent 选择 Seedance 2.5 模型 ID、提交生成任务、轮询状态并返回视频结果。API Key 应保存在环境变量中，不要直接写入 Prompt 或前端代码。
Seedance 2.5 API 怎么计费？
Seedance 2.5 按视频时长和分辨率计费，参考视频还可能计入输入时长。请以本页 Pricing 区和 Playground 的实时估算为准，Readme 不再硬编码一套价格。
Seedance 2.5 生成失败会扣费吗？
不会。Seedance 2.5 任务最终状态为失败时，EvoLink 不收取该次生成费用。请保留 task ID，并在控制台核对任务终态、失败原因和账单记录。
Seedance 2.5 支持多长的视频和哪些分辨率？
当前 EvoLink 路由支持 4–30 秒视频，输出分辨率为 480p 或 720p。建议先用 480p 检查构图、动作和角色一致性，再将通过的方案升到 720p。
Seedance 2.5 最多可以使用多少参考素材？
参考生视频路由最多接受 30 张图片、10 个视频和 10 段音频，单次请求总数不超过 50 个。素材越多不代表结果一定越好，应先给角色、产品、场景、动作和音频分配清晰职责。
Seedance 2.5 支持同步音频吗？
支持。你可以在生成时开启音频，也可以在参考生视频模式中提供音频参考。对话、口型和声画节奏仍建议使用固定测试集验收。
Seedance API 模型家族
在同一个 EvoLink 账户和 API Key 下对比 Seedance 各代路由，再根据镜头时长、参考方式、速度和成本选择模型。
Seedance 2.5
当前页面当前页面。适合 4–30 秒长镜头、多参考素材、角色与产品一致性工作流。
其他相关视频生成 API
当 Seedance 2.5 不是默认选择时，可以用相同 brief 对比分辨率、镜头时长、音频、动作稳定性和项目总成本。
API Reference
Select endpoint
Model ID
Endpoints
Authentication
All APIs require Bearer Token authentication.
Header
Authorization:
Bearer YOUR_API_KEYPOST
/v1/videos/generationsCreate Text-to-Video
Generate a 4-30 second Seedance 2.5 video at 480p or 720p with optional synchronized audio.
Processing is asynchronous. Use the returned task ID to query pending, processing, completed, or failed status.
Request Parameters
modelstringRequiredDefault: seedance-2.5-text-to-videoFixed value: seedance-2.5-text-to-video
Example
seedance-2.5-text-to-videopromptstringRequiredNon-empty text prompt, up to 10,000 tokens.
Example
A cinematic product film with slow camera movementdurationintegerOptionalDefault: 5Output duration in seconds.
| Value | Description |
|---|---|
| 4-30 | Any integer from 4 through 30 |
| -1 | Automatic: the model picks the best length, billed by actual output |
Notes
- Duration directly affects billing
Example
5qualitystringOptionalDefault: 720pOutput resolution.
| Value | Description |
|---|---|
| 480p | Lower cost |
| 720p | Default |
Example
720paspect_ratiostringOptionalDefault: adaptiveOutput aspect ratio.
| Value | Description |
|---|---|
| adaptive | Select automatically |
| 16:9 | 16:9 |
| 9:16 | 9:16 |
| 1:1 | 1:1 |
| 4:3 | 4:3 |
| 3:4 | 3:4 |
| 21:9 | 21:9 |
Example
adaptivegenerate_audiobooleanOptionalDefault: trueGenerate synchronized audio at no additional video-generation charge.
Example
truecontent_filterbooleanOptionalDefault: trueKeep the standard safety filter enabled. false routes to the relaxed-content channel and adds 10% to generation pricing.
Example
trueoutput_formatstringOptionalDefault: mp4Output container format.
| Value | Description |
|---|---|
| mp4 | Best compatibility (default) |
| mov | yuv444p + PCM, higher color fidelity for editing workflows; browsers may not preview it |
Notes
- No extra charge
Example
mp4model_params.web_searchbooleanOptionalDefault: falseAllow Text-to-Video to search current web content when needed.
Notes
- Text-to-Video only
- Billed only when a search is triggered
Example
falsecallback_urlstringOptionalOptional HTTPS callback URL for terminal task updates.
Notes
- Triggered on completion, failure, or cancellation
- HTTPS only, max 2048 characters, private hosts are not allowed
Example
https://your-domain.com/webhooks/videoRequest Example
{
"model": "seedance-2.5-text-to-video",
"prompt": "A cinematic product film with slow camera movement",
"duration": 5,
"quality": "720p",
"aspect_ratio": "adaptive",
"generate_audio": true,
"content_filter": true
}