跳转到主要内容
Krea 提供 ByteDance Seedance 视频生成模型的 API 访问。在 Krea 上使用 Seedance API,你可以从文本生成视频、让图像动起来,或借助图像、视频和音频参考来引导生成。请求使用 Krea API token 和 https://api.krea.ai 基础 URL。

可用的 Seedance API 模型

这些模型支持文本生成视频、首帧与尾帧、参考媒体以及原生音频。Seedance 2.5 还支持草稿模式,即一种低成本的 480p 预览,之后可以按完整质量渲染。各模型当前的请求结构请参阅 API 参考。提交任务前请查看 API 定价 ↗;价格取决于模型和生成设置。
Krea 的 Seedance 2.0 和 2.0 Fast 端点在基础模型之外还提供可选的 Krea 提示词增强和超分放大。Seedance 2.5 提供可选的 Krea 提示词增强。对于带有 reference_videos 的 Seedance 2.5 视频编辑请求,输出时长和宽高比取决于源视频;这类请求会忽略 duration 和 aspect_ratio。

获取 Seedance API 密钥

按照 API 密钥与计费 创建 Krea API token 并为 API 余额充值。将 token 存储在服务器的 KREA_API_KEY 环境变量中,并以 Authorization: Bearer $KREA_API_KEY 的形式发送;切勿在浏览器代码中暴露它。 Krea 应用算力与 API 余额相互独立。通过 Krea API 发起的 Seedance 请求使用你所在工作区的 API 余额。

生成视频

向 Seedance 2.5 端点提交提示词即可进行文本生成视频。以下示例请求一段 5 秒、720p 的横向视频。
使用 npm install @krea-ai/sdk 安装 JavaScript SDK。REST 请求返回的是 job_id,而不是生成好的视频。每隔 2–5 秒轮询一次 GET /jobs/{job_id},直到 status 变为 completed,然后从 result.urls[0] 读取视频 URL。当状态为 failed 或 cancelled 时停止轮询。SDK 的 jobs.wait 方法会替你处理轮询。
cURL
在生产环境集成中,请使用 webhooks 接收完成事件。有关任务状态和失败处理,请参阅 任务生命周期 和 错误与调试。

让图像动起来

进行 Seedance 图生视频时,使用同一个端点,并在请求中添加 start_image。可传入公开可访问的图像 URL、已上传资源的 URL 或 base64 data URI。
将 start_image 替换为你自己的图像 URL。如需控制最后一帧,请添加 end_image。如需参考引导生成,请根据所选模型的 API 结构 使用 reference_images、reference_videos 和 reference_audios。

使用草稿模式预览镜头

Seedance 2.5 草稿模式会为你的请求快速渲染 480p 预览,并按 480p 费率计费。在为完整渲染付费之前,可以用它检查构图、运动和提示词意图。草稿满意后,将其任务 ID 发回同一个端点。模型随后会以完整质量重新生成同一个镜头,而不是重新开始一个新镜头。
1

生成草稿

在普通的 Seedance 2.5 请求中添加 "draft": true。草稿始终以 480p 渲染,因此与 draft 一起发送的任何 resolution 都会被忽略。
cURL
轮询返回的 job_id,直到其 status 为 completed,然后查看 480p 视频。
2

以完整质量渲染草稿

将草稿的任务 ID 作为 draft_job_id 发送。请在创建草稿后的 7 天内完成;超过期限后,草稿将无法再渲染,需要重新生成草稿。
cURL
只发送 draft_job_id。完整渲染会复用草稿的提示词、参考素材、种子、时长和宽高比,因此无需再次发送;即使你包含了这些参数,Krea 也会忽略。默认输出为 1080p。添加 "resolution": "4k" 可渲染为 4K。
使用 JavaScript SDK 的相同流程:
JavaScript

草稿模式计费

草稿按 480p 费率计费。完整渲染按草稿时长、以其输出分辨率作为一次独立的 Seedance 2.5 生成计费。如果草稿使用了参考视频,完整渲染将按 ByteDance 报告的 token 计费,这些 token 包含草稿参考视频的时长。 以相同分辨率再次渲染同一草稿时,会返回已有的完整质量任务,而不会创建并计费新任务。

草稿模式的限制和错误

  • 只有 Seedance 2.5 支持草稿模式。Seedance 2.0、2.0 Fast 和 2.0 Mini 不支持。
  • 你只能在同一个工作区中渲染自己的草稿。
  • 不要在同一个请求中同时发送 draft: true 和 draft_job_id。草稿无法从另一个草稿渲染。

常见问题

Krea 是否提供 ByteDance Seedance API?

是的。Krea 通过位于 https://api.krea.ai 的 REST API 提供 ByteDance Seedance 2.5、Seedance 2.0、Seedance 2.0 Fast 和 Seedance 2.0 Mini。使用 Krea API token 进行身份验证,并向上文列出的 Seedance 端点提交请求即可。

Seedance 能同时用于文本生成视频和图生视频吗?

可以。发送 prompt 即可进行文本生成视频,添加 start_image 即可让图像动起来。两种工作流使用同一个 Seedance 模型端点,并返回一个异步任务。

能否在为完整质量付费前预览 Seedance 视频?

可以,使用 Seedance 2.5。发送 "draft": true 即可按 480p 费率获得 480p 预览。如果满意,请在 7 天内将草稿的任务 ID 作为 draft_job_id 发送,以 1080p 渲染同一个镜头。请参阅草稿模式。

我需要单独的 ByteDance API 密钥吗?

不需要。通过 Krea 调用 Seedance 使用的是你的 Krea API token 和工作区 API 余额。这些请求无需另外发送 ByteDance 凭证。

Krea 上的 Seedance API 费用是多少?

当前 Seedance 价格和可用设置请参阅 Krea API 定价 ↗。API 用量与 Krea 应用算力分开计费。失败和取消的任务不会计费。

我可以从 AI agent 调用 Seedance 吗?

可以。将 agent 连接到 Krea MCP 服务器,即可发现可用的视频模型及其结构。你也可以直接在应用中调用 REST API 或 JavaScript SDK。