Seedance_V3原生（SC）视频生成

Seedance_V3原生（SC）（doubao-seedance-2-*-260xxx）提供 Seedance 2.0 系列视频生成能力：接口与 v3 原厂任务协议兼容（/v3/video/tasks），并配套独立的素材库与真人认证体系（/sc/*）。

端点

创建任务（原厂兼容报文）：POST $URL/v3/video/tasks
查询任务：GET $URL/v3/video/tasks/{task_id}
统一入口（OpenAI Video 风格）：POST $URL/v1/videos，查询 GET $URL/v1/videos/{task_id}
素材库 / 真人认证：POST $URL/sc/?Action=<Action>&Version=2024-01-01，见下文

支持模型

模型名称	定位
`doubao-seedance-2-5-260628`	2.5 旗舰版，质量与一致性最强
`doubao-seedance-2-0-260128`	2.0 标准版
`doubao-seedance-2-0-fast-260128`	2.0 快速版
`doubao-seedance-2-0-mini-260615`	2.0 轻量版

计费说明

按官方 token 口径计费：tokens = (输入视频时长 + 输出时长) × 输出分辨率像素 × 帧率 / 1024，即 (is+s)*res/1000000 × 档位单价。提交时按预估预扣，任务完成后按实际 token 用量差额结算（多退少补）。

模型	视频参考（元/百万 token）	无视频参考（元/百万 token）
`doubao-seedance-2-5-260628`	42（1080p 46）	70（1080p 77）
`doubao-seedance-2-0-260128`	28（1080p 31、4k 16）	46（1080p 51、4k 26）
`doubao-seedance-2-0-fast-260128`	16.5	27.75
`doubao-seedance-2-0-mini-260615`	5.6	9.2

主要参数（创建任务）

字段	类型	必填	说明
`model`	string	是	上表中的模型名
`content`	array	否	多模态内容数组：`{type:'text'\|'image_url'\|'video_url'\|'audio_url'\|'draft_task'}`。每个图片/视频/音频项必须携带 `role`，取值：`first_frame`（首帧）/ `last_frame`（尾帧）/ `reference_image`（参考图）/ `reference_video`（参考视频）/ `reference_audio`（参考音频）；缺失会被上游以 `InvalidParameter: role must be specified for image contents` 拒绝。`first_frame`/`last_frame` 不可与 `reference_*` 类媒体混用
`resolution`	string	否	`480p`/`720p`/`1080p`/`4k`，默认 `720p`
`ratio`	string	否	`16:9`/`9:16`/`1:1`/`4:3`/`3:4`/`21:9`，默认 `16:9`
`duration`	integer	否	视频时长（秒），默认 `5`
`generate_audio`	boolean	否	是否生成音频，默认 `true`
`seed`	integer	否	随机种子
`watermark`	boolean	否	是否加水印
`camera_fixed`	boolean	否	镜头锁定
`callback_url`	string	否	任务回调地址

请求示例

文生视频

bash

curl $URL/v3/video/tasks \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-5-260628",
    "content": [
      { "type": "text", "text": "一只戴着墨镜的猫走在霓虹灯街道上，镜头缓慢推进" }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5
  }'

图生视频（引用素材库素材）

bash

curl $URL/v3/video/tasks \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      { "type": "text", "text": "让画面中的图案发光，镜头缓慢推近" },
      { "type": "image_url", "image_url": { "url": "素材库返回的素材 URL" }, "role": "first_frame" }
    ],
    "resolution": "720p",
    "duration": 5
  }'

图片项 role 按用途选择：以图片为首帧驱动运镜用 first_frame；作为主体/风格参考（不锁定首帧，最多 9 张）用 reference_image。

视频参考生视频（V2V 续写）

传入一段已有视频作为参考进行续写/演化（最多 3 段参考视频），视频项 role 用 reference_video：

bash

curl $URL/v3/video/tasks \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "doubao-seedance-2-0-260128",
    "content": [
      { "type": "text", "text": "延续参考视频的镜头运动与人物动作，场景切换到黄昏的海边，保持同样的调色风格" },
      { "type": "video_url", "video_url": { "url": "https://example.com/ref.mp4" }, "role": "reference_video" }
    ],
    "resolution": "720p",
    "duration": 5
  }'

注意：① reference_video 不支持与 first_frame/last_frame 混用；② 参考视频时长计入输入 token（计费公式中的 输入视频时长），带视频参考的任务按「视频参考」档单价计费；③ 视频 URL 需公网可直连（推荐先用素材库转存取引用 URL）。

查询任务

bash

curl $URL/v3/video/tasks/{task_id} \
  -H "Authorization: Bearer $YOUR_API_KEY"

状态机：queued → running → succeeded / failed / cancelled / expired。

字段	类型	说明
`id`	string	任务 ID（平台对外 ID）
`status`	string	上表状态机之一
`content.video_url`	string	成功时的结果视频 URL
`usage`	object	实际用量（`completion_tokens`/`total_tokens`），计费以此为准
`upstream_usage`	object	原始用量（对账参考）
`error`	object	失败时的 `code`/`message`

素材库（/sc）

RPC 风格，客户端把 SDK base_url 指到 $URL/sc 即可，Bearer 鉴权与任务相同。素材按客户强制隔离：每个客户只能创建/查看/删除自己的素材组与素材，列表仅返回本人资源。

Action	说明
`CreateAssetGroup` / `GetAssetGroup` / `ListAssetGroups` / `UpdateAssetGroup` / `DeleteAssetGroup`	素材组管理（`GroupType=AIGC`）
`CreateAsset` / `GetAsset` / `ListAssets` / `UpdateAsset` / `DeleteAsset`	素材管理（当前支持 `AssetType=Image`）
`CreateVisualValidateSession` / `GetVisualValidateResult`	真人认证会话（RPC 方式，见下）

注意事项：

上传素材（CreateAsset）必须携带本人 GroupId，且 URL 必须公网可达——系统会实时下载校验，失败即报 InvalidParameter.DownloadFailed；
图片要求：高度 300–6000px，过小会被拒（HeightTooSmall）；
上传成功后素材会被转存并返回引用 URL（约 11.5 小时有效），GetAsset 可随时重新获取最新 URL；
ListAssetGroups / ListAssets 的 Filter.GroupType 为必填（AIGC）。

bash

# 创建素材组
curl "$URL/sc/?Action=CreateAssetGroup&Version=2024-01-01" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "Name": "我的素材组", "GroupType": "AIGC" }'

# 上传素材
curl "$URL/sc/?Action=CreateAsset&Version=2024-01-01" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "GroupId": "group-xxxx", "URL": "https://example.com/photo.jpg", "AssetType": "Image", "Name": "参考图" }'

# 查询素材（取最新引用 URL）
curl "$URL/sc/?Action=GetAsset&Version=2024-01-01" \
  -H "Authorization: Bearer $YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "Id": "asset-xxxx" }'

响应为 { "ResponseMetadata": {...}, "Result": {...} } 信封；错误信息在 ResponseMetadata.Error（Code/Message）。

真人认证（数字人/真人参考场景）

使用真人形象参考前需完成一次真人认证，认证通过后获得专属 LivenessFace 素材组：

创建会话：POST $URL/sc/api/seedance/face-verifications（body 可带 return_url），返回 verification_id 与 h5_url——请保存 verification_id，并让用户在浏览器打开 h5_url 完成认证；
查询结果：GET $URL/sc/api/seedance/face-verifications/{verification_id}，status=verified 后返回 group_id（该组已绑定到你的账号，可直接用于素材上传与任务引用）。浏览器跳转回 return_url 不代表认证成功，以查询接口为准。

认证会话有时效，过期需重新创建；verification_id 仅本人可查询。

常见问题

Q: 生成要多久？

文生视频通常 1–5 分钟；图生视频/带音频会更长（实测最长约 15 分钟）。任务超时上限 20 分钟，超时自动置为失败并退款。

Q: 计费为什么和预估不一致？

提交时按分辨率与时长预估预扣，完成后按实际 token 用量差额结算。图生视频通常只按输出时长计 token，实际扣费常低于预估。

Q: 素材上传报 DownloadFailed / HeightTooSmall？

素材 URL 必须公网可直连（系统会实时抓取校验），图片高度需在 300–6000px 之间。

Seedance_sup