Open Move Seedance 视频生成 API 完整使用指南

本文介绍如何通过 Open Move 完成 Seedance 素材库查询与维护、素材上传、视频生成、任务查询和资源清理，并提供完整的真人人像认证与视频生成流程。

1. 接入信息

1.1 基础 URL

https://api.openmove.cn

1.2 鉴权方式

Seedance 接口使用两种鉴权方式：

接口类型	鉴权方式	凭证
视频生成、视频任务查询	Bearer Token	Open Move API Key
素材、素材组、真人活体认证	火山 V4 签名或 Bearer Token	令牌对应的 AK/SK，或 Open Move API Key

视频接口的鉴权请求头如下：

素材和真人认证接口共用以下地址，通过 Action 区分具体操作：

https://api.openmove.cn/openapi/volcengine/?Action={Action}&Version=2024-01-01

推荐使用 POST 和 JSON 请求体。需要兼容火山调用方式时使用 V4 签名；也可以直接发送 Authorization: Bearer sk-<Open Move API Key>，此时不需要 X-Date 和 X-Content-Sha256。V4 签名固定参数如下：

参数	值
Region	`cn-beijing`
Service	`ark`
Version	`2024-01-01`

V4 签名接口的通用请求头如下：

请求头	必填	说明
`Host`	是	固定为 `api.openmove.cn`
`Content-Type`	是	`application/json`
`X-Date`	是	UTC 时间，格式为 `yyyyMMddTHHmmssZ`，与服务端时间误差不得超过 15 分钟
`X-Content-Sha256`	是	实际发送请求体的 SHA256 小写十六进制哈希
`Authorization`	是	V4 签名结果，格式见下方示例

签名必须使用最终实际发送的请求方法、路径、查询字符串、请求头和请求体计算。请求体完成签名后不可再次序列化或修改。

1.3 火山 V4 签名算法

本节给出调用素材与真人认证接口所需的完整 V4 签名方法。若使用第 1.4 节中支持自定义路径的火山官方 SDK 或 Signer，可由其完成这些计算；自行发送 HTTP 请求时必须严格遵循本节。

1.3.1 签名固定配置

配置项	值
算法	`HMAC-SHA256`
Host	`api.openmove.cn`
Region	`cn-beijing`
Service	`ark`
API Version	`2024-01-01`
请求方法	推荐 `POST`
Canonical URI	`/openapi/volcengine/`
Signed Headers	`host;x-content-sha256;x-date`

以下内容以上传素材为例：

POST https://api.openmove.cn/openapi/volcengine/?Action=CreateAsset&Version=2024-01-01

1.3.2 第一步：生成请求体和 Payload Hash

请求体必须先完成最终 JSON 序列化，再计算 SHA256。哈希输入是实际发送的 UTF-8 字节，不是 JSON 对象、格式化前的字符串或字段值集合。

请求体示例：

{
  "GroupId": "group-20260727143000-aigc001",
  "URL": "https://cdn.example.com/materials/city-night.jpg",
  "AssetType": "Image",
  "Name": "城市夜景参考图",
  "ProjectName": "default"
}

GroupId 为可选参数。未传时会自动创建或复用当前账号可用的素材组；需要将素材上传到指定素材组时再显式传入。

伪代码：

PayloadHash = LowercaseHex(SHA256(RequestBodyUTF8Bytes))

将结果放入请求头：

空请求体的 SHA256 固定为：

e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

1.3.3 第二步：生成 X-Date

使用当前 UTC 时间，精确到秒：

YYYYMMDD'T'HHMMSS'Z'

示例：

日期部分 20260727 后续用于 Credential Scope。请求时间与服务端时间误差不得超过 15 分钟。

1.3.4 第三步：构造 Canonical Query String

查询参数需要按以下规则规范化：

参数名和参数值使用 UTF-8，并按 RFC 3986 编码。

空格编码为 %20，不能编码为 +。

编码后的参数名按 ASCII 升序排列；同名参数的值也按升序排列。

使用 = 连接名称和值，使用 & 连接多个参数。

本接口的规范查询字符串为：

Action=CreateAsset&Version=2024-01-01

1.3.5 第四步：构造 Canonical Headers 和 Signed Headers

参与签名的请求头名称转为小写，按 ASCII 升序排列；值去掉首尾空格并压缩连续空白。每个 Canonical Header 末尾必须带换行符。

host:api.openmove.cn
x-content-sha256:<PayloadHash>
x-date:20260727T070000Z

Signed Headers 为同一组请求头名称，顺序必须完全一致：

host;x-content-sha256;x-date

Content-Type 必须随 POST 请求发送，但本指南不将其加入 Signed Headers。

1.3.6 第五步：构造 Canonical Request

按照以下顺序拼接，各部分之间使用一个换行符：

CanonicalRequest =
    HTTPMethod + "\n" +
    CanonicalURI + "\n" +
    CanonicalQueryString + "\n" +
    CanonicalHeaders + "\n" +
    SignedHeaders + "\n" +
    PayloadHash

上传素材请求对应的结构如下。注意 Canonical Headers 自身以换行符结束，因此其后会自然出现一个空行：

POST
/openapi/volcengine/
Action=CreateAsset&Version=2024-01-01
host:api.openmove.cn
x-content-sha256:<PayloadHash>
x-date:20260727T070000Z

host;x-content-sha256;x-date
<PayloadHash>

计算 Canonical Request 的 SHA256：

HashedCanonicalRequest = LowercaseHex(SHA256(UTF8(CanonicalRequest)))

1.3.7 第六步：构造 String to Sign

Credential Scope 格式如下：

<YYYYMMDD>/cn-beijing/ark/request

示例：

20260727/cn-beijing/ark/request

待签名字符串为：

StringToSign =
    "HMAC-SHA256" + "\n" +
    XDate + "\n" +
    CredentialScope + "\n" +
    HashedCanonicalRequest

结构示例：

HMAC-SHA256
20260727T070000Z
20260727/cn-beijing/ark/request
<HashedCanonicalRequest>

1.3.8 第七步：派生签名密钥并计算 Signature

所有 HMAC 操作均使用 HMAC-SHA256。每一步的输出必须以原始二进制字节作为下一步的密钥，不要先转换成十六进制字符串。

kDate    = HMAC-SHA256(UTF8(SecretAccessKey), "20260727")
kRegion  = HMAC-SHA256(kDate, "cn-beijing")
kService = HMAC-SHA256(kRegion, "ark")
kSigning = HMAC-SHA256(kService, "request")

Signature = LowercaseHex(HMAC-SHA256(kSigning, StringToSign))

1.3.9 第八步：构造 Authorization 并发送请求

Authorization =
    "HMAC-SHA256 " +
    "Credential=" + AccessKeyId + "/" + CredentialScope + ", " +
    "SignedHeaders=host;x-content-sha256;x-date, " +
    "Signature=" + Signature

最终请求结构：

1.3.10 可直接使用的 Python 手动签名示例

以下示例不依赖火山 SDK，仅需安装 requests。它会完成 JSON 序列化、V4 签名并调用 CreateAsset：

1.4 使用火山官方 SDK

支持自定义路径的火山官方 SDK 或 Signer 可以自动生成 V4 签名。接入 Open Move 时必须使用以下配置：

配置项	值
Access Key ID	Open Move 令牌对应的 Access Key ID
Secret Access Key	Open Move 令牌对应的 Secret Access Key
Region	`cn-beijing`
Service	`ark`
Version	`2024-01-01`
Endpoint Host	`api.openmove.cn`
Endpoint Path	`/openapi/volcengine/`

不同语言 SDK 对自定义路径的支持并不一致，请按下表选择接入方式，不要把 /openapi/volcengine 直接拼进只接受域名的 host 配置项：

语言	推荐方式	路径配置
Go	`volcengine-go-sdk` Universal Client	Endpoint 设为 `https://api.openmove.cn/openapi/volcengine`
Python	`volcengine` SDK 的 `SignerV4`	`host` 设为 `api.openmove.cn`，`path` 设为 `/openapi/volcengine/`
Java	标准 HTTP Client + 本文 V4 签名实现	当前 Universal SDK 将 Canonical URI 固定为 `/`，不能直接用于本接口路径
Node.js	`@volcengine/openapi` 的 `Signer`	`hostname` 设为 `api.openmove.cn`，`pathname` 设为 `/openapi/volcengine/`

建议通过环境变量保存凭证：

1.4.1 Go SDK

安装：

上传素材示例：

其他 Action 只需替换 Action 和 input。例如查询素材使用 Action: "GetAsset" 和 input := map[string]any{"Id": assetID}。

1.4.2 Python SDK

安装：

Python Universal Client 会把 configuration.host 整体作为 Host 参与签名，因此不能把 /openapi/volcengine 拼入 configuration.host。下面使用火山官方 Python SDK 的 SignerV4，分别设置域名和路径。

上传素材示例：

1.4.3 Java

当前火山 Java Universal SDK 的 Canonical URI 固定为 /，而 Open Move 要求签名路径为 /openapi/volcengine/，因此不能通过把路径拼入 setEndpoint 来适配。Java 项目应直接使用本文 1.3 节的标准 V4 算法。下面示例仅依赖 JDK 11+，可直接上传素材：

1.4.4 Node.js SDK

Node.js 示例使用火山官方 SDK 的 Signer，显式指定 Open Move 的完整路径，再通过 Node.js 原生 HTTPS 客户端发送请求。

安装：

上传素材示例：

1.5 素材与真人认证接口的通用响应

成功响应使用火山兼容格式：

{
  "ResponseMetadata": {
    "RequestId": "20260727150000ABCDEF1234567890",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {}
}

通用响应字段如下：

字段	类型	说明
`ResponseMetadata.RequestId`	string	请求 ID，可用于问题排查
`ResponseMetadata.Action`	string	本次执行的 Action
`ResponseMetadata.Version`	string	API 版本
`ResponseMetadata.Service`	string	固定为 `ark`
`ResponseMetadata.Region`	string	固定为 `cn-beijing`
`ResponseMetadata.Error`	object	失败时返回的错误信息
`ResponseMetadata.Error.Code`	string	错误码
`ResponseMetadata.Error.Message`	string	错误说明
`Result`	object	接口成功结果，不同 Action 的字段不同

错误响应示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727150000ABCDEF1234567890",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing",
    "Error": {
      "Code": "ResourceNotFound",
      "Message": "the requested resource was not found"
    }
  }
}

调用方应同时检查 HTTP 状态码和 ResponseMetadata.Error。

2. Action API 调用参考

全部 Action 共用以下调用地址，通过查询参数中的 Action 指定操作：

POST https://api.openmove.cn/openapi/volcengine/?Action={Action}&Version=2024-01-01

请求使用 JSON Body，并采用第 1.2 节介绍的任一鉴权方式。成功和失败响应均使用第 1.5 节的通用响应结构。

2.1 素材组 Action

Action	用途	必填参数	可选参数	`Result`
`CreateAssetGroup`	创建素材组	`Name`	`Description`、`GroupType`、`ProjectName`	`Id`
`ListAssetGroups`	分页查询素材组	无	`Filter`、`PageNumber`、`PageSize`、`SortBy`、`SortOrder`、`ProjectName`	`Items`、`TotalCount`、`PageNumber`、`PageSize`
`GetAssetGroup`	查询单个素材组	`Id`	`ProjectName`	`Id`、`Name`、`Description`、`GroupType`、`ProjectName`、`CreateTime`、`UpdateTime`
`UpdateAssetGroup`	更新素材组	`Id`	`Name`、`Description`、`ProjectName`	`Id`
`DeleteAssetGroup`	删除素材组	`Id`	`ProjectName`	空对象

ListAssetGroups.Filter 支持 Name、GroupIds 和 GroupType。分页、排序和返回字段的详细说明见第 5.1 节。

2.2 素材 Action

Action	用途	必填参数	可选参数	`Result`
`CreateAsset`	导入素材	`URL`、`AssetType`	`GroupId`、`Name`、`ProjectName`	`Id`
`ListAssets`	分页查询素材	无	`Filter`、`PageNumber`、`PageSize`、`SortBy`、`SortOrder`、`ProjectName`	`Items`、`TotalCount`、`PageNumber`、`PageSize`
`GetAsset`	查询单个素材	`Id`	`ProjectName`	`Id`、`Name`、`GroupId`、`AssetType`、`Status`、`URL`、`ProjectName`、`CreateTime`、`UpdateTime`
`UpdateAsset`	更新素材	`Id`	`Name`、`ProjectName`	`Id`
`DeleteAsset`	删除素材	`Id`	`ProjectName`	空对象

CreateAsset 未传 GroupId 时会自动创建或复用素材组。ListAssets.Filter 支持 Name、GroupIds、GroupType 和 Statuses，详细说明见第 5.2 节。

2.3 真人认证 Action

Action	用途	必填参数	可选参数	`Result`
`CreateVisualValidateSession`	创建真人认证会话	`CallbackURL`	`ProjectName`	`BytedToken`、`H5Link`、`CallbackURL`
`GetVisualValidateResult`	查询真人认证结果	`BytedToken`	`ProjectName`	`GroupId`

2.4 完整调用示例

以下示例复用第 1.3.10 节定义的 call_openmove 函数，覆盖全部 12 个 Action：

3. 基础模块：使用普通素材生成视频

完整流程如下：

上传素材，取得素材 ID。

查询素材，等待处理成功。

使用素材 ID 创建视频生成任务，取得任务 ID。

查询任务，等待视频生成成功并获取视频地址。

删除不再使用的素材。

上传普通素材时可以省略 GroupId，接口会自动创建或复用当前账号可用的素材组；需要上传到指定素材组时再传入对应的 GroupId。ProjectName 使用默认值 default，后续查询和删除素材时可以不传该字段。

步骤一：上传素材

该接口通过公网 URL 导入图片、视频或音频，不使用 multipart/form-data 直接上传文件。URL 必须是火山服务端可以直接访问的公网 URL：无需登录、Cookie 或额外鉴权请求头即可下载；若使用带签名的临时 URL，其有效期必须覆盖素材下载和处理时间。素材处理是异步的，接口返回素材 ID 后必须继续查询处理状态。

接口地址

https://api.openmove.cn/openapi/volcengine/?Action=CreateAsset&Version=2024-01-01

请求方式

POST

请求头

使用第 1.2 节所述的 V4 签名请求头。

请求体

参数	类型	必填	说明
`URL`	string	是	火山服务端可直接访问的素材公网 URL
`AssetType`	string	是	素材类型：`Image`、`Video` 或 `Audio`
`Name`	string	否	素材名称；未提供或仅包含空白字符时自动生成不重复的默认名称
`GroupId`	string	否	目标素材组 ID；省略时自动创建或复用素材组
`ProjectName`	string	否	项目名称，默认值为 `default`

请求体示例：

{
  "URL": "https://cdn.example.com/materials/city-night.jpg",
  "AssetType": "Image",
  "Name": "城市夜景参考图",
  "ProjectName": "default"
}

响应体

除通用响应字段外，Result 包含：

字段	类型	说明
`Result.Id`	string	素材 ID，后续查询素材和生成视频时使用

响应体示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727150001ABCDEF1234567890",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "asset-20260727150001-a1b2c3"
  }
}

请保存 Result.Id。

步骤二：查询素材并等待处理成功

建议每 5 秒查询一次，直到素材进入成功或失败终态。调用方应不区分大小写判断状态。

接口地址

https://api.openmove.cn/openapi/volcengine/?Action=GetAsset&Version=2024-01-01

请求方式

POST

请求头

使用 V4 签名请求头。

请求体

参数	类型	必填	说明
`Id`	string	是	`CreateAsset` 返回的素材 ID

请求体示例：

{
  "Id": "asset-20260727150001-a1b2c3"
}

响应体

Result 字段如下：

字段	类型	说明
`Id`	string	素材 ID
`Name`	string	素材名称
`GroupId`	string	素材所属的素材组 ID
`AssetType`	string	`Image`、`Video` 或 `Audio`
`Status`	string	素材处理状态
`URL`	string	处理后的临时素材地址；可能带签名并具有有效期
`ProjectName`	string	默认值为 `default`
`CreateTime`	string	创建时间
`UpdateTime`	string	更新时间

常见状态如下：

状态	含义	后续操作
`Processing`	正在处理	继续轮询
`Active`、`Ready`、`READY`	处理成功，素材可用	停止轮询并创建视频任务
`Failed`	处理失败	停止轮询，检查素材 URL、格式或响应错误信息

处理中响应示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727150006ABCDEF1234567890",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "asset-20260727150001-a1b2c3",
    "Name": "城市夜景参考图",
    "GroupId": "group-20260727143000-aigc001",
    "AssetType": "Image",
    "Status": "Processing",
    "ProjectName": "default"
  }
}

处理成功响应示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727150016ABCDEF1234567890",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "asset-20260727150001-a1b2c3",
    "Name": "城市夜景参考图",
    "GroupId": "group-20260727143000-aigc001",
    "AssetType": "Image",
    "Status": "Active",
    "URL": "https://ark-media.example.com/assets/a1b2c3?signature=...",
    "ProjectName": "default",
    "CreateTime": "2026-07-27T15:00:01+08:00",
    "UpdateTime": "2026-07-27T15:00:16+08:00"
  }
}

步骤三：使用素材 ID 生成视频

素材处理成功后，在 content 中使用 asset://{素材 ID} 引用素材。图片、视频和音频素材应分别放在 image_url、video_url 和 audio_url 字段中。

视频生成支持的模型 ID：seedance-2.0、seedance-2.0-mini、seedance-2.0-fast、seedance-2.5。请求时将其中一个 ID 填入 model；具体可用模型以当前令牌和渠道配置为准。

接口地址

https://api.openmove.cn/api/v3/contents/generations/tasks

请求方式

POST

请求头

请求头	必填	说明
`Authorization`	是	`Bearer <OPEN_MOVE_API_KEY>`
`Content-Type`	是	`application/json`

请求体

参数	类型	必填	说明
`model`	string	是	上述四个 Seedance 模型 ID 之一；以当前令牌和渠道可用模型为准
`content`	array	与 `prompt` 二选一	文本和素材输入数组
`content[].type`	string	是	`text`、`image_url`、`video_url`、`audio_url`；Seedance 2.5 草稿续作还可使用 `draft_task`
`content[].text`	string	条件必填	`type=text` 时填写提示词
`content[].image_url.url`	string	条件必填	图片 URL 或 `asset://{图片素材 ID}`
`content[].video_url.url`	string	条件必填	视频 URL 或 `asset://{视频素材 ID}`
`content[].audio_url.url`	string	条件必填	音频 URL 或 `asset://{音频素材 ID}`
`content[].draft_task.id`	string	条件必填	`type=draft_task` 时填写本平台返回的草稿任务 `id`
`content[].role`	string	否	`first_frame`、`last_frame`、`reference_image`、`reference_video` 或 `reference_audio`
`prompt`	string	否	简写提示词；与 `content` 二选一
`images`	string[]	否	与 `prompt` 搭配使用的图片 URL 或 `asset://` 引用数组
`resolution`	string	否	例如 `480p`、`720p`、`1080p`
`ratio`	string	否	例如 `16:9`、`9:16`、`1:1`、`adaptive`
`duration`	integer	否	视频时长，单位为秒；支持范围由模型决定
`frames`	integer	否	视频总帧数；通常与 `duration` 二选一
`seed`	integer	否	随机种子；`-1` 通常表示随机
`camera_fixed`	boolean	否	是否固定镜头
`watermark`	boolean	否	是否添加水印
`generate_audio`	boolean	否	是否生成音频
`return_last_frame`	boolean	否	是否在结果中返回尾帧图片
`draft`	boolean	否	Seedance 2.5 设置为 `true` 时创建草稿任务；草稿续作流程见下文
`service_tier`	string	否	服务等级，例如 `default`
`execution_expires_after`	integer	否	任务执行超时时间，单位为秒
`callback_url`	string	否	任务状态回调地址
`tools`	array	否	模型支持的扩展工具配置

请求体示例：

{
  "model": "seedance-2.0",
  "content": [
    {
      "type": "image_url",
      "image_url": {
        "url": "asset://asset-20260727150001-a1b2c3"
      },
      "role": "reference_image"
    },
    {
      "type": "text",
      "text": "夜晚的城市街道逐渐被霓虹灯点亮，镜头平稳向前推进，电影感光影"
    }
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5,
  "watermark": false
}

响应体

字段	类型	说明
`id`	string	视频生成任务 ID，用于查询任务状态

响应体示例：

{
  "id": "cgt-20260727150100-video123"
}

请保存 id。该接口为异步接口，返回任务 ID 不代表视频已经生成完成。

步骤四：通过任务 ID 查询视频任务

建议以固定间隔轮询，直到 status 为 succeeded 或 failed。

接口地址

https://api.openmove.cn/api/v3/contents/generations/tasks/{task_id}

请求方式

GET

请求头

请求头	必填	说明
`Authorization`	是	`Bearer <OPEN_MOVE_API_KEY>`

请求体

无请求体。

路径参数如下：

参数	类型	必填	说明
`task_id`	string	是	创建视频任务时返回的 `id`

请求示例：

响应体

字段	类型	说明
`id`	string	任务 ID
`model`	string	实际使用的模型 ID
`status`	string	`queued`、`running`、`succeeded` 或 `failed`
`content.video_url`	string	成功时返回的视频临时下载地址
`content.last_frame_url`	string	请求返回尾帧时可能出现的尾帧图片地址
`draft`	boolean	可选；创建草稿任务时为 `true`
`draft_task_id`	string	可选；上游返回的草稿关联 ID。续作请求请使用草稿创建响应中的平台任务 `id`
`usage.completion_tokens`	integer	生成消耗的 token 数
`usage.total_tokens`	integer	总 token 数
`error.code`	string	失败时的错误码
`error.message`	string	失败原因
`created_at`	integer	创建时间，Unix 秒
`updated_at`	integer	更新时间，Unix 秒

处理中响应示例：

{
  "id": "cgt-20260727150100-video123",
  "model": "seedance-2.0",
  "status": "running",
  "created_at": 1785135660,
  "updated_at": 1785135680
}

生成成功响应示例：

{
  "id": "cgt-20260727150100-video123",
  "model": "seedance-2.0",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-content.example.com/videos/video123.mp4?signature=..."
  },
  "usage": {
    "completion_tokens": 135680,
    "total_tokens": 135680
  },
  "created_at": 1785135660,
  "updated_at": 1785135740
}

生成失败响应示例：

{
  "id": "cgt-20260727150100-video123",
  "model": "seedance-2.0",
  "status": "failed",
  "error": {
    "code": "generation_failed",
    "message": "video generation failed"
  },
  "created_at": 1785135660,
  "updated_at": 1785135700
}

video_url 通常是带签名的临时地址，请在有效期内下载并转存。

Seedance 2.5 Draft：草稿预览与正式生成

Seedance 2.5 可先创建草稿任务，查看草稿结果后再基于该草稿生成正式视频。两次创建任务均使用上文的 POST /api/v3/contents/generations/tasks，查询均使用 GET /api/v3/contents/generations/tasks/{task_id}，请求头与步骤三、四相同。

创建草稿。 使用 model: "seedance-2.5"，并设置 draft: true。其余提示词、素材和时长按普通视频任务传入。例如：

{
  "model": "seedance-2.5",
  "content": [
    { "type": "text", "text": "雨后的城市街道，镜头缓慢向前推进" }
  ],
  "duration": 5,
  "draft": true
}

创建接口返回 {"id":"cgt-draft-example"}。保存这个平台任务 ID。

查询草稿。 使用返回的 id 按步骤四轮询，直到 status 为 succeeded 或 failed。成功时可查看返回的 content.video_url（如果上游提供）；响应中的 draft 可标识草稿任务。

基于草稿生成正式视频。 在新请求的 content 中加入 type: "draft_task"，将步骤一返回的 id 填入 draft_task.id。可在这一步设置正式视频的 resolution，并按需传入 duration 等参数。例如：

{
  "model": "seedance-2.5",
  "content": [
    { "type": "draft_task", "draft_task": { "id": "cgt-draft-example" } }
  ],
  "resolution": "1080p",
  "duration": 5
}

此次创建会返回新的任务 id；按步骤四查询新任务，取得正式视频地址。draft_task.id 应填写草稿创建响应中的平台任务 ID，而不是本次正式任务的 ID。

草稿续作请使用创建草稿时的同一用户和同一 Open Move API Key。平台会将请求固定到原草稿使用的渠道、凭证和上游实例；如果原渠道或凭证不可用，续作请求会失败。若草稿原请求和查询结果都没有可用时长，续作请求需要显式传入 duration。

步骤五：取消或删除视频任务

如果视频任务不再需要，可以通过任务 ID 请求取消或删除。该接口同样适用于使用真人人像素材创建的视频任务。

平台会先请求上游取消或删除任务，并在确认上游结果后删除本地任务记录。渠道必须支持任务删除能力；如果上游确认任务已取消，平台会退回该任务已扣除的额度。如果上游确认任务已删除或不存在，则不会退款。

接口地址

https://api.openmove.cn/api/v3/contents/generations/tasks/{task_id}

请求方式

DELETE

请求头

请求头	必填	说明
`Authorization`	是	`Bearer <OPEN_MOVE_API_KEY>`

请求体

无请求体。

路径参数如下：

参数	类型	必填	说明
`task_id`	string	是	创建视频任务时返回的 `id`；只能操作当前 API Key 创建的任务

请求示例：

响应体

取消或删除成功时返回 HTTP 204 No Content，响应体为空。对已经成功删除的同一任务重复调用时仍返回 204。

成功后，该任务通常不再能通过任务查询接口获取。常见错误如下：

HTTP 状态码	错误码	说明
`400`	`task_deletion_unsupported`	当前任务所在渠道未启用或不支持任务删除能力
`404`	`task_not_exist`	任务不存在，或不属于当前 API Key
`409`	`task_deletion_in_progress`	同一任务已有删除请求正在处理
`409`	`task_deletion_unconfirmed`	上游未能确认任务已取消或删除
上游状态码或 `502`	`delete_upstream_task_failed`	请求上游取消或删除任务失败
上游状态码或 `502`	`confirm_upstream_task_deletion_failed`	查询并确认上游删除结果失败

建议仅取消或删除当前调用方明确不再需要的任务。不要通过任务列表选择并删除不确定归属的任务。

步骤六：删除素材

视频生成完成且不再需要素材时，可删除素材。

接口地址

https://api.openmove.cn/openapi/volcengine/?Action=DeleteAsset&Version=2024-01-01

请求方式

POST

请求头

使用 V4 签名请求头。

请求体

参数	类型	必填	说明
`Id`	string	是	要删除的素材 ID

请求体示例：

{
  "Id": "asset-20260727150001-a1b2c3"
}

响应体

删除成功时只返回通用的 ResponseMetadata，不返回 Result。

字段	类型	说明
`ResponseMetadata`	object	删除请求已处理；子字段含义见第 1.5 节

响应体示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727150500ABCDEF1234567890",
    "Action": "DeleteAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  }
}

4. 真人人像模块

真人人像素材必须先完成活体认证。CreateAssetGroup 只能创建普通 AIGC 素材组，不能代替真人认证。真人素材组只能由活体认证成功后返回。

完整流程如下：

创建真人活体认证会话。

用户打开 H5 页面完成认证，调用查询接口取得真人素材组 ID。

使用真人素材组 ID 上传真人人像素材。

查询素材，等待处理成功。

使用真人人像素材 ID 生成视频。

查询视频任务，等待生成完成。

删除真人人像素材。

删除真人人像素材组。

步骤一：进行真人活体认证

该接口创建一个有效期为 30 分钟的 H5 活体认证会话。调用方需要保存 BytedToken，并让当前被认证用户在浏览器中打开 H5Link。

接口地址

https://api.openmove.cn/openapi/volcengine/?Action=CreateVisualValidateSession&Version=2024-01-01

请求方式

POST

请求头

使用 V4 签名请求头。

请求体

参数	类型	必填	说明
`CallbackURL`	string	是	认证流程结束后浏览器最终跳转的业务方地址，必须是调用方自己的页面

请求体示例：

{
  "CallbackURL": "https://your-app.example.com/seedance/verify/callback?user_id=10001"
}

响应体

Result 字段如下：

字段	类型	说明
`BytedToken`	string	认证会话令牌，查询认证结果时使用
`H5Link`	string	用户完成活体认证的 H5 页面地址
`CallbackURL`	string	回显调用方传入的回调地址

响应体示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727160000ABCDEF1234567890",
    "Action": "CreateVisualValidateSession",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "BytedToken": "cv-token-20260727160000-abc123",
    "H5Link": "https://visual.volcengineapi.com/verify?token=cv-token-20260727160000-abc123",
    "CallbackURL": "https://your-app.example.com/seedance/verify/callback?user_id=10001"
  }
}

用户完成 H5 操作后，Open Move 会处理认证结果，再通过 HTTP 302 跳转到 CallbackURL。业务方原有查询参数会被保留，并可能收到 bytedToken、resultCode 和 groupId。浏览器跳转可能被用户关闭或网络中断，因此最终结果必须以查询接口为准。

步骤二：查询活体认证状态

用户打开 H5 页面后，建议每 3～5 秒查询一次。认证成功后返回的 GroupId 就是真人素材组 ID。

接口地址

https://api.openmove.cn/openapi/volcengine/?Action=GetVisualValidateResult&Version=2024-01-01

请求方式

POST

请求头

使用 V4 签名请求头。

请求体

参数	类型	必填	说明
`BytedToken`	string	是	创建认证会话时返回的 `BytedToken`

请求体示例：

{
  "BytedToken": "cv-token-20260727160000-abc123"
}

响应体

字段	类型	说明
`Result.GroupId`	string	认证成功后创建的 `LivenessFace` 真人素材组 ID

认证成功响应示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727160020ABCDEF1234567890",
    "Action": "GetVisualValidateResult",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "GroupId": "group-20260727160020-livenessface-xyz"
  }
}

认证尚未完成时，接口可能返回空 Result，也可能在 ResponseMetadata.Error.Code 中返回等待状态，例如 ValidatePending。此时继续轮询；返回非空 GroupId 时停止轮询。会话超过 30 分钟仍未成功时，应重新创建认证会话。

步骤三：上传真人人像到真人素材库

真人素材上传仍使用 CreateAsset，并传入上一步认证成功后返回的 GroupId。

接口地址

https://api.openmove.cn/openapi/volcengine/?Action=CreateAsset&Version=2024-01-01

请求方式

POST

请求头

使用 V4 签名请求头。

请求体

参数	类型	必填	说明
`GroupId`	string	是	真人素材流程必须传入 `GetVisualValidateResult` 返回的素材组 ID；普通素材调用 `CreateAsset` 时可以省略
`URL`	string	是	火山服务端可直接访问的真人图片或视频公网 URL；不得依赖 Cookie 或额外鉴权请求头
`AssetType`	string	是	通常为 `Image` 或 `Video`；支持值为 `Image`、`Video`、`Audio`
`Name`	string	否	真人素材名称

请求体示例：

{
  "GroupId": "group-20260727160020-livenessface-xyz",
  "URL": "https://cdn.example.com/people/person-10001.mp4",
  "AssetType": "Video",
  "Name": "用户 10001 真人参考视频"
}

响应体

字段	类型	说明
`Result.Id`	string	真人人像素材 ID

响应体示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727160100ABCDEF1234567890",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "asset-20260727160100-person001"
  }
}

步骤四：查询真人人像素材上传状态

轮询 GetAsset，直到 Status 为 Active 或 READY 等成功状态。

接口地址

https://api.openmove.cn/openapi/volcengine/?Action=GetAsset&Version=2024-01-01

请求方式

POST

请求头

使用 V4 签名请求头。

请求体

参数	类型	必填	说明
`Id`	string	是	上传真人人像时返回的素材 ID

请求体示例：

{
  "Id": "asset-20260727160100-person001"
}

响应体

字段	类型	说明
`Id`	string	真人人像素材 ID
`Name`	string	素材名称
`GroupId`	string	所属真人素材组 ID
`AssetType`	string	素材类型
`Status`	string	`Processing`、`Active`、`READY` 或 `Failed` 等状态
`URL`	string	处理后的临时素材地址
`ProjectName`	string	默认值为 `default`
`CreateTime`	string	创建时间
`UpdateTime`	string	更新时间

处理成功响应示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727160120ABCDEF1234567890",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "asset-20260727160100-person001",
    "Name": "用户 10001 真人参考视频",
    "GroupId": "group-20260727160020-livenessface-xyz",
    "AssetType": "Video",
    "Status": "Active",
    "URL": "https://ark-media.example.com/assets/person001?signature=...",
    "ProjectName": "default",
    "CreateTime": "2026-07-27T16:01:00+08:00",
    "UpdateTime": "2026-07-27T16:01:20+08:00"
  }
}

步骤五：使用真人人像素材 ID 生成视频

真人人像素材处理成功后，使用 asset://{素材 ID} 引用。下面以真人视频素材作为 reference_video 为例；若上传的是图片，则改用 image_url 和 reference_image。

接口地址

https://api.openmove.cn/api/v3/contents/generations/tasks

请求方式

POST

请求头

请求头	必填	说明
`Authorization`	是	`Bearer <OPEN_MOVE_API_KEY>`
`Content-Type`	是	`application/json`

请求体

参数	类型	必填	说明
`model`	string	是	Seedance 模型 ID
`content`	array	是	提示词与真人人像素材引用
`content[].type`	string	是	真人图片使用 `image_url`，真人视频使用 `video_url`
`content[].image_url.url`	string	条件必填	`asset://{真人图片素材 ID}`
`content[].video_url.url`	string	条件必填	`asset://{真人视频素材 ID}`
`content[].role`	string	建议填写	真人图片建议 `reference_image`，真人视频建议 `reference_video`
`content[].text`	string	是	视频内容和人物动作提示词
`resolution`	string	否	输出分辨率
`ratio`	string	否	输出画面比例
`duration`	integer	否	视频时长，单位为秒
`frames`	integer	否	视频总帧数；通常与 `duration` 二选一
`seed`	integer	否	随机种子；`-1` 通常表示随机
`camera_fixed`	boolean	否	是否固定镜头
`generate_audio`	boolean	否	是否生成音频
`watermark`	boolean	否	是否添加水印
`return_last_frame`	boolean	否	是否在结果中返回尾帧图片
`draft`	boolean	否	Seedance 2.5 设置为 `true` 时创建草稿任务；续作方式见第 3 节 Draft 流程
`service_tier`	string	否	服务等级，例如 `default`
`execution_expires_after`	integer	否	任务执行超时时间，单位为秒
`callback_url`	string	否	任务状态回调地址
`tools`	array	否	模型支持的扩展工具配置

请求体示例：

{
  "model": "seedance-2.0",
  "content": [
    {
      "type": "video_url",
      "video_url": {
        "url": "asset://asset-20260727160100-person001"
      },
      "role": "reference_video"
    },
    {
      "type": "text",
      "text": "保持人物身份特征一致，人物自然地走向镜头并微笑挥手，真实摄影风格，光线柔和"
    }
  ],
  "resolution": "1080p",
  "ratio": "9:16",
  "duration": 5,
  "generate_audio": false,
  "watermark": false
}

响应体

字段	类型	说明
`id`	string	视频生成任务 ID

响应体示例：

{
  "id": "cgt-20260727160200-person-video001"
}

步骤六：查询真人人像视频任务状态

接口地址

https://api.openmove.cn/api/v3/contents/generations/tasks/{task_id}

请求方式

GET

请求头

请求头	必填	说明
`Authorization`	是	`Bearer <OPEN_MOVE_API_KEY>`

请求体

无请求体。

路径参数	类型	必填	说明
`task_id`	string	是	上一步返回的视频任务 ID

请求示例：

响应体

字段	类型	说明
`id`	string	任务 ID
`model`	string	模型 ID
`status`	string	`queued`、`running`、`succeeded` 或 `failed`
`content.video_url`	string	生成成功后的视频临时下载地址
`content.last_frame_url`	string	可选的尾帧图片地址
`usage.completion_tokens`	integer	生成 token 数
`usage.total_tokens`	integer	总 token 数
`error.code`	string	失败错误码
`error.message`	string	失败说明
`created_at`	integer	创建时间，Unix 秒
`updated_at`	integer	更新时间，Unix 秒

成功响应示例：

{
  "id": "cgt-20260727160200-person-video001",
  "model": "seedance-2.0",
  "status": "succeeded",
  "content": {
    "video_url": "https://ark-content.example.com/videos/person-video001.mp4?signature=..."
  },
  "usage": {
    "completion_tokens": 135680,
    "total_tokens": 135680
  },
  "created_at": 1785139320,
  "updated_at": 1785139400
}

若 status 为 queued 或 running，继续轮询；若为 failed，读取 error.code 和 error.message 后停止轮询。

步骤七：删除真人人像素材

应先删除组内不再使用的真人人像素材，再删除真人素材组。

接口地址

https://api.openmove.cn/openapi/volcengine/?Action=DeleteAsset&Version=2024-01-01

请求方式

POST

请求头

使用 V4 签名请求头。

请求体

参数	类型	必填	说明
`Id`	string	是	要删除的真人人像素材 ID

请求体示例：

{
  "Id": "asset-20260727160100-person001"
}

响应体

字段	类型	说明
`ResponseMetadata`	object	删除请求已处理；成功时不返回 `Result`，子字段含义见第 1.5 节

响应体示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727160500ABCDEF1234567890",
    "Action": "DeleteAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  }
}

步骤八：删除真人人像素材组

删除素材组会清理该组及其组内素材。该操作不可逆，执行前应确认组内素材和业务引用均已不再使用。

接口地址

https://api.openmove.cn/openapi/volcengine/?Action=DeleteAssetGroup&Version=2024-01-01

请求方式

POST

请求头

使用 V4 签名请求头。

请求体

参数	类型	必填	说明
`Id`	string	是	要删除的真人素材组 ID，即认证成功后返回的 `GroupId`

请求体示例：

{
  "Id": "group-20260727160020-livenessface-xyz"
}

响应体

字段	类型	说明
`ResponseMetadata`	object	删除请求已处理；成功时不返回 `Result`，子字段含义见第 1.5 节

响应体示例：

{
  "ResponseMetadata": {
    "RequestId": "20260727160510ABCDEF1234567890",
    "Action": "DeleteAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  }
}

5. 管理素材库

本节介绍素材组和素材的分页查询与信息更新接口。它们使用第 1 节的鉴权方式和通用响应格式，地址仍为：

https://api.openmove.cn/openapi/volcengine/?Action={Action}&Version=2024-01-01

5.1 分页查询素材组

使用 ListAssetGroups 查询当前令牌可见的素材组。

POST /openapi/volcengine/?Action=ListAssetGroups&Version=2024-01-01

请求参数：

参数	类型	必填	说明
`Filter.Name`	string	否	按素材组名称模糊匹配，最长 64 个字符
`Filter.GroupIds`	string[]	否	按素材组 ID 筛选
`Filter.GroupType`	string	否	`AIGC` 或 `LivenessFace`
`PageNumber`	integer	否	页码，默认 `1`，最小 `1`
`PageSize`	integer	否	每页数量，默认 `20`，范围 `1`～`100`
`SortBy`	string	否	`CreateTime`、`UpdateTime` 或 `GroupId`，默认 `CreateTime`
`SortOrder`	string	否	`Asc` 或 `Desc`，默认 `Desc`
`ProjectName`	string	否	只能使用 `default`，省略时自动取默认值

请求体示例：

{
  "Filter": {
    "Name": "人物",
    "GroupType": "AIGC"
  },
  "PageNumber": 1,
  "PageSize": 20,
  "SortBy": "CreateTime",
  "SortOrder": "Desc",
  "ProjectName": "default"
}

响应中的 Result 结构：

字段	类型	说明
`Items`	object[]	当前页素材组
`Items[].Id`	string	素材组 ID
`Items[].Name`	string	素材组名称
`Items[].Title`	string	素材组标题，当前与 `Name` 一致
`Items[].Description`	string	素材组描述
`Items[].GroupType`	string	`AIGC` 或 `LivenessFace`
`Items[].ProjectName`	string	固定为 `default`
`Items[].CreateTime`	string	UTC RFC 3339 创建时间
`Items[].UpdateTime`	string	UTC RFC 3339 更新时间
`TotalCount`	integer	筛选后的总数
`PageNumber`	integer	当前页码
`PageSize`	integer	当前每页数量

{
  "ResponseMetadata": {
    "RequestId": "20260816180000ABCDEF1234567890",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Items": [
      {
        "Id": "group-20260816170000-a1b2c",
        "Name": "人物素材组",
        "Title": "人物素材组",
        "Description": "广告视频人物参考",
        "GroupType": "AIGC",
        "ProjectName": "default",
        "CreateTime": "2026-08-16T09:00:00Z",
        "UpdateTime": "2026-08-16T09:00:00Z"
      }
    ],
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 20
  }
}

5.2 分页查询素材

使用 ListAssets 查询当前令牌可见的素材。

POST /openapi/volcengine/?Action=ListAssets&Version=2024-01-01

请求参数：

参数	类型	必填	说明
`Filter.Name`	string	否	按素材名称模糊匹配，最长 64 个字符
`Filter.GroupIds`	string[]	否	按素材组 ID 筛选
`Filter.GroupType`	string	否	`AIGC` 或 `LivenessFace`
`Filter.Statuses`	string[]	否	`Processing`、`Active`、`Failed` 中的一个或多个
`PageNumber`	integer	否	页码，默认 `1`，最小 `1`
`PageSize`	integer	否	每页数量，默认 `20`，范围 `1`～`100`
`SortBy`	string	否	`CreateTime`、`UpdateTime` 或 `GroupId`，默认 `CreateTime`
`SortOrder`	string	否	`Asc` 或 `Desc`，默认 `Desc`
`ProjectName`	string	否	只能使用 `default`，省略时自动取默认值

请求体示例：

{
  "Filter": {
    "GroupIds": ["group-20260816170000-a1b2c"],
    "Statuses": ["Active"]
  },
  "PageNumber": 1,
  "PageSize": 20,
  "SortBy": "UpdateTime",
  "SortOrder": "Desc",
  "ProjectName": "default"
}

每个素材包含 Id、Name、URL、GroupId、AssetType、Status、Moderation、ProjectName、CreateTime 和 UpdateTime。状态为 Failed 时还会返回 Error.Code 和 Error.Message。

{
  "ResponseMetadata": {
    "RequestId": "20260816180100ABCDEF1234567890",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Items": [
      {
        "Id": "asset-20260816173000-d4e5f",
        "Name": "人物正面照",
        "URL": "https://cdn.example.com/materials/person-front.png",
        "GroupId": "group-20260816170000-a1b2c",
        "AssetType": "Image",
        "Status": "Active",
        "Moderation": {
          "Strategy": "Default"
        },
        "ProjectName": "default",
        "CreateTime": "2026-08-16T09:30:00Z",
        "UpdateTime": "2026-08-16T09:31:00Z"
      }
    ],
    "TotalCount": 1,
    "PageNumber": 1,
    "PageSize": 20
  }
}

5.3 更新素材组

使用 UpdateAssetGroup 修改素材组的名称和描述。

POST /openapi/volcengine/?Action=UpdateAssetGroup&Version=2024-01-01

参数	类型	必填	说明
`Id`	string	是	素材组 ID
`Name`	string	否	新名称，最长 64 个字符；传空字符串可清空
`Description`	string	否	新描述，最长 300 个字符；传空字符串可清空
`ProjectName`	string	否	只能使用 `default`，省略时自动取默认值

{
  "Id": "group-20260816170000-a1b2c",
  "Name": "品牌人物素材组",
  "Description": "2026 秋季广告人物参考",
  "ProjectName": "default"
}

成功响应返回更新后的同一素材组 ID：

{
  "ResponseMetadata": {
    "RequestId": "20260816180200ABCDEF1234567890",
    "Action": "UpdateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-20260816170000-a1b2c"
  }
}

更新后，ListAssetGroups 和 GetAssetGroup 会返回新的名称与描述。

5.4 更新素材

使用 UpdateAsset 修改素材名称。

POST /openapi/volcengine/?Action=UpdateAsset&Version=2024-01-01

参数	类型	必填	说明
`Id`	string	是	素材 ID
`Name`	string	否	新名称，最长 64 个字符；传空字符串可清空
`ProjectName`	string	否	只能使用 `default`，省略时自动取默认值

{
  "Id": "asset-20260816173000-d4e5f",
  "Name": "品牌人物正面照",
  "ProjectName": "default"
}

{
  "ResponseMetadata": {
    "RequestId": "20260816180300ABCDEF1234567890",
    "Action": "UpdateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "asset-20260816173000-d4e5f"
  }
}

更新后，ListAssets 和 GetAsset 会返回新的素材名称。

5.5 Python 调用示例

复用第 1.3.10 节的 call_openmove 函数即可调用这四个接口：

5.6 常见错误

HTTP 状态码	错误码	常见原因
`400`	`InvalidParameter`	页码、分页大小、排序字段、状态或字段长度不合法
`401`	`InvalidToken`	缺少有效令牌或令牌分组
`404`	`ResourceNotFound`	资源不存在、不在当前令牌作用域内，或更新时传入了非 `default` 项目名
`503`	`ProviderUnavailable`	当前令牌分组暂时不可用

6. 轮询与资源管理建议

素材状态建议每 5 秒查询一次，并设置业务超时；成功状态应兼容 Active、Ready 和 READY。

活体认证建议每 3～5 秒查询一次，最长不超过会话的 30 分钟有效期。

视频任务建议根据业务并发设置合理轮询间隔，对 HTTP 429 和 5xx 使用退避重试。

URL、video_url 和 last_frame_url 可能是带签名的临时地址，应及时下载并转存。

使用同一 Open Move 账号创建、查询、更新和删除素材；素材 ID、素材组 ID 和活体认证令牌均受所属账号和令牌访问范围约束。

删除素材组前先停止相关生成任务并确认业务不再引用该组；删除真人素材组后，如需再次上传真人素材，必须重新完成活体认证。

Open Move Seedance 视频生成 API 完整使用指南

目录#

1. 接入信息#

1.1 基础 URL#

1.2 鉴权方式#

1.3 火山 V4 签名算法#

1.3.1 签名固定配置#

1.3.2 第一步：生成请求体和 Payload Hash#

1.3.3 第二步：生成 X-Date#

1.3.4 第三步：构造 Canonical Query String#

1.3.5 第四步：构造 Canonical Headers 和 Signed Headers#

1.3.6 第五步：构造 Canonical Request#

1.3.7 第六步：构造 String to Sign#

1.3.8 第七步：派生签名密钥并计算 Signature#

1.3.9 第八步：构造 Authorization 并发送请求#

1.3.10 可直接使用的 Python 手动签名示例#

1.4 使用火山官方 SDK#

1.4.1 Go SDK#

1.4.2 Python SDK#

1.4.3 Java#

1.4.4 Node.js SDK#

1.5 素材与真人认证接口的通用响应#

2. Action API 调用参考#

2.1 素材组 Action#

2.2 素材 Action#

2.3 真人认证 Action#

2.4 完整调用示例#

3. 基础模块：使用普通素材生成视频#

步骤一：上传素材#

接口地址#

请求方式#

请求头#

请求体#

响应体#

步骤二：查询素材并等待处理成功#

接口地址#

请求方式#

请求头#

请求体#

响应体#

步骤三：使用素材 ID 生成视频#

接口地址#

请求方式#

请求头#

请求体#

响应体#

步骤四：通过任务 ID 查询视频任务#

接口地址#

请求方式#

请求头#

请求体#

响应体#

Seedance 2.5 Draft：草稿预览与正式生成#

步骤五：取消或删除视频任务#

接口地址#

请求方式#

请求头#

请求体#

响应体#

步骤六：删除素材#

接口地址#

请求方式#

请求头#

请求体#

响应体#

4. 真人人像模块#

步骤一：进行真人活体认证#

接口地址#

请求方式#

请求头#

请求体#

响应体#

步骤二：查询活体认证状态#

接口地址#

请求方式#

请求头#

请求体#

响应体#

步骤三：上传真人人像到真人素材库#

接口地址#

目录

1. 接入信息

1.1 基础 URL

1.2 鉴权方式

1.3 火山 V4 签名算法

1.3.1 签名固定配置

1.3.2 第一步：生成请求体和 Payload Hash

1.3.3 第二步：生成 X-Date

1.3.4 第三步：构造 Canonical Query String

1.3.5 第四步：构造 Canonical Headers 和 Signed Headers

1.3.6 第五步：构造 Canonical Request

1.3.7 第六步：构造 String to Sign

1.3.8 第七步：派生签名密钥并计算 Signature

1.3.9 第八步：构造 Authorization 并发送请求

1.3.10 可直接使用的 Python 手动签名示例

1.4 使用火山官方 SDK

1.4.1 Go SDK

1.4.2 Python SDK

1.4.3 Java

1.4.4 Node.js SDK

1.5 素材与真人认证接口的通用响应

2. Action API 调用参考

2.1 素材组 Action

2.2 素材 Action

2.3 真人认证 Action

2.4 完整调用示例

3. 基础模块：使用普通素材生成视频

步骤一：上传素材

接口地址

请求方式

请求头

请求体

响应体

步骤二：查询素材并等待处理成功

接口地址

请求方式

请求头

请求体

响应体

步骤三：使用素材 ID 生成视频

接口地址

请求方式

请求头

请求体

响应体

步骤四：通过任务 ID 查询视频任务

接口地址

请求方式

请求头

请求体

响应体

Seedance 2.5 Draft：草稿预览与正式生成

步骤五：取消或删除视频任务

接口地址

请求方式

请求头

请求体

响应体

步骤六：删除素材

接口地址

请求方式

请求头

请求体

响应体

4. 真人人像模块

步骤一：进行真人活体认证

接口地址

请求方式

请求头

请求体

响应体

步骤二：查询活体认证状态

接口地址

请求方式

请求头

请求体

响应体

步骤三：上传真人人像到真人素材库

接口地址

请求方式