Seedance 2.0 / 2.5 视频生成

通过 OpenAI 兼容的视频任务接口调用 Seedance 2.0 / 2.5。接口是异步的：先提交任务拿到 task_id，再轮询任务状态，完成后读取返回的视频地址或通过内容代理下载。

接口地址

OpenAI 兼容入口

操作	方法	路径
上传素材	POST	`/v1/sd/assets`
查询素材	GET	`/v1/sd/assets/{asset_id}`
创建视频任务	POST	`/v1/video/generations`
查询任务状态	GET	`/v1/video/generations/{task_id}`
下载视频内容	GET	`/v1/videos/{task_id}/content`

注意下载路径是 /v1/videos/{task_id}/content（是 videos，不是 video/generations）。

火山 / Ark 兼容入口（推荐对接方使用）

若你已按火山 Ark 文档对接，可直接使用下列路径；请求体 / 响应体与火山一致，只需把 base_url 和 key 换成平台自己的。三组前缀行为完全相同：

操作	方法	等价路径（任选其一）
创建视频任务	POST	`/api/v3/contents/generations/tasks` `/v3/contents/generations/tasks` `/ark/api/v3/contents/generations/tasks`
查询任务状态	GET	`/api/v3/contents/generations/tasks/{task_id}` `/v3/contents/generations/tasks/{task_id}` `/ark/api/v3/contents/generations/tasks/{task_id}`
上传素材	POST	`/api/v3/sd/assets` `/v3/sd/assets` `/ark/api/v3/sd/assets` （亦兼容 `/v1/sd/assets`）
查询素材	GET	`/api/v3/sd/assets/{asset_id}` `/v3/sd/assets/{asset_id}` `/ark/api/v3/sd/assets/{asset_id}` （亦兼容 `/v1/sd/assets/{asset_id}`）

路径写法

/v3/... 是对接文档里常见的简写（省略 /api）。本平台已同时挂载 /v3 与 /api/v3，二者等价。完整字段说明与示例见 Seedance 火山 / Ark 原生入口。

认证方式：

http

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

可用模型

模型	说明	分辨率
`dreamina-seedance-2-0-260128`	标准 Seedance 2.0	`480p`, `720p`, `1080p`, `4k`
`dreamina-seedance-2-0-hc`	真人 / 数字人版（Base），支持 `asset://`	`480p`, `720p`, `1080p`, `4k`
`dreamina-seedance-2-0-fast-260128`	Fast 版本	`480p`, `720p`
`dreamina-seedance-2-0-fast-hc`	Fast 真人 / 数字人版，支持 `asset://`	`480p`, `720p`
`dreamina-seedance-2-0-mini-260615`	Mini 版本	`480p`, `720p`
`dreamina-seedance-2-0-mini-hc`	Mini 真人 / 数字人版，支持 `asset://`	`480p`, `720p`
`dreamina-seedance-2-5-hc`	Seedance 2.5 真人 / 数字人版，支持 `asset://`	`480p`, `720p`
`doubao-seedance-2-0-260128`	兼容别名	`480p`, `720p`, `1080p`, `4k`
`doubao-seedance-2-0-fast-260128`	Fast 兼容别名	`480p`, `720p`

如果后台配置了模型映射，也可以使用站点展示的自定义模型名；最终会被转发到对应的上游 Seedance 模型。

真人 / 身份锁定视频请用任意 *-hc 模型

若参考图是真人，或要引用通过下方「素材接口」章节上传的 asset:// 资产，请使用任一 *-hc 模型（包括 dreamina-seedance-2-5-hc）。非 hc 模型会对真人图片触发隐私安全拦截（InputImageSensitiveContentDetected），且无法读取 asset:// 素材（返回 asset ... is not found）。

请求参数

参数	类型	必填	说明
`model`	string	是	模型名称
`prompt`	string	是	视频生成提示词
`image`	string	否	单张公网图片 URL 或 `asset://` 素材引用
`images`	string[]	否	多张公网图片 URL 或 `asset://` 素材引用
`size`	string	否	分辨率，支持 `480p`、`720p`、`1080p`、`4k`（Fast/Mini 仅 `480p`/`720p`）；默认按 `720p` 计费
`duration`	integer	否	视频时长，单位秒
`seconds`	string	否	视频时长字符串；存在时会覆盖 `duration`
`metadata.resolution`	string	否	透传给上游的分辨率；优先级高于 `size`
`metadata.ratio`	string	否	画幅比例，支持 `adaptive`、`16:9`、`9:16`、`1:1` 等；图生视频传 `adaptive` 时会按参考图自适应画幅
`metadata.generate_audio`	boolean	否	是否生成音频
`metadata.watermark`	boolean	否	是否添加水印
`metadata.return_last_frame`	boolean	否	是否在任务完成后返回最后一帧，可用于续接生成
`metadata.execution_expires_after`	integer	否	任务执行超时时间，单位秒
`metadata.callback_url`	string	否	任务完成回调地址，必须是服务端可访问的 URL
`metadata.content`	array	否	透传上游 content 项，可用于音频、视频等参考素材

prompt 会被转换为上游 content[].type = "text"。image 或 images 会被转换为 content[].type = "image_url"，并标记为参考图片。

`metadata.content[]` 类型与角色

`type`	URL 字段	常用 `role`	用途
`image_url`	`image_url.url`	`reference_image`	普通参考图、人物身份或风格参考
`image_url`	`image_url.url`	`first_frame`	指定视频首帧
`image_url`	`image_url.url`	`last_frame`	指定视频尾帧
`video_url`	`video_url.url`	`reference_video`	动作、镜头或整体视频参考
`audio_url`	`audio_url.url`	`reference_audio`	音频参考；真人/数字人可用于唱歌或对口型

URL 可使用公网 HTTP(S) 地址；HC 模型还可使用 asset://<素材ID>。多个素材的顺序有意义，请在提示词中说明各素材用途。

自适应画幅

Seedance 支持 metadata.ratio: "adaptive"。图生视频或带参考图的任务使用该值时，上游会根据参考图自适应输出画幅；如果业务要求固定横竖屏，请改传明确比例（如 16:9 或 9:16）。该字段会由 EZmodel 原样透传为 Ark 请求体顶层的 ratio。

文生视频示例

bash

curl https://api.ezmodel.cloud/v1/video/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-hc",
    "prompt": "A cinematic shot of a glass perfume bottle on a marble table, soft morning light, slow camera push in",
    "size": "720p",
    "duration": 4,
    "metadata": {
      "ratio": "16:9",
      "generate_audio": false,
      "watermark": false
    }
  }'

响应示例：

json

{
  "task_id": "mvt-512d4ffd9ce54256",
  "status": "pending"
}

图生视频示例

bash

curl https://api.ezmodel.cloud/v1/video/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-fast-260128",
    "prompt": "Make the product rotate slowly, keep the label sharp and readable",
    "image": "https://example.com/product.png",
    "size": "720p",
    "seconds": "4",
    "metadata": {
      "ratio": "adaptive"
    }
  }'

多参考素材示例

如果需要传入音频或更多参考素材，可以使用 metadata.content。其中 type、image_url、audio_url、video_url 会原样转成上游 content 项。

json

{
  "model": "dreamina-seedance-2-0-260128",
  "prompt": "Generate a relaxed lifestyle video matching the reference audio mood",
  "images": [
    "https://example.com/ref-1.jpg",
    "https://example.com/ref-2.jpg"
  ],
  "duration": 4,
  "metadata": {
    "resolution": "480p",
      "ratio": "9:16",
      "generate_audio": true,
      "content": [
      {
        "type": "audio_url",
        "audio_url": {
          "url": "https://example.com/ref.mp3"
        },
        "role": "reference_audio"
      }
    ]
  }
}

上述 reference_audio 会作为人物发声/唱歌的音频参考。用于真人或虚拟人时，请把人物图片先上传为素材并改用 asset://，同时选择 HC 模型。

首帧 + 尾帧与续接生成

json

{
  "model": "dreamina-seedance-2-0-hc",
  "prompt": "镜头从室内缓慢移动到窗外夜景，首尾画面平滑过渡",
  "duration": 4,
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9",
    "return_last_frame": true,
    "execution_expires_after": 3600,
    "callback_url": "https://example.com/callbacks/seedance",
    "content": [
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/first-frame.jpg"},
        "role": "first_frame"
      },
      {
        "type": "image_url",
        "image_url": {"url": "https://example.com/last-frame.jpg"},
        "role": "last_frame"
      }
    ]
  }
}

return_last_frame 会透传到生成服务。任务完成后，如果上游返回了最后一帧，查询响应会包含顶层 last_frame_url，可将该 HTTPS 地址作为下一次生成的 first_frame 使用。

参考视频与修改视频

Seedance 没有单独的“编辑视频”路径。要基于现有视频修改动作、镜头或风格，请创建一个新任务，并把原视频作为 reference_video：

json

{
  "model": "dreamina-seedance-2-0-hc",
  "prompt": "保留原视频人物与主要动作，把场景改为雨夜街道，镜头更稳定",
  "duration": 5,
  "metadata": {
    "resolution": "720p",
    "ratio": "16:9",
    "content": [
      {
        "type": "video_url",
        "video_url": {"url": "https://example.com/source.mp4"},
        "role": "reference_video"
      }
    ]
  }
}

原视频也可以先用 AssetType: "Video" 上传，再把 asset://<素材ID> 放入 video_url.url。真人或身份锁定视频请使用 HC 模型。

素材接口（asset://）与真人 / 身份锁定视频

除了直接传图片 URL，Seedance 还支持先把图片 / 视频 / 音频上传为上游素材，拿到素材 ID 后在生成视频时用 asset://<素材ID> 引用。素材引用会进入 with_ref 价格档，且是真人 / 数字人视频（任一 *-hc 模型）的推荐输入方式。

本站当前使用 SD 直传素材通道，不需要创建 Asset Group：

素材方式	本站状态	适用模型
`/v1/sd/assets` 及等价 V3 路径	可用	`dreamina-seedance-*-hc`
`/v1/asset-groups` + `/v1/assets`	已下线，不开放	历史 Dreamina 素材组流程
`/v1/doubao-sd-1/assets`	暂未开放	Doubao 专用素材流程

因此 HC 人像认证直接调用下方上传接口即可；响应中的 GroupId 可能为 null，不需要回传或另行创建 Group。

1. 上传素材

接口地址（任选其一）：

POST /v1/sd/assets
POST /api/v3/sd/assets
POST /v3/sd/assets
POST /ark/api/v3/sd/assets

bash

curl https://api.ezmodel.cloud/v3/sd/assets \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "URL": "https://example.com/avatar_front.jpg",
    "Name": "avatar_front",
    "AssetType": "Image"
  }'

字段	类型	必填	说明
`URL`	string	是	素材源地址，必须是上游可直接下载的公开 HTTPS 直链（无需 Cookie、无防盗链）
`Name`	string	否	素材名称
`AssetType`	string	是	素材类型：`Image` / `Video` / `Audio`

响应示例（data.Id 即素材 ID）：

json

{
  "success": true,
  "data": {
    "Id": "asset-20260723164039-k5d5l",
    "base_resp": { "status_code": 0, "status_msg": "success" }
  }
}

data.Id 是后续要引用的素材 ID。base_resp.status_code = 0 表示素材服务处理成功。

2. 查询素材

接口地址（任选其一）：GET /v1/sd/assets/{asset_id}、GET /api/v3/sd/assets/{asset_id}、GET /v3/sd/assets/{asset_id}、GET /ark/api/v3/sd/assets/{asset_id}。

素材按账户隔离：只能查询本 API Key 所属账户上传过的素材；访问他人素材返回 404 asset not found（不泄露素材是否存在）。

bash

curl https://api.ezmodel.cloud/v3/sd/assets/asset-20260723164039-k5d5l \
  -H "Authorization: Bearer $YOUR_API_KEY"

json

{
  "success": true,
  "data": {
    "Id": "asset-20260723164039-k5d5l",
    "Status": "Active",
    "AssetType": "Image",
    "Name": "avatar_front",
    "URL": "<素材地址>",
    "GroupId": null,
    "base_resp": { "status_code": 0, "status_msg": "success" }
  }
}

3. 用素材生成视频（hc 模型）

上传得到素材 ID 后，把 asset://<素材ID> 放进 image / images，并使用任一 *-hc 模型提交：

bash

curl https://api.ezmodel.cloud/v1/video/generations \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2-0-hc",
    "prompt": "这位穿黑色西装的男士自信地看向镜头并微微点头微笑，柔和商务打光，人物身份保持一致",
    "images": ["asset://asset-20260723164039-k5d5l"],
    "duration": 5,
    "size": "480p",
    "metadata": { "ratio": "9:16", "generate_audio": false, "watermark": false }
  }'

提交成功后与普通任务一样返回 task_id，按查询任务状态轮询、按下载视频内容取回视频。

常见错误

asset ... is not found：非 hc 模型无法读取 asset:// 素材，请改用任一 *-hc 模型（-hc / -fast-hc / -mini-hc）。
InputImageSensitiveContentDetected.PrivacyInformation：非 HC 模型对真人图片会触发隐私拦截；真人 / 数字人素材请用 HC 模型。
resource download failed：上传素材的 URL 无法被上游下载，请换成公开可访问、无防盗链的 HTTPS 直链（例如对象存储的预签名地址）。

查询任务状态

bash

curl https://api.ezmodel.cloud/v1/video/generations/mvt-512d4ffd9ce54256 \
  -H "Authorization: Bearer $YOUR_API_KEY"

任务状态包括：

状态	含义
`SUBMITTED` / `QUEUED` / `pending`	已排队
`IN_PROGRESS` / `PROCESSING` / `processing`	正在生成
`SUCCESS` / `completed`	已完成
`FAILURE` / `failed`	失败，查看 `error` 或 `reason`

完成响应会包含视频地址及实际用量：

json

{
  "task_id": "mvt-512d4ffd9ce54256",
  "status": "SUCCESS",
  "url": "https://.../seedance.mp4",
  "last_frame_url": "https://.../seedance-last-frame.png",
  "usage": {
    "completion_tokens": 40594,
    "total_tokens": 40594
  }
}

不同入口的字段包装略有差异，轮询时以状态为准，完成后读取视频 URL、可选的 last_frame_url 与 usage.total_tokens。

本站提供按 task_id 查询单个任务，不提供 GET /v1/video/tasks 任务列表接口。需要任务列表时，请在业务侧保存创建接口返回的 task_id。

回调使用

metadata.callback_url 会原样透传给生成服务。回调地址应使用公网 HTTPS、快速返回 2xx，并具备幂等处理能力。收到回调后仍建议用 GET /v1/video/generations/{task_id} 查询一次，以任务状态、视频 URL 和 usage.total_tokens 作为最终结果。

任务成功后返回的视频地址通常是本平台 CDN 直链（无需鉴权、可直接分享与嵌入）。若 CDN 转存暂时失败，会回退到本站代理链接 /v1/videos/{task_id}/content（需鉴权）。两种情况下都不会对外暴露上游原始地址。

下载视频内容

任务完成后可以直接使用状态响应里的视频 URL（推荐，CDN 地址无需鉴权），也可以通过内容代理接口下载：

bash

curl -L https://api.ezmodel.cloud/v1/videos/mvt-512d4ffd9ce54256/content \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  --output seedance.mp4

响应通常为 video/mp4，并支持分片下载。下载路径是 /v1/videos/{task_id}/content（注意是 videos，不是 video/generations）。

价格档选择

Seedance 会根据请求内容自动选择价格档：

判断项	规则
分辨率	优先使用 `metadata.resolution`，没有时使用 `size`，都没有时按 `720p`
`with_ref`	`content` 中存在有效 HTTP(S) 或 `asset://` 图片、音频、视频素材
`no_ref`	只有文本提示词，没有参考媒体
Fast / Mini 模型	只支持 `480p` 和 `720p`，不要传 `1080p` / `4k`
Base 模型	支持 `480p` / `720p` / `1080p` / `4k`

HTTP(S) 图片、视频或音频直链与 asset:// 都属于参考媒体并按 with_ref 结算。参考素材 URL 必须能被服务端直接下载，建议使用公开可访问、无需 Cookie、不会强制防盗链的 HTTPS 直链；如果返回 resource download failed，请更换地址或改用可访问的对象存储地址。

计费说明

Seedance 2.0 使用上游返回的 usage.total_tokens 做最终结算，单位价格为美元每 1M tokens。系统会先按请求时长和分辨率预扣，任务完成后按真实 token 用量补扣或退款。

模型	档位	价格
Base（`-260128` / `-hc`）	`480p_no_ref`, `720p_no_ref`	`$7.00 / 1M tok`
Base	`480p_with_ref`, `720p_with_ref`	`$4.30 / 1M tok`
Base	`1080p_no_ref`	`$7.70 / 1M tok`
Base	`1080p_with_ref`	`$4.70 / 1M tok`
Base	`4k_no_ref`	`$4.00 / 1M tok`
Base	`4k_with_ref`	`$2.40 / 1M tok`
Fast（`-fast-260128` / `-fast-hc`）	`480p_no_ref`, `720p_no_ref`	`$5.60 / 1M tok`
Fast	`480p_with_ref`, `720p_with_ref`	`$3.30 / 1M tok`
Mini（`-mini-260615` / `-mini-hc`）	`480p_no_ref`, `720p_no_ref`	`$3.50 / 1M tok`
Mini	`480p_with_ref`, `720p_with_ref`	`$2.10 / 1M tok`
Seedance 2.5 HC	`480p_no_ref`, `720p_no_ref`	`$10.70 / 1M tok`
Seedance 2.5 HC	`480p_with_ref`, `720p_with_ref`	`$6.40 / 1M tok`

*-hc 模型采用与同系列标准版相同的价格档（with_ref 档常见，因为它主要配合 asset:// 素材使用）。

计费公式：

text

最终美元费用 = usage.total_tokens / 1,000,000 * 对应档位价格
内部额度消耗 = 最终美元费用 * 500000 * 分组倍率

后台日志会出现两类账务记录：创建任务时的预扣记录，以及任务完成后的补扣或退款记录。对账时应把同一个任务的预扣和补差合并，合并后的净额才是最终费用。

示例：一次 Base 480p 文生视频任务实际返回 total_tokens = 40594，价格为 $7.00 / 1M tok：

text

40594 / 1,000,000 * 7.00 = $0.284158

注意事项

Fast / Mini 模型当前只配置 480p 和 720p，不要请求 1080p / 4k。
Base 模型支持 4k。
真人 / 数字人参考图，或 asset:// 素材引用，必须使用任一 *-hc 模型；非 hc 模型会拦截真人图片、也读不到 asset:// 素材。
HTTP(S) 或 asset:// 图片、音频、视频参考素材都会进入 with_ref 档；纯文本任务进入 no_ref。
上传素材（/v1/sd/assets 或 /v3/sd/assets 等）本身不计费，只有在视频生成任务里被引用时才结算。
素材按账户隔离，不同 API Key（不同用户）之间互不可见。
metadata.resolution 优先级高于顶层 size。
metadata.ratio 支持 adaptive；带参考图时可按参考图自适应画幅。
视频任务是异步执行，请不要在创建接口等待最终视频。
最终扣费以任务完成后的上游 usage 为准，任务失败会退回预扣费用。
火山 Ark 风格对接请优先阅读 Seedance 火山 / Ark 原生入口与 Seedance 对接说明。

Seedance 2.0 / 2.5 视频生成 ​

接口地址 ​

OpenAI 兼容入口 ​

火山 / Ark 兼容入口（推荐对接方使用） ​

可用模型 ​

请求参数 ​

metadata.content[] 类型与角色 ​

文生视频示例 ​

图生视频示例 ​

多参考素材示例 ​

首帧 + 尾帧与续接生成 ​

参考视频与修改视频 ​

素材接口（asset://）与真人 / 身份锁定视频 ​

1. 上传素材 ​

2. 查询素材 ​

3. 用素材生成视频（hc 模型） ​

查询任务状态 ​

回调使用 ​

下载视频内容 ​

价格档选择 ​

计费说明 ​

注意事项 ​

Seedance 2.0 / 2.5 视频生成

接口地址

OpenAI 兼容入口

火山 / Ark 兼容入口（推荐对接方使用）

可用模型

请求参数

`metadata.content[]` 类型与角色

文生视频示例

图生视频示例

多参考素材示例

首帧 + 尾帧与续接生成

参考视频与修改视频

素材接口（asset://）与真人 / 身份锁定视频

1. 上传素材

2. 查询素材

3. 用素材生成视频（hc 模型）

查询任务状态

回调使用

下载视频内容

价格档选择

计费说明

注意事项