Seedance 2.5 API
面向开发者和智能体的 Seedance 2.5 API 实用指南:当前访问状态、计费模式、请求构建器、真实代码示例及 API 密钥交接。
Seedance 2.5 API 介绍
什么是 Seedance 2.5 API?
Seedance 2.5 API 是一款前沿的生成式视频模型,能将多种输入——包括文本提示词、图像、视频片段和音频参考——转化为单一、连贯的视频序列,或称“连续镜头”。它专为开发者和创作者设计,旨在通过编程方式为营销、电影制作、游戏开发和创意探索等应用场景生成高质量视频内容。此 API 通过 EvoLink 等第三方提供商访问,代表了 AI 驱动视频合成技术的下一代演进。
Seedance 2.5 API 有哪些主要特性?
Seedance 2.5 API 为 AI 视频生成提供了一套强大的功能集:
-
多模态输入:根据文本提示词生成视频,并可选择性地使用图像、视频和音频参考来调节输出,以实现精确的风格和内容控制。
-
延长时长与分辨率:可创建时长 4 至 30 秒的视频片段,预期发布时支持 480p 和 720p 分辨率。
-
电影级画质:该模型旨在生成具有强烈电影感的视频内容,支持高级视觉效果,如体积光、运动模糊、逼真的材质纹理(例如玻璃、水、金属)以及复杂的摄像机运动。
-
开发者优先工具:提供全面的集成资源,包括详细的 OpenAPI 模式 (
openapi.json)、机器可读的上下文文件 (llms-full.txt) 以及预构建的请求示例,以加速开发。 -
异步处理:视频生成任务以异步方式处理。您提交请求,接收任务 ID,然后轮询其完成状态或使用回调 URL,这使其适合生产工作流。
如何使用 Seedance 2.5 API?
使用 Seedance 2.5 API 遵循一个清晰的、分步的集成流程:
-
查阅文档:首先查看官方指南站点提供的资源,包括示例提示词、请求模式 (
openapi.json) 和智能体上下文文件。 -
构建请求:使用交互式请求构建器或手动构建 JSON 负载,指定
model("seedance-2.5-reference-to-video")、文本prompt、期望的duration(4-30 秒)、quality(480p/720p) 以及任何参考文件的 URL。 -
获取 API 密钥:您必须从 EvoLink 等提供商处获取
EVOLINK_API_KEY。### 重要提示:请勿硬编码此密钥;应将其安全存储为环境变量。 -
发起 API 调用:向 Seedance 2.5 端点发送 POST 请求,将您的负载和 API 密钥置于授权标头中。
-
获取视频:API 返回一个任务 ID。轮询此端点直至任务状态完成,然后从提供的 URL 下载生成的视频。
Seedance 2.5 API 的价格是多少?
由于服务处于预发布阶段,Seedance 2.5 API 的公开定价尚未正式公布。预计成本将围绕使用量构建,可能基于视频时长、分辨率和生成请求数量等因素。官方建议是,将所有成本估算视为初步信息,并在服务全面启动后向 API 提供商(例如 EvoLink)核实最终定价。请务必查看提供商的控制面板和文档,以获取最新、最准确的定价信息。
使用 Seedance 2.5 API 的有用提示
-
利用详细提示词:为获得最佳效果,请精心构思高度描述性、具有电影感的提示词。将期望的场景分解为带有时间线的故事板(例如
[0-10 秒]: ...)。提供的示例是极佳的模板。 -
发送前验证:在进行实时 API 调用前,务必根据预期的发布限制验证您的请求参数——尤其是时长、分辨率和参考文件数量。
-
构建灵活架构:在集成代码中设计可配置的模型参数。这使您能够轻松在不同视频生成模型(如 Seedance 2.0)之间切换,或在 Seedance 2.5 全面可用时进行适配。
-
从示例开始:使用展示示例中的“复制提示词”功能,以了解 API 有效响应的细节水平和结构要求。
-
为异步工作流做好准备:设计您的应用程序以处理视频生成的异步特性,使用轮询或 Webhook 回调来避免阻塞进程。
关于 Seedance 2.5 API 的常见问题
Seedance 2.5 API 可用于生产环境吗?
不可以。Seedance 2.5 API 目前处于预发布状态。访问权限“预计”提供,在规划任何生产集成之前,您应确认所选提供商是否支持。请构建好您的代码使其就绪,但在获得官方发布确认之前,请勿将其用于实时服务。
我可以同时生成音频和视频吗?
可以。该 API 支持为视频生成原生音频。在您的请求中,可以设置 "generate_audio": true。您还可以提供音频参考来影响生成片段的音效氛围。
支持哪些类型的参考文件?
该模型支持图像、视频和音频参考。您可以在请求中提供这些文件的 URL,以指导生成视频的风格、构图、色彩分级和氛围。请查阅提供商的文档,了解每个请求允许的参考文件数量限制。
如何将其与 AI 编程智能体集成?
向您的 AI 智能体提供主要上下文 URL (https://seedance25api.io/llms-full.txt) 和 OpenAPI 模式 (https://seedance25api.io/openapi.json)。智能体随后可以生成必要的集成代码。关键是要指示智能体向您索要 EVOLINK_API_KEY,而不是自行虚构一个。
如果我需要立即生成视频,而不是等待 Seedance 2.5,该怎么办?
本指南建议使用 ### Seedance 2.0 作为当前可用的替代方案。如果您今天就需要生成视频,可以在为 2.5 版本升级准备集成的同时,通过 EvoLink 平台探索使用 Seedance 2.0。
