Seedance API 火山方舟兼容接入指南

1. 先给结论：先开通再接线

Seedance 请在 独立子站 单独注册或登录，主站账号不能直接使用。把子站控制台给出的地址、Key 和公开模型 seedance-video 配进客户端，再跑一条 10 秒任务打通创建、查询、下载。

配置兼容火山方舟任务字段，也兼容 OpenAI 风格的视频任务入口。页面不硬编码未确认的上游路径；具体 URL、鉴权头和可选字段以控制台接入信息为准。价格和并发治理见Seedance 价格与调用指南，本页只解决“怎么接”。

2. 双协议口径

火山方舟兼容侧常见字段是 model、content、duration。客户端按任务对象提交文本、图片 URL 和时长，然后拿任务 ID 轮询。实际请求请使用 Seedance 子站控制台提供的地址和 Key；下图记录的主站未授权探针只证明当时的鉴权门禁，不是子站接入地址或可用性证明。

两种写法都要保存任务 ID。不要在 HTTP 请求线程里无限等待成片，也不要把下载失败当成生成失败而重新创建。官方字段说明见 火山方舟 Seedance 文档 与 任务接口说明，产品能力见 Seedance 2.5 介绍。核对日期：2026-09-11。

3. 模型和固定价格

这里的价格不是按秒计费：10 秒请求固定 1.50 元，15 秒请求固定 2.50 元，30 秒请求固定 3.50 元。失败请求不产生费用；同一内容重复提交且都成功，会产生两条费用。价格为本站目录参考，最终以控制台为准。

Seedance 2.0 Fast 模型页负责 10/15 秒草稿档，Seedance 2.5 模型页负责 30 秒成片档。对比完整能力请看 2.0 与 2.5 对比；按拍摄时长决策可看 15 秒还是 30 秒。不要把 1.50 元拆成每秒 0.15 元去对比按秒模型。

4. 文生 / 图生 / 首帧 / 参考图

四种输入都走同一套任务对象，区别在 content 里有没有图片，以及图片被客户端解释成首帧还是参考图。生产环境应使用可控有效期的图片地址，日志只保留脱敏 URL、请求 ID 和状态码。

{
  "model": "seedance-video",
  "content": [{"type": "text", "text": "产品包装缓慢旋转，单镜头，无字幕"}],
  "duration": 10
}

{
  "model": "seedance-video",
  "content": [
    {"type": "text", "text": "保持主体和光线一致，镜头向前推进"},
    {"type": "image_url", "image_url": {"url": "https://example.invalid/first-frame.png"}}
  ],
  "duration": 15
}

{
  "model": "seedance-video",
  "content": [
    {"type": "text", "text": "同一主体从中景推到特写，无转场文字"},
    {"type": "image_url", "image_url": {"url": "https://example.invalid/reference.png"}}
  ],
  "duration": 30
}

提交前校验图片 MIME、大小、有效期和 duration。duration 只能是已上线的 10 / 15 / 30，不要填 12 或 20 去“按秒插值”。

5. 异步创建、查询与下载

视频任务采用异步流程：创建请求返回任务 ID，客户端保存 ID 后轮询状态，进入成功终态再下载结果。

建议用指数退避处理 queued/running；收到 429 或网络错误时重试查询而不是重复创建。失败终态不计费，但成功后的重复创建仍是独立请求。下载失败应重试下载，而不是再生成一条 1.50 / 2.50 / 3.50 元的任务。

6. 企业并发与幂等

本站已上线高并发任务配置，但页面不将其表述为固定 QPS 或 SLA。客户端仍应使用队列、幂等键和结果持久化，避免瞬时突发造成重复任务。按模型和时长分别统计成功、失败、取消与下载失败，便于对账。

• 账号：在 Seedance 子站单独注册或登录，确认项目 Key 只给视频任务用。
• 提交前：校验图片和 duration，写好幂等键。
• 提交后：保存任务 ID，不因前端超时再次创建。
• 终态后：成功才计入对应 1.50/2.50/3.50 元；失败记录错误码并释放重试额度。

企业级隔离是把草稿档、成片档和测试环境拆开。统一提交 seedance-video：10/15 秒由 Seedance 2.0 Fast 承接，30 秒由 Seedance 2.5 承接。先用短任务确认构图，再把已验证素材用于 30 秒档。

7. 和按秒视频怎么并列记账

站内 AI 视频 API 价格怎么算 里，Grok / Gemini 视频是按秒目录价。Seedance 不能拆成每秒单价再去比“谁更便宜”。正确做法是按成功条数记账：100 条 10 秒预览是 150 元目录参考，20 条 15 秒是 50 元，10 条 30 秒是 35 元。

失败不计费，所以监控里要把“创建失败”“查询失败”“下载失败”分开。只有成功终态进入成本表。预览与成片分层，才能控制企业预算。

8. 适合 / 不适合

适合：商品短视频、社媒素材、首帧延展、参考图保持和异步批量生产。

不适合：未开通就直接提交生产流量；把固定请求价拆成每秒单价；将官方火山方舟限制当作本站承诺；没有幂等记录就自动重试创建；要求页面承诺固定出片秒数或画质排名。

9. 字段对照与客户端落点

方舟兼容写法强调任务对象：模型、内容列表、时长。OpenAI 兼容写法则把同一组信息送到视频生成入口。无论哪一种，客户端都要有三张表：提交表、任务表、结果表。提交表保存幂等键和原始 duration；任务表保存任务 ID 和最新 status；结果表保存成功后的文件校验，而不是再存一份 Prompt。

轮询间隔由客户端自己定，页面不给固定秒数。queued 和 running 只说明任务还没到终态，不能据此宣传“通常 X 秒出片”。429 时拉长查询间隔；401 时停在认证，不要改模型 ID。下载超时重试下载链路，成功终态已经计费，再创建就是第二条目录价。

10 秒档用来确认构图和主体，15 秒档用来确认动作完整性，30 秒档留给已经过预览的成片。分层的目的是控制试错成本，不是宣称某一档画质更高。

10. 开通后第一天

第一天只跑 seedance-video 的 10 秒任务（自动路由 2.0 Fast）。目标是打通开通状态、Key、任务 ID、查询和下载，而不是追求成片。10 条预览的目录参考是 15 元；在这一步把幂等键和失败不计费核对清楚，再打开 15/30 秒。

如果第一天就把 30 秒档用于试错，10 次成功就是 35 元目录参考，而且成功后的重复提交仍会计费。预览档的意义是把构图错误留在 1.50 元，而不是证明 30 秒“更值”。

子站账号和权限不代替你记录任务 ID。没有任务 ID 的失败截图，无法区分是未注册、鉴权失败、参数错误还是下载失败。

11. 内容审核与高风险提示词

如果认证和参数都正常但任务仍被拒，先排查内容审核，而不是连续重试相同请求。常见高风险方向包括可识别真人或名人、未成年人、性或裸露、血腥暴力、无授权 IP/品牌，以及医疗、政治、宗教、毒品、违法和仇恨内容。

这些是保守的提交前检查项，不是 Seedance 官方政策全文，也不意味着每个平台都会以相同方式处理。合规改写应删除不必要的敏感元素，使用原创素材、虚构成年角色、非血腥动作和无品牌道具，不应以拆词或编码方式规避审核。详细检查表见 Seedance 提示词被拒与内容安全指南。

12. 常见问题

Seedance 的接口和火山方舟一样吗？

本站配置兼容火山方舟任务字段和异步流程，也兼容 OpenAI 风格视频入口；实际地址、鉴权方式和可用参数以控制台接入信息为准。

支持哪些输入？

支持文生视频、图生视频、首帧和参考图。不同客户端对图片 URL、MIME 和尺寸有额外校验，应先做小任务。

需要单独开通吗？

需要在 Seedance 独立子站 单独注册或登录；主站账号与子站不互通。

失败会扣费吗？

失败请求不计费；成功后的重复请求按独立条目计费。

本文价格来自本站模型目录，核对日期：2026-10-03。官方文档链接用于字段对照，不把官方配额推导为本站 QPS、成功率、出片速度或质量排名。