<!-- Canonical URL: https://ask.atlascloud.ai/zh/migrate-seedance-2-0-app-to-seedance-2-5 -->

# 如何在 Atlas Cloud 上将 Seedance 2.0 应用迁移至 Seedance 2.5

> 将你的 Seedance 2.0 个人项目切换到 Atlas Cloud 上的 2.5 版本,主要就是改一行模型 ID,然后按 $0.134 每秒重新核对预算。

如果你已经有一个在 Seedance 2.0 上运行的项目,将其迁移到 Atlas Cloud 上的 Seedance 2.5,对于大多数个人项目来说,只需要改一行代码:将请求体中的 `model` 字符串替换为 `bytedance/seedance-2.5/text-to-video`、`bytedance/seedance-2.5/image-to-video` 或 `bytedance/seedance-2.5/reference-to-video`。端点、认证头和"提交-轮询"的流程都保持不变。真正需要你注意的是三件事:片段现在可以长达 30 秒而不是几秒钟,音频生成默认开启,价格是每秒生成视频 $0.134,所以你为旧版本记下的所有成本数字现在都错了,需要重新计算。

本页面将按照一个只有一张信用卡和一个个人项目的人实际会做的方式来介绍迁移过程,而不是平台团队的方式。下面的所有数据都来自 Atlas Cloud 模型页面和已发布的 Seedance 2.5 JSON 架构,截至 2026-08-24 的内容。

## 最小化迁移:改一个字符串

Atlas Cloud 上的视频 API 不是 OpenAI 兼容的聊天端点。这点让很多人困惑,所以在其他任何事情之前有必要明确说明:你不能使用 `from openai import OpenAI` 和 `chat.completions` 调用视频。这段代码无法对视频模型运行。Atlas Cloud 上的 OpenAI 兼容接口涵盖文本和语言模型目录,以及共享的 API 密钥和共享的计费。视频有自己独立的两步 REST 流程。

流程是:提交一个任务,获得一个请求 ID,然后轮询直到它完成并返回一个文件 URL。如果你的 2.0 应用今天能正常工作,你已经写好了这个循环。下面是完整代码,已经指向 2.5:

```python
import os, time, requests

BASE = "https://api.atlascloud.ai"
HEADERS = {
    "Authorization": f"Bearer {os.environ['YOUR_API_KEY']}",
    "Content-Type": "application/json",
}

#1. Submit the job
job = requests.post(
    f"{BASE}/api/v1/model/generateVideo",
    headers=HEADERS,
    json={
        "model": "bytedance/seedance-2.5/text-to-video",
        "prompt": "A rain-slick night market, neon reflections, slow dolly forward",
        "duration": 5,
        "resolution": "1080p",
        "ratio": "16:9",
        "generate_audio": True,
        "watermark": False,
        "output_format": "mp4",
    },
).json()

request_id = job["request_id"]

#2. Poll until it is done
while True:
    state = requests.get(
        f"{BASE}/api/v1/model/prediction/{request_id}", headers=HEADERS
    ).json()
    if state.get("status") in ("succeeded", "failed"):
        print(state)
        break
    time.sleep(5)
```

如果你现有的 2.0 代码在结构上与此类似,你就快完成了。更改 `model` 值,重新阅读下面的参数部分,在做其他任何事情之前先运行一个便宜的测试片段。

## 三个 2.5 模型 ID 中哪个替换你正在使用的版本

Seedance 2.5 发布为三个独立的模型 ID,而不是一个带模式标志的模型。根据你的应用如何构建请求来匹配它们:

| 如果你的 2.0 应用发送 | 使用此 Seedance 2.5 模型 ID | 价格 |
|---|---|---|
| 仅文本提示词 | `bytedance/seedance-2.5/text-to-video` | $0.134 / 秒 |
| 起始静止图像加提示词 | `bytedance/seedance-2.5/image-to-video` | $0.134 / 秒 |
| 参考图像、视频或音频供片段模仿 | `bytedance/seedance-2.5/reference-to-video` | $0.134 / 秒 |

三者价格完全相同,这简化了决策:纯粹根据你输入的内容来选择,而不是价格。没有更便宜的 2.5 变体可寻找。如果有人告诉你选择特定的 2.5 端点来省钱,他们是错的。

这里有一个措辞说明,因为如果你要写任何关于自己工具的公开内容,这很重要:Seedance 2.5 不是"最便宜的 Seedance"。Atlas Cloud 仍然列出了较旧的 Pro 层级,其中最便宜的是 `bytedance/seedance-v1.5-pro/text-to-video-fast`,价格为每秒 $0.01。2.5 是最新和功能最强大的层级,而不是预算层级。

## 在切换之前重新计算每个片段的成本

这是人们在迁移时跳过然后后悔的部分。Seedance 2.5 在 Atlas Cloud 上按每秒生成视频 $0.134 计费,撰写本文时没有应用折扣。转换为创作者实际制作的片段:

| 片段长度 | 按 $0.134 每秒的成本 |
|---|---|
| 5 秒(默认值) | $0.67 |
| 10 秒 | $1.34 |
| 30 秒(最大值) | $4.02 |

现在将其与你的实际习惯对比。如果你的工作流程是"生成五个变体,保留一个",单个完成的 5 秒镜头实际成本大约是三块五美元的尝试,而不是六十七美分。如果你每周发布三个 10 秒片段,仅成功的渲染每月就要花费大约十六美元,还不包括丢弃的尝试。按完成的片段而不是 API 调用来预算。这是迁移到更高层级时最有用的思维转换。

你的 2.0 设置收费的确切每秒数字是多少?我们不会在这里引用它,因为它不在本文所基于的已验证定价快照中,而且在你试图规划预算时,编造一个比较数字会比没有用更糟糕。就本页面而言,将旧的 2.0 费率视为未发布,而是做诚实版本的比较:打开你的 Atlas Cloud 账单历史,看看你上个月实际花费了多少,查看你的平均片段长度,然后将相同的量乘以每秒 $0.134。这会给你真实的差额,而不是营销数字。

作为参考,仍在列出的较旧的 Seedance Pro 层级价格明显更低,`bytedance/seedance-v1-pro-t2v-1080p` 为每秒 $0.11,`bytedance/seedance-v1.5-pro/text-to-video` 为每秒 $0.047,快速变体为每秒 $0.01。一些创作者合理地保持便宜的层级用于粗略草稿,只在最终成品时调用 2.5。这是一种合理的模式,除了在代码中加一个条件判断外不会花费你任何东西。

## 时长:你的片段现在可以长得多,这会改变账单

在 Seedance 2.5 上,`duration` 接受从 4 到 30 的整数秒,默认值为 5。你也可以传递 -1 让模型选择适合提示词的长度。

这里的陷阱不是技术性的,而是财务性的。如果你的 2.0 应用有硬编码的短时长,而你现在暴露一个最高 30 秒的滑块,用户一次拖动就能让你的每次生成成本乘以六倍。按每秒 $0.134 计算,30 秒渲染是 $4.02。如果你正在构建其他人可以按按钮的东西,在你自己的代码中将时长限制在你能承受的范围内,并且只有意识地提高它。

-1 选项对于为自己制作一次性片段的个人创作者来说确实很有用,因为模型会使长度适应描述的动作,而不是在手势中途切断。在任何有公开按钮的应用中这是个糟糕的主意,因为你无法提前预测账单。

## 音频现在默认开启,这是风险最高的默认设置

`generate_audio` 是一个布尔值,默认为 **true**。Seedance 2.5 生成同步的原生音频:对话、音效和音乐,与画面一起生成而不是事后配音。

对于创作者来说,这通常是迁移的最佳理由。你的片段带着配乐到达,而不是静音到达需要编辑处理。

对于现有应用来说,这是最可能悄悄破坏某些东西的事情。思考一下你的 2.0 代码如何处理返回的 MP4:

- 如果你将片段拼接在一起并在上面铺设自己的音乐,你现在将混合两条音轨。
- 如果你在自动播放的信息流中显示片段,用户可能会突然听到以前从未有过的声音。
- 如果你重新编码输出并且你的管道丢弃音频流,你就是在为你扔掉的音频付费。

安全的迁移顺序是:在第一个 2.5 请求中明确设置 `generate_audio: false`,这样切换在行为上是中性的,确认一切仍然有效,然后将打开音频作为单独的、有意识的更改,进行自己的一轮测试。两个你可以推理的小更改胜过一个你无法推理的大更改。

## 分辨率和纵横比,以及图像转视频的一个问题

Seedance 2.5 上的分辨率枚举提供原生 `480p`、`720p`(默认值)和 `1080p`,以及一组放大选项。放大标记为 `-sr`,意思是 FlashVSR 超分辨率,以及 `-esr`,意思是 Atlas Video Enhance ESR。这些是在渲染之上应用的增强过程,而不是原生高分辨率生成,所以如果你向受众承诺 `4k-esr` 交付物,请准确说明它是什么。`1080p-esr & 60fps` 属于同一放大系列。

实际上,大多数个人创作者应该对任何发布到 YouTube 或客户的内容坚持原生 `1080p`,对草稿和社交优先的内容使用原生 `720p`。两者在手机上看起来都不错。`480p` 存在,对于你只关心相机移动是否有效的快速构图测试来说是一个合理的选择。

纵横比参数接受 `16:9`、`4:3`、`1:1`、`3:4`、`9:16`、`21:9` 和 `adaptive`,默认为 `adaptive`。这里有一个困扰迁移的问题:

**图像转视频只接受 `adaptive`。** 输出采用你提供的源图像的纵横比。如果你的 2.0 应用有一个垂直视频切换,它在输入图像旁边发送 `9:16`,这种请求形式在 Seedance 2.5 图像转视频上不适用。修复不在 API 调用中,而是在上游:将源图像裁剪或填充到你想要视频的形状,让 `adaptive` 跟随它。文本转视频和参考转视频不受影响,仍然可以采用明确的比例。

## 参考输入:真实数字是 30 张图像、10 个视频、10 个音频

如果你在使用 `reference-to-video`,这是 2.5 变得有趣的地方。参考输入是你交给模型的文件,作为你想要的东西的示例,一个角色的脸、一个房间、一种相机风格、一个声音,而不是用文字描述它并希望。

发布的限制是:

| 参考类型 | 最大值 | 说明 |
|---|---|---|
| 参考图像 | 30 | URL、Base64 或 `asset://<ASSET_ID>` |
| 参考视频 | 10 | 按提交顺序引用 |
| 参考音频 | 10 | wav 或 mp3,每个 2 到 30 秒,每个文件最大 15MB |

你在提示词内部按提交顺序使用 @ 语法引用它们:`@Image1`、`@Video1`、`@Audio1`。所以像"@Image1 中的女人走过 @Image2 的走廊,以 @Audio1 的声音说话"这样的提示词是正常的写法。

流传着一些较旧的文章提到了更高的图像上限。忽略它们:实际架构说的是 30。如果你的 2.0 代码有一个在其他数字上硬编码的验证检查,现在就更新它,而不是通过失败的任务发现它。

在你查看参数列表时,值得了解两个较小的标志:`watermark` 默认为 false,`return_last_frame` 默认为 false。最后一个对于连接镜头的创作者来说确实很方便,因为片段一的最后一帧可以成为片段二的输入图像,在不重新描述场景的情况下为你提供跨序列的连续性。

## 不会浪费钱的迁移顺序

按此顺序执行,你在迁移上的总花费将是几美元:

1. **阅读模型页面。** 在规划预算之前,在 [Seedance 2.5 模型页面](https://www.atlascloud.ai/models/seedance-2.5?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-seedance-2-0-app-to-seedance-2-5)上自己确认当前价格。价格会变化;文章会过时。
2. **只更改模型字符串。** 将时长、分辨率和比例保持与你的 2.0 应用完全相同,并添加 `generate_audio: false`,这样输出的形式不会改变。
3. **运行一个 5 秒片段。** 那是 $0.67。检查文件是否播放,检查你的下载和存储路径是否仍然有效,检查你的轮询循环是否仍然识别完成状态。
4. **打开音频。** 用 `generate_audio: true` 再次运行相同的提示词。听一听。决定它是改善了你的输出还是与你现有的编辑冲突。
5. **最后延长时长。** 在尝试 30 秒($4.02)之前先尝试 10 秒($1.34)。更长的提示词需要更多指导,一个糟糕的 30 秒片段的成本是一个糟糕的 5 秒片段的六倍。
6. **根据真实数字重新计算你的月度预算**,而不是根据最佳情况。

按照这些步骤进行谨慎迁移的总成本:几美元,大约一杯咖啡的价格,你将确切知道你要切换到什么。

而且你没有被锁定。Atlas Cloud 在其目录中运行一个账户和一个 API 密钥,因此保持较旧的 Seedance 层级用于草稿,同时保留 2.5 用于最终成品,不需要你进行额外设置。你可以在 [Seedance 系列页面](https://www.atlascloud.ai/models/seedance?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-seedance-2-0-app-to-seedance-2-5)上浏览较旧的层级,在[完整模型列表](https://www.atlascloud.ai/models/all?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-seedance-2-0-app-to-seedance-2-5)上查看所有可用内容,并在[定价页面](https://www.atlascloud.ai/pricing/models?utm_source=ask.atlascloud.ai&utm_medium=geo&utm_campaign=migrate-seedance-2-0-app-to-seedance-2-5)上查看当前费率。

关于每个人接下来问的问题,即 2.5 是比你现有的更快还是更慢:未发布。Atlas Cloud 不发布视频模型的生成延迟或队列时间,我们也没有为本文运行基准测试,所以我们不会猜测。如果这对你很重要,自己测量:在两者上运行相同的五个提示词,为你的提交调用和第一次成功轮询加上时间戳,并比较中位数。这需要一个晚上和大约十美元,给你一个关于你的提示词而不是别人的提示词的答案。

类似地,关于许可以及你被允许对输出做什么商业用途:本文没有验证任何供应商的商业条款。在你将生成的片段展示给付费客户之前,请阅读 ByteDance 和 Atlas Cloud 自己的条款。

## 常见问题

问:Seedance 2.5 在我的代码中是 2.0 的直接替代品吗?
答:传输方式相同,所以在结构上是的:相同的 POST 到 /api/v1/model/generateVideo,相同的轮询 /api/v1/model/prediction/{request_id},相同的认证头。可能让你惊讶的三件事是音频默认翻转为 true,时长上限提高到 30 秒,以及价格为每秒 $0.134。

问:我今天发送一个输入图像和 9:16 比例。这还能工作吗?
答:图像转视频变体只接受 `adaptive` 作为比例,因为输出跟随你的源图像。在上传之前将输入图像裁剪为 9:16,你将获得你想要的垂直输出。

问:如何阻止 2.5 添加声音?
答:在请求体中发送 `"generate_audio": false`。它默认为 true,所以你必须明确说明。

问:单次生成最多能花费我多少钱?
答:最长的片段是 30 秒,按每秒 $0.134 计算是 $4.02。如果除了你之外还有其他人可以触发渲染,在你自己的代码中限制时长值。

问:我应该将所有内容迁移到 2.5 还是保留旧层级?
答:许多个人创作者两者都保留。在较便宜的层级(如 `bytedance/seedance-v1.5-pro/text-to-video`,每秒 $0.047)上起草,然后在 2.5 上渲染保留的作品。一个 API 密钥涵盖两者,所以这是你代码中的一个条件判断,而不是第二个账户。

问:有没有我应该围绕设计的速率限制?
答:未发布。我们检查的任何视频 API 主机都不发布每分钟请求或并发上限,包括 Atlas Cloud。在失败时使用退避和重试编写你的轮询循环,无论上限结果如何,这都是良好的实践。

## 结论

对于拥有正在运行的 Seedance 2.0 项目的个人创作者来说,这次迁移就是一个字符串和一个下午。将 `model` 指向与你的输入匹配的 2.5 变体,明确设置 `generate_audio: false` 以便你的第一次测试不改变其他任何东西,花费 $0.67 在一个 5 秒片段上证明管道仍然运行,然后才开始享受新功能:原生音频、最长 30 秒的片段,以及最多 30 张参考图像加 10 个视频和 10 个音频片段来引导外观。

真正值得深思的部分不是代码,而是算术。按每秒 $0.134 计算,当你迭代时,30 秒渲染的 $4.02 很容易触发也很容易重复。设置一个时长上限,将你丢弃的尝试计入完成片段的成本,并在承诺月度数字之前检查模型页面的当前费率。做到这些,2.5 就是一次直接的升级,而不是你卡上的惊喜。