Seedance · 火山方舟兼容 · 异步视频

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

本站 Seedance 配置兼容火山方舟视频任务接口。seedance2.0fast 用于 10 秒档,seedance2.5 用于 15/30 秒档;文生、图生、首帧和参考图均可按任务字段提交。模型需单独开通,请联系客服微信 GPT774

更新日期:2026-09-11·失败请求不计费
协议火山方舟兼容
任务异步创建 / 查询
输入文本 / 图片 / 首帧 / 参考图
开通联系客服 GPT774
2026-09-11 对本站 POST /v1/videos/generations 未携带 API Key 的请求返回 HTTP 401 和 API_KEY_REQUIRED
2026-09-11 探针:POST https://www.codex789.com/v1/videos/generations 未携带 Key,返回 HTTP 401,code=API_KEY_REQUIRED。这只证明视频端点有鉴权门禁,不证明出片秒数、QPS 或画质。

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

本站 Seedance 需要单独开通,联系客服微信 GPT774。未开通就按普通文本模型去打 /v1/chat/completions,解决不了视频任务。开通后,把控制台给出的地址、Key 和模型 ID 配进客户端,再跑一条 10 秒任务打通创建、查询、下载。

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

2. 双协议口径

火山方舟兼容侧常见字段是 modelcontentduration。客户端按任务对象提交文本、图片 URL 和时长,然后拿任务 ID 轮询。OpenAI 兼容侧可走本站视频入口 https://www.codex789.com/v1/videos/generations;未携带 Key 时,2026-09-11 探针返回 HTTP 401。

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

3. 模型和固定价格

模型 ID时长档本站目录价计费方式
seedance2.0fast10 秒¥1.50/条成功请求固定一条
seedance2.515 秒¥2.50/条成功请求固定一条
seedance2.530 秒¥3.50/条成功请求固定一条

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

Seedance 2.0 Fast 模型页负责 10 秒草稿档,Seedance 2.5 模型页负责 15/30 秒选型。不要把 1.50 元拆成每秒 0.15 元去对比按秒模型。

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

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

文本生成视频 · 10 秒
{
  "model": "seedance2.0fast",
  "content": [{"type": "text", "text": "产品包装缓慢旋转,单镜头,无字幕"}],
  "duration": 10
}
图生视频 · 15 秒
{
  "model": "seedance2.5",
  "content": [
    {"type": "text", "text": "保持主体和光线一致,镜头向前推进"},
    {"type": "image_url", "image_url": {"url": "https://example.invalid/first-frame.png"}}
  ],
  "duration": 15
}
30 秒成片档
{
  "model": "seedance2.5",
  "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 后轮询状态,进入成功终态再下载结果。

阶段客户端动作记录字段
创建提交模型、内容和时长幂等键、请求 ID、模型 ID
轮询按退避间隔查询终态status、错误码、重试次数
下载读取结果 URL 或 content文件校验、下载状态

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

6. 企业并发与幂等

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

  • 开通:联系 GPT774,确认项目 Key 只给视频任务用。
  • 提交前:校验图片和 duration,写好幂等键。
  • 提交后:保存任务 ID,不因前端超时再次创建。
  • 终态后:成功才计入对应 1.50/2.50/3.50 元;失败记录错误码并释放重试额度。

企业级隔离是把草稿档、成片档和测试环境拆开。10 秒任务用 seedance2.0fast 做预览,确认构图后再用 seedance2.5 出 15/30 秒,避免把试错成本打到 3.50 元档。

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

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

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

8. 适合 / 不适合

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

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

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

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

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

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

11. 开通后第一天

第一天只跑 seedance2.0fast 的 10 秒任务。目标是打通开通状态、Key、任务 ID、查询和下载,而不是追求成片。10 条预览的目录参考是 15 元;在这一步把幂等键和失败不计费核对清楚,再打开 15/30 秒。

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

客服微信 GPT774 只处理开通和权限,不代替你记录任务 ID。没有任务 ID 的失败截图,无法区分是未开通、鉴权失败、参数错误还是下载失败。

9. 常见问题

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

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

支持哪些输入?

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

需要单独开通吗?

需要。请联系客服微信:GPT774

失败会扣费吗?

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

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