seedance-2.0 API

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

示例输出seedance-2.0POST /v1/videos5.1s

请求参数：duration=5resolution=1080pratio=16:9

提示词：One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.

生成该示例的请求

{
  "model": "seedance-2.0",
  "prompt": "One continuous take, no cuts. An empty indoor swimming pool at night, tiled walls and underwater lights. A swimmer in a chrome-finish suit stands on the edge and lifts both arms; the water answers by leaving the pool, rising as a single rotating column of turquoise that twists up past the roof beams and holds there, the emptied tiles glowing underneath. The camera starts low at the pool edge, cranes up alongside the column and tilts to look down into the drained basin. One hard cyan key from the underwater lights, warm sodium spill from the high windows. Real weight and inertia, spray and refraction, no text.",
  "seconds": "5",
  "duration": 5,
  "resolution": "1080p",
  "ratio": "16:9",
  "aspect_ratio": "16:9"
}

认证与入口

使用 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",
    "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 素材库，等到状态为 Active 后，在 content[] 中改用 asset://素材ID。Modelflare 不提供真人认证。

请求参数

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

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

输入与输出限制

当前模型支持 480p、720p、1080p 和 4k；时长为 4–15 秒。多模态参考最多 9 张图片、3 个视频和 3 段音频；音频不能单独输入。参考媒体使用 content[] 的 role 标记，首帧/首尾帧、编辑、延长和联网搜索工作流有各自限制。 虚拟人像图片必须先上传到素材库；Modelflare 不提供真人认证。

官方工作流示例

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",
    "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", "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 的公开接口；可用字段和限制以本页当前版本为准。

变体

模型 ID	差异
seedance-2.0	本页说明的模型。