Seedance 参数与素材

四个企业 Seedance 型号都使用 POST /v1/videos。先按 视频生成 跑通提交、轮询与下载，再添加参考素材。

型号与输出

实际开放型号和报价仍以企业实时目录为准。2.0 与 2.5 没有 480p 档；不要沿用 Mini 的默认参数调用它们。

基本字段

时长优先级为 seconds、顶层 duration、metadata.duration。只写一处最清楚；自动时长不要同时写 seconds。素材优先级为顶层 content、metadata.content、images、image，建议统一用 content。

一次请求几条（n）

n 是顶层字段，只能写 1 到 4 的整数。当前部署只支持 1 条：不写或写 1 正常；写 2 到 4 会在预扣之前被拒绝，返回错误码 video_batch_unavailable，不会扣费、也不会发出上游请求。非法值（null、布尔、小数、非整数字符串、0、负数、超过 4）返回 invalid_video_parameters。只认顶层 n，写在 metadata 里不生效。

要生成多条，请分别提交多次，每次一个 n=1 请求。

常用 metadata

draft: false 和 service_tier: default 可以带，没有额外效果。metadata.tools 只接受纯文本请求，且联网搜索不另收费用；上游没返回次数时不要当成 0 次。

2.5 的首帧、首尾帧和显式 edit / extend 必须设 ratio: adaptive。显式 edit 还必须使用自动时长 duration: -1。

当前四型号不要传 draft: true、service_tier: flex、seed、camera_fixed 或 frames。需要镜头不动，写进 prompt，例如「固定机位」。不保证一定锁住。

不要把 Grok 的 reference_images、aspect_ratio 当作 Seedance 参考素材参数。

素材角色与数量

一次请求只选首帧、首尾帧或参考素材中的一种模式。

2.5 的「30」是参考视频与参考音频的合计秒数上限，不是参考图张数；两个型号的参考图上限都是 9 张。

使用你有权处理、可由服务访问的 HTTPS 素材。下列 example.com 地址都是占位值，需替换为真实文件；不要发送需浏览器 Cookie 才能访问的地址。

首尾帧示例

{
  "model": "seedance-2.5",
  "prompt": "镜头从花园入口缓慢移动到木屋前，保持画面风格一致",
  "seconds": "5",
  "content": [
    {"type":"image_url","image_url":{"url":"https://example.com/first.png"},"role":"first_frame"},
    {"type":"image_url","image_url":{"url":"https://example.com/last.png"},"role":"last_frame"}
  ],
  "metadata": {"resolution":"720p","ratio":"adaptive","return_last_frame":true}
}

参考图片示例

{
  "model": "seedance-2.0-mini",
  "prompt": "参考图片中的人物走进花园，保持人物服装和外形一致",
  "seconds": "5",
  "content": [
    {"type":"image_url","image_url":{"url":"https://example.com/character.png"},"role":"reference_image"}
  ],
  "metadata": {"resolution":"720p","ratio":"16:9"}
}

视频编辑示例

2.0 系通过提示词和参考视频描述编辑或延长，不传 omni_reference_task_type。2.5 可以显式指定编辑：

{
  "model": "seedance-2.5",
  "prompt": "保持人物和镜头运动，把背景改为黄昏的海边",
  "duration": -1,
  "content": [
    {"type":"video_url","video_url":{"url":"https://example.com/source.mp4"},"role":"reference_video"}
  ],
  "metadata": {"resolution":"720p","ratio":"adaptive","omni_reference_task_type":"edit"}
}

仍提交到 /v1/videos，得到新任务 ID。不要改用 Grok remix 路径。2.5 显式编辑的单个输入视频应为 4–30 秒。

文件准备

图片用 jpeg / png / webp / bmp / tiff / gif，2.0 系与 2.5 另支持 heic / heif；宽高比 0.4–2.5，边长 300–6000 像素，单张小于 30 MB。视频用 MP4 或 MOV，单个不超过 200 MB，帧率 24–60；2.0 系参考视频单个 2–15 秒，2.5 普通参考单个 2–30 秒，2.5 显式编辑单个 4–30 秒。音频用 WAV 或 MP3，单个不超过 15 MB；2.0 系单段 2–15 秒，2.5 单段 2–30 秒。请求体不超过 64 MB。还需满足上表的总时长限制。

格式合规不代表内容一定通过，素材读取和审核错误以任务返回的 error.message 为准。

请求头

创建、查询与下载都使用同一套请求头：

Authorization: Bearer sk-YOUR_ENTERPRISE_API_KEY
Content-Type: application/json

GET /v1/videos/{task_id}/content 可能先返回 302 跳转到临时地址；跟随跳转即可，但不要把 API Key 转发给文件托管域名（curl 用 -L，不要用 --location-trusted）。

列表与删除

# 列表：只返回当前企业 Key 创建的本站 Seedance 任务，新到旧
curl --fail-with-body "https://enterprise.beefapi.com/v1/videos?limit=20&order=desc&model=seedance-2.5" \
  -H "Authorization: Bearer $BEEFAPI_KEY"

# 用游标继续翻页（has_more 为 true 时，即使 data 为空也要继续）
curl --fail-with-body "https://enterprise.beefapi.com/v1/videos?limit=20&cursor=<next_cursor>&order=desc" \
  -H "Authorization: Bearer $BEEFAPI_KEY"

# 取消排队中的任务，或隐藏已完成结果
curl --fail-with-body -X DELETE "https://enterprise.beefapi.com/v1/videos/$VIDEO_ID" \
  -H "Authorization: Bearer $BEEFAPI_KEY"

删除结果后下载返回 404，已转存到外部的地址不保证立刻失效。不要把删除理解成一定退款。

结果与计费

成功后读取 metadata.url 或使用 下载接口。2.5 选择 MOV 时应以实际 Content-Type 和文件格式保存，不能仅改后缀声称是 MP4。

metadata.usage.total_tokens 返回时可用于观察视频用量；缺失不能当作 0。Seedance 按实际视频 token 与分辨率对应单价结算，带参考视频时使用对应价格档。相同每 token 单价不意味着不同分辨率的总费用相同；自动时长和更长视频也会改变用量。最终金额、预扣和退回分开看 计费记录。