Seedance 2.5 API 快速入门：使用 Atlas Cloud 生成您的第一个视频

您阅读了 Seedance 2.5 的发布公告，您围绕 30 秒生成的剪辑构思了一个产品功能，现在您想编写代码。然后您遇到了每个开发人员都会遇到的问题，即一个新发布的模型：功能页面已上线，但您实际可以从应用程序调用的端点完全是另一个问题。

这是情况的真实版本，以及一个尊重它的快速入门。Atlas Cloud 已经发布了一个 Seedance 2.5 系列页面，承诺在与已经服务 Seedance 2.0 和 1.5 的统一端点上提供 Day-0 访问。在撰写本文时，该列表标记为“即将推出”，并且尚未发布 Atlas Cloud Seedance 2.5 的价格。这实际上意味着好消息：您今天针对实时 Seedance 层构建的集成，与您在 2.5 发布时运行的集成是相同的。唯一改变的是模型字符串。

所以这个快速入门有两个作用。它今天从一个真实的端点生成一个真实的视频，并且它构建了您的代码和提示，以便升级只需一行差异。

Seedance 2.5 实际发布了什么

根据 ByteDance 官方 Seedance 2.5 页面，这是一个下一代音视频联合生成模型，专为 30 秒的故事讲述而构建，具有精确的参考控制和强大的编辑功能。值得围绕设计的具体声明：

• 单次生成最长 30 秒，可选择延长两次以实现更长、更完整的故事讲述
• 更流畅、更一致的运动，以及更逼真的视觉效果
• 更精确的参考视频理解，捕捉意图、构图和电影语言，而不仅仅是传输运动
• 在更广泛的音频和视觉编辑请求中实现更可靠的编辑
• 白模型控制和绿屏编辑，以及专业的摄像机运动和表演调度，旨在实现复杂的制作工作流程

请注意列表中没有的内容：没有基准表，没有分辨率阶梯，没有参考资产计数。您看到的任何类似内容都是某个人的营销修饰，而不是第一方规格表。请根据上述声明进行构建。

步骤 1：从控制台获取密钥

在 console.atlascloud.ai 登录并创建一个 API 密钥。没有押金，没有最低承诺，也没有等待列表，因此该密钥可以立即按需使用。一个密钥涵盖了文本、图像和视频的 300 多个模型的完整目录，在一个计费账户下，这是本快速入门的关键部分：您现在生成的密钥将是调用 Seedance 2.5 的相同密钥。

将其存储为环境变量，切勿存储在源代码中。ATLASCLOUD_API_KEY 是一个不错的名称。

步骤 2：提交视频作业

Atlas Cloud 上的视频生成是一个两步异步 REST 调用，而不是聊天完成。您 POST 一个作业并获得一个预测 ID，然后您轮询该 ID 直到渲染完成。任何 HTTP 客户端都可以，因此无需安装供应商 SDK，也无需学习新的身份验证方案：它是您刚刚生成的密钥上的一个 bearer token。

pythonCopy
1import os, time, requests
2
3KEY  = os.environ["ATLASCLOUD_API_KEY"]
4BASE = "https://api.atlascloud.ai/api/v1/model"
5HEAD = {"Authorization": "Bearer " + KEY, "Content-Type": "application/json"}
6
7job = requests.post(f"{BASE}/generateVideo", headers=HEAD, json={
8    "model": "bytedance/seedance-2.0/text-to-video",
9    "prompt": "Handheld, subject-following medium shot of a courier weaving through a night market, "
10              "neon reflections on wet asphalt, slight lag on turns.",
11    "duration": 5,
12    "resolution": "720p",
13    "ratio": "adaptive",
14    "bitrate_mode": "standard",
15    "generate_audio": True,
16    "watermark": False,
17}).json()
18
19prediction_id = job["data"]["id"]

响应返回 {"code": 200, "data": {"id": "...", "status": "processing"}}。请注意，model 是一个纯字符串字段。这个细节是本文的整个升级故事，步骤 6 将回到它。

步骤 3：轮询直到渲染完成

一个 5 秒的剪辑不是即时响应，因此将渲染视为一个具有生命周期的作业，而不是一个阻塞调用。轮询预测端点直到 status 达到终端值。

pythonCopy
1while True:
2    r = requests.get(f"{BASE}/prediction/{prediction_id}", headers=HEAD).json()
3    status = r["data"]["status"]
4    if status in ("completed", "succeeded", "failed"):
5        break
6    time.sleep(3)
7
8print(status, r["data"])   # on success the payload carries the output URL(s)

现在而不是以后构建两件事。为轮询循环设置一个上限，这样卡住的作业就不会挂起请求处理程序，并在开始轮询之前持久化预测 ID，这样崩溃的工作程序就可以恢复，而不是为渲染支付两次费用。这两种习惯都将不变地延续到 2.5。

如果您的功能从参考图像或主题参考而不是纯文本工作，则相同的流程适用于不同的模型变体，bytedance/seedance-2.0/image-to-video 或 bytedance/seedance-2.0/reference-to-video。主题参考资产通过 uploadMedia 上传一次，然后以 asset://<id> 形式传递到图像字段中，因此经常出现的角色或产品无需在每次调用时重新上传。

步骤 4：选择一个实时 Seedance 层并了解每秒的成本

Atlas Cloud 按输出视频时长每秒计费。这是您在编写任何代码之前就可以在脑海中完成的算术。目前有三个 Seedance 层：

作为参考，同一密钥上的其他视频模型运行在可比较的范围内：Grok Imagine Video v1.5 为 $0.080/s，Wan 2.7 为 $0.100/s，Kling V3.0 Turbo 标准版为 $0.112，折扣版为 $0.095，MiniMax H3 为 $0.14/s。

选择哪个构建取决于您的 2.5 功能最终会做什么。如果音频是输出的核心，Seedance 1.5 Pro 是已经具有原生同步音频和多语言唇形同步的层，因此您的管道从第一天起就学会处理音轨。如果您正在迭代提示结构并希望每次实验的成本最低，Seedance 2.0 Mini 以 $0.056/s 的价格是显而易见的沙盒。如果您想要最接近生产级当前代渲染的东西，Seedance 2.0 以 $0.112/s 的价格是直接的选择，如果吞吐量比质量的最后增量更重要，则选择 Fast 变体以 $0.09/s 的价格。

5. 在消费前在 Playground 中查看实时价格

在您第一次付费调用之前，在 Atlas Cloud Playground 中打开模型。每个模型都在“运行”按钮旁边显示其实时每模型价格。这比听起来更重要：促销折扣来来去去，而“运行”按钮旁边的数字才是实际计费的数字。在 Playground 中运行一次生成，确认输出是您的功能所需的，然后将设置移植到代码中。

按输出时长每秒计费的模型也使您的预算对话变得微不足道。Seedance 2.0 Mini 上的 10 秒剪辑是 10 × $0.056。没有计算器，没有 token 估算，也没有事后对账步骤。

这与第一方 ByteDance 渠道如何对 Seedance 计费形成对比。在中国火山引擎 Ark 和国际 BytePlus ModelArk 上，计费是基于 token 的：估计 token 消耗是（输入视频时长 + 输出视频时长）× 输出宽度 × 输出高度 × 输出帧率 / 1024，乘以 token 单价，实际使用以 API 响应中的 usage.completion_tokens 字段为准。对于 Seedance 2.0 系列和 Seedance 2.5，当输入包含视频时，会应用最低 token 消耗下限，并且下限取决于分辨率、宽高比和输出时长。ByteDance 发布了定价计算器和最低 token 表正是出于这个原因。

两种模型都是合法的。但是，如果您正在预算 30 秒的渲染，按输出时长每秒计费是心算，而带下限的 token 则需要电子表格。

步骤 6：像 2.5 一样编写镜头描述

这是快速入门中完美转移的部分，因为提示技巧没有版本控制。2.5 的两个功能声明应该改变您今天的写作方式。

精确的参考控制。 ByteDance 声称 2.5 会读取参考视频的意图、构图和电影语言，超越运动传输。提示的含义是您的参考资产不再是运动模板，而开始成为导演的简报。因此，停止编写只描述主题的提示，并开始命名您想要继承的语法：镜头感、构图、剪辑节奏、摄像机是引导还是跟随主题。编写“手持，主体跟随中景，湿沥青上的霓虹反射，转弯时略有延迟”而不是“人物行走，电影感”。

单次生成 30 秒。 5 秒的剪辑是一个镜头。30 秒是一个有结构的场景，2.5 支持在此基础上延长两次。因此，编写具有节拍结构而不是单一静态描述的镜头描述：一个建立节拍，一个变化（转弯、进入、揭示），以及一个解决方案。明确命名摄像机运动和表演调度，因为这些正是 2.5 旨在控制的。主体站在哪里，他们移动到哪里，当他们移动时摄像机做什么。

这两种习惯现在都在实时层上得到了回报。这两种习惯正是 2.5 奖励的。

步骤 7：规划交换

构建您的代码，使模型标识符是配置，而不是字面量。一个常量，从环境或配置中读取：

pythonCopy
1SEEDANCE_MODEL = os.environ.get("SEEDANCE_MODEL", "bytedance/seedance-2.0/text-to-video")

然后将 SEEDANCE_MODEL 传递到步骤 2 硬编码字符串的位置。因为 model 是 generateVideo 主体中的一个 JSON 字符串字段，所以 2.5 发布时的升级确实是一个环境变量。这不是一个小变化的隐喻，而是字面上的一个值。

今天切勿硬编码 Seedance 2.5 标识符，因为 Atlas Cloud Seedance 2.5 模型 ID 尚不存在。从 atlascloud.ai/models 上的目录中获取确切的实时 ID，而不是从文章（包括本文）中复制它们，因为新变体会随着时间的推移而添加。当 2.5 在 Day-0 承诺下发布时，您这边的工作就是那个变量，再加上重新查看“运行”按钮旁边的价格，并重新阅读任何新的请求参数，因为一个支持扩展的 30 秒模型可能会接受 2.0 主体没有的字段。

同时，如果您今天需要 Seedance 2.5 而不是在 Atlas Cloud 发布时，诚实的答案是第一方 ByteDance 渠道：中国的火山引擎 Ark 和国际 BytePlus ModelArk。在聚合器中，有几个处于相同的预发布或 Day-0 承诺状态。

常见问题

问：我现在可以在 Atlas Cloud 上调用 Seedance 2.5 吗？ 答：不能。Atlas Cloud 上的 Seedance 2.5 系列页面标记为“即将推出”，并承诺在与已经服务 Seedance 2.0 和 1.5 的统一端点上提供 Day-0 访问。目前尚未发布其模型 ID 和价格。

问：Seedance 目前在 Atlas Cloud 上收费多少？ 答：Seedance 2.0 为 $0.112/s，Seedance 2.0 Fast 为 $0.09/s，Seedance 2.0 Mini 为 $0.056/s，Seedance 1.5 Pro 为 $0.047/s 或其 Fast 变体为 $0.018/s。计费按输出时长每秒计算，实时价格显示在 Playground 中“运行”按钮旁边。

问：我需要为 Atlas Cloud 上的视频使用特殊的 SDK 吗？ 答：不需要。视频是一个纯粹的 REST 流程：POST /api/v1/model/generateVideo 提交作业，然后 GET /api/v1/model/prediction/{id} 轮询它，两者都使用您的 Atlas Cloud 密钥上的 bearer token 进行身份验证。任何 HTTP 客户端都可以。请注意，视频不通过文本目录使用的 OpenAI 兼容聊天端点，因此不要期望 chat.completions 渲染剪辑。每个模型的请求参数都记录在 atlascloud.ai/docs 上。

问：开始使用需要押金或最低承诺吗？ 答：不需要。Atlas Cloud 是按需付费的，没有押金，没有最低承诺，也没有等待列表，并且 console.atlascloud.ai 上的密钥可以立即使用。

问：如果我以 2.5 为目标，我应该在哪个实时层上进行原型设计？ 答：Seedance 2.0 Mini 以 $0.056/s 的价格用于廉价提示迭代，如果您的管道需要处理原生同步音轨，则选择 Seedance 1.5 Pro，如果需要最接近当前代生产渲染，则选择 Seedance 2.0 以 $0.112/s 的价格。

总结

Atlas Cloud 目前运行 Seedance 2.0、Seedance 2.0 Fast、Seedance 2.0 Mini 和 Seedance 1.5 Pro，使用一个 API 密钥，按输出时长每秒计费，符合 SOC II 认证、HIPAA 合规性以及静态和传输中的加密，并且已承诺在 Seedance 2.5 发布时在这些相同的统一端点上提供 Day-0 服务。