seedance-2.0-fast API

使用精确模型 ID seedance-2.0-fast。请求中的模型名必须与本页完全一致。

认证与入口

使用 Modelflare API Key，通过 https://modelflare.dev/v1 发送请求。网关入口为 POST /v1/videos。

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

创建任务

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast",
    "content": [{"type": "text", "text": "一只白猫在雨夜霓虹街道上奔跑，电影感跟拍"}],
    "resolution": "720p",
    "duration": 5,
    "generate_audio": false
  }'

任务查询与下载

提交成功后保存任务 ID。使用 GET /v1/videos/{task_id} 轮询，完成后使用 GET /v1/videos/{task_id}/content 下载；结果地址可能过期，应及时转存。

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

请求要点

Seedance 使用 content[] 表达文字、帧和参考媒体；资产管理接口单独记录在Seedance 素材管理中。

请求参数

Seedance 采用统一的多模态异步请求。将文字和媒体按顺序放入 content[]，媒体角色决定首帧、尾帧或参考素材工作流。

字段	必填	说明
model	是	seedance-2.0-fast
content[]	是	text、image_url、video_url、audio_url；用 role 标记媒体用途
resolution	否	480p / 720p (default 720p)
ratio	否	21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / adaptive
duration	否	-1 自动选择，或 4–15 秒
generate_audio	否	是否生成同步对白、音效和背景音
tools	否	仅在官方支持的文生视频场景使用 web_search
watermark	否	是否添加水印

输入与输出限制

当前模型支持 480p、720p；时长可使用 -1 自动选择，或填写 4–15 秒，帧率固定 24fps。多模态参考最多 9 张图片、3 个视频和 3 段音频；音频不能单独输入，至少要有一个参考图片或视频。参考媒体使用 content[] 的 role 标记，首帧/首尾帧、编辑和延长工作流互斥。本模型不支持 frames、camera_fixed、output_format 和 omni_reference_task_type。

官方工作流示例

Seedance 2.0 系列支持文生视频、首帧/首尾帧、多模态参考、视频编辑、视频延长和仅文生视频可用的联网搜索。媒体必须按 text、image、video、audio 顺序组织。

多模态参考

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast",
    "content": [
      {"type": "text", "text": "@image1 performs the movement from @video1, paced to @audio1"},
      {"type": "image_url", "image_url": {"url": "https://example.com/character.jpg"}, "role": "reference_image"},
      {"type": "video_url", "video_url": {"url": "https://example.com/motion.mp4"}, "role": "reference_video"},
      {"type": "audio_url", "audio_url": {"url": "https://example.com/music.mp3"}, "role": "reference_audio"}
    ],
    "generate_audio": true, "ratio": "16:9", "duration": 11
  }'

视频编辑与联网搜索

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.0-fast", "content": [{"type": "text", "text": "Macro shot of cherry blossoms in spring"}],
    "generate_audio": true, "ratio": "16:9", "duration": 11,
    "tools": [{"type": "web_search"}]
  }'

错误与失败任务

参数不符合模型契约时，创建接口会返回带 request ID 的 4xx。异步任务也可能在创建成功后进入 failed；轮询响应中的 error_code 和 error_message 才是该任务的最终原因。不要把同一请求改成另一种 JSON 结构重试。

支持范围

本页只覆盖 Modelflare 的模型生成/编辑调用。搜索或地图增强、声音管理、元素库管理等资源型接口不属于本页的公开调用范围，也不需要作为模型请求字段传入。

价格与计费

本模型按 Token 计费。请查看模型价格页查看当前销售价、参考原价和完整规格。

注意

本页只说明 Modelflare 的公开接口；可用字段和限制以本页当前版本为准。