bytedance-seedance-2-0

ByteDance Seedance 2.0（Fast）

通过 EachLabs Predictions API 使用 ByteDance Seedance 2.0。Seedance 2.0 可生成电影感视频，并原生同步音频（音效、环境音、口型同步语音），还具备逼真的物理效果和导演级镜头控制。

两个模型标识：

标识	类别	用途
bytedance-seedance-2-0-text-to-video-fast	文本生成视频	根据提示词生成视频
bytedance-seedance-2-0-image-to-video-fast	图像生成视频	为起始帧添加动画（可选添加结束帧）

“Fast”版本优先快速处理，适用于高吞吐量工作流，同时保留该系列的角色一致性和物理效果。

适用场景

• 用户要求使用“Seedance 2.0”“ByteDance 视频”，或希望获得 Seedance 风格的效果。
• 需要原生音频在同一轮生成（对白、音效、环境音）——无需单独进行 TTS/口型同步处理。
• 电影感动态、逼真的物理效果，或导演级镜头语言（“缓慢推进”“焦点转换”）。
• 时长为 4–15 秒，分辨率为 480p 或 720p。
• 图像生成视频，并通过结束帧控制片段的落点。

如需比较更广泛的视频模型（Veo、Kling、Sora、Pixverse、Hailuo 等），请参阅 eachlabs-video-generation。

身份验证

Header: X-API-Key: <your-api-key>

设置 EACHLABS_API_KEY 环境变量。在 eachlabs.ai/dashboard/api-keys 获取密钥。

预测流程

1. （建议）检查架构 — GET https://api.eachlabs.ai/v1/model?slug=bytedance-seedance-2-0-text-to-video-fast（或 i2v 标识）。
2. POST https://api.eachlabs.ai/v1/prediction，传入 model、version: "0.0.1" 和 input。
3. 轮询 GET https://api.eachlabs.ai/v1/prediction/{id}，直到 status 为 "success" 或 "error"，也可以使用 Webhook。
4. 从 output（字符串）中提取视频 URL。

快速开始 — 文本生成视频

curl -X POST https://api.eachlabs.ai/v1/prediction \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "model": "bytedance-seedance-2-0-text-to-video-fast",
    "version": "0.0.1",
    "input": {
      "prompt": "Cinematic slow push-in on a lone astronaut standing at the edge of a Martian canyon at dusk, dust drifting across their boots, distant wind, subtle helmet reflections",
      "resolution": "720p",
      "duration": "6",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

典型处理时间：约 120 秒。

快速开始 — 图像生成视频

curl -X POST https://api.eachlabs.ai/v1/prediction \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $EACHLABS_API_KEY" \
  -d '{
    "model": "bytedance-seedance-2-0-image-to-video-fast",
    "version": "0.0.1",
    "input": {
      "prompt": "Camera slowly pushes from wide to medium close-up as the lion roars at golden hour. Warm amber light rakes across the mane. Narrator (weathered British male, 50s): \"He has ruled this land for seven years.\"",
      "image_url": "https://your-cdn.example.com/lion.jpg",
      "resolution": "720p",
      "duration": "8",
      "aspect_ratio": "16:9",
      "generate_audio": true
    }
  }'

典型处理时间：约 150 秒。

起始帧到结束帧的转场

传入 end_image_url 来锁定最终帧，并让模型在两帧之间插值生成动态效果：

{
  "model": "bytedance-seedance-2-0-image-to-video-fast",
  "version": "0.0.1",
  "input": {
    "prompt": "Smooth parallax zoom through the scene, crossfading into the second look",
    "image_url": "https://your-cdn.example.com/frame-start.jpg",
    "end_image_url": "https://your-cdn.example.com/frame-end.jpg",
    "duration": "6",
    "resolution": "720p"
  }
}

轮询

curl https://api.eachlabs.ai/v1/prediction/{PREDICTION_ID} \
  -H "X-API-Key: $EACHLABS_API_KEY"

状态	含义
processing	仍在运行 — 再次轮询
success	已完成 — 读取 output（视频 URL）
error	失败 — 读取 message / details

Webhook（轮询的替代方案）

在创建请求体中传入 "webhook_url": "https://your.host/path"。EachLabs 会发送 POST 请求：

{
  "exec_id": "prediction-uuid",
  "status": "succeeded",
  "output": "https://...",
  "error": ""
}

status 为 "succeeded" 或 "failed"。请在 30 秒内返回 2xx 响应。

参数（两个模型标识的大部分参数相同）

参数	类型	必填	默认值	选项	说明
prompt	string	是	—	—	文本提示词。对于 i2v，用于描述动态/动作；支持时间轴提示和原生音频对白。
image_url	string	是（仅限 i2v）	—	JPEG / PNG / WebP，最大 30 MB	起始帧。必须是可公开访问的 HTTPS URL。
end_image_url	string	否（仅限 i2v）	—	JPEG / PNG / WebP，最大 30 MB	最终帧；模型会在 image_url 与此图像之间进行插值。
resolution	string	否	720p	480p、720p	480p = 更快/更便宜，720p = 均衡。
duration	string	否	auto	auto、4…15	片段时长（秒）。auto 表示让模型根据提示词选择时长。
aspect_ratio	string	否	auto	auto、21:9、16:9、4:3、1:1、3:4、9:16	对于 i2v，auto 会根据输入图像推断宽高比。
generate_audio	boolean	否	true	—	同步音效、环境音和口型同步语音。开启或关闭的费用相同。
seed	string	否	—	—	用于复现结果的提示值——结果仍可能略有差异。
end_user_id	string	否	—	—	你的终端用户标识符。

定价

按输出视频秒数动态计费：

分辨率	费率
480p	$0.1129 / 秒
720p（默认）	$0.2419 / 秒

音频生成不会改变费用。6 秒的 720p 视频片段约为 $1.45；10 秒的 480p 视频片段约为 $1.13。

提示词技巧

• 时间线提示：使用时间或转场词来排列各个节拍——“广角镜头：……切换到特写镜头：……最后：……”。与单句提示相比，Seedance 2.0 更能遵循时间结构。
• 带原生音频的对白：将台词写在引号中，并描述说话者（“饱经风霜的英国男性旁白，50 多岁，声音沉稳权威，说道：……”）。唇形同步和环境音会在同一轮生成。
• 镜头语言：使用真实的电影术语（“缓慢推近”“移焦”“向左移动轨道车”“手持”“升降镜头向上”）。模型会遵循导演级的提示。
• 物理效果提示：提及重量、动量和材料间的相互作用（“靴子落地时尘土飞扬”“旋转后布料缓缓垂落”），以启用逼真的物理效果。

速率限制与限制

限制	值
创建请求	每个密钥每分钟 100 次
并发预测	每个密钥 10 次
文件输入	仅限可公开访问的 HTTPS URL（JPEG/PNG/WebP，最大 30 MB）。不支持 data-URI 和 localhost。

错误

错误正文：{ "status": "error", "message": "...", "details": "..." }

代码	含义
400	输入无效
401	缺少或无效的 X-API-Key
404	未知模型或预测 ID
429	请求过于频繁——请稍后重试
5xx	使用指数退避策略重试

安全限制

• 禁止加载任意 URL：image_url / end_image_url 必须指向你自己的 HTTPS 可访问存储（S3、GCS、CDN）。未经验证，不要转发用户粘贴的 URL。
• 禁止使用第三方 API 令牌：切勿通过 input 转发服务提供商令牌——身份验证仅使用 EachLabs API 密钥。
• 调用前先验证：在构造 input 之前，通过 GET /v1/model?slug=<slug> 获取实时的 request_schema。

参数参考

完整的逐 slug 表格（含默认值和选项）请参阅 references/MODELS.md。