本页目录

Seedance 视频生成接口上线公告

发布日期:2026 年 10 月 10 日 接口域名:https://fzw.ai/

各位用户:

fzw.ai 网关现已上线 Seedance 视频生成服务,采用 OpenAI 兼容接口,支持文生视频、首尾帧控制,以及图片 / 视频 / 音频多模态参考输入。接口已经过完整流程验证,现将使用说明公布如下。

一、接口与鉴权#

项目 说明
视频生成 POST https://fzw.ai/v1/videos
任务查询 GET https://fzw.ai/v1/videos/{task_id}
鉴权方式 请求头携带 Authorization: Bearer $KEY

二、可用模型#

  • seedance-2.0-fast-native
  • seedance-2.0-native
  • seedance-2.5-native

三、请求参数#

字段 类型 必填 说明
model string 是 模型名称,见「可用模型」
prompt string 是 视频生成提示词
seconds number 否 视频时长(秒),如 5
resolution string 否 分辨率,如 720p
aspect_ratio string 否 画面比例,如 16:9
image_url string 否 首帧图片 URL
last_frame_url string 否 尾帧图片 URL
reference_image_urls string[] 否 参考图片 URL 列表
video string 否 参考视频 URL
audio_urls string[] 否 音频参考 URL 列表

四、调用示例#

示例一:首尾帧 + 音频参考

cURL
curl -X POST https://fzw.ai/v1/videos \
  -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0-native",
    "prompt": "the boat drifts across",
    "seconds": 5, "resolution": "720p", "aspect_ratio": "16:9",
    "image_url":      "https://cdn/first.png",
    "last_frame_url": "https://cdn/last.png",
    "audio_urls":     ["https://cdn/score.mp3"]
  }'

示例二:图片 / 视频 / 音频参考

cURL
curl -X POST https://fzw.ai/v1/videos \
  -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{
    "model": "seedance-2.0-fast-native",
    "prompt": "blend these", "seconds": 5, "resolution": "720p", "aspect_ratio": "16:9",
    "reference_image_urls": ["https://cdn/a.png", "https://cdn/b.png"],
    "video":      "https://cdn/ref.mp4",
    "audio_urls": ["https://cdn/bgm.mp3"]
  }'

五、任务提交与结果获取#

  1. 提交成功后立即返回任务 id 与状态 queued:
JSON
{
  "id": "task_xxxxxxxxxxxxxxxx",
  "object": "video",
  "model": "seedance-2.0-fast-native",
  "status": "queued",
  "progress": 0
}
  1. 使用任务 id 轮询查询状态(建议间隔 20~30 秒):
HTTP
GET https://fzw.ai/v1/videos/{task_id}
  1. 状态流转:queued → in_progress(progress 50)→ completed / failed。
  2. 任务完成后,响应中的 video_url 即为视频直链,请及时下载保存(约 24 小时有效):
JSON
{
  "id": "task_xxxxxxxxxxxxxxxx",
  "model": "seedance-2.0-fast-native",
  "status": "completed",
  "progress": 100,
  "seconds": "5",
  "size": "1280x720",
  "cost_usd": 2.82,
  "video_url": "https://ark-acg-beijing.tos-cn-beijing.volces.com/...mp4?X-Tos-Expires=86400&..."
}

六、计费说明#

  • 单次任务费用以响应中的 cost_usd 字段为参考,实际以账户扣费为准。
  • 实测样例:5 秒 720p(1280x720)任务约 2.82 美元。批量调用前,建议先用小任务确认计费。

七、注意事项#

  1. 图片 / 视频 / 音频等素材均需通过公网可访问的 URL 传入。
  2. 生成结果请通过 video_url 及时下载保存,链接约 24 小时有效。
  3. 请求头 Content-Type 需为 application/json。
  4. 首尾帧控制:image_url(首帧)配合 last_frame_url(尾帧)使用。

特此公告。

fzw.ai