Seedance 视频生成 & 素材库 & 真人认证 API 使用文档

概述

Seedance 是火山引擎（字节跳动）推出的 AI 视频生成服务，支持文本生成视频（Text-to-Video）和图片生成视频（Image-to-Video）。本文档面向 API 调用方，包含以下能力：

Seedance 视频任务（创建 / 查询 / 取消）
Seedance 素材库管理（火山原生格式）（Asset / AssetGroup 创建、管理、删除）
真人认证（火山原生格式）（拉起 H5 / 获取认证结果）

服务地址与鉴权

视频生成 & 素材审核

Base URL：
- https://api.agentpivot.ai（海外）
- https://api.agentpivot.net（国内）
鉴权（二选一）：
- x-api-key: <your-api-key>
- Authorization: Bearer <your-key>
Content-Type: application/json
余额要求：账户可用人民币余额建议 >= ¥10

素材库（原生格式）& 真人认证

Base URL：https://api.agentpivot.net/
统一鉴权：

http

Authorization: Bearer sk-<API_TOKEN>
Content-Type: application/json

支持的模型

具体模型名以 AP 平台"模型管理"为准。

模型名称	说明
`doubao-seedance-2-0-260128`	Seedance 2.0，最新旗舰模型
`doubao-seedance-2.0-fast`	Seedance 2.0 Fast，更适合注重成本与生成速度
`doubao-seedance-1-5-pro-251215`	Seedance 1.5 Pro
`doubao-seedance-1-0-pro-250528`	Seedance 1.0 Pro
`doubao-seedance-1-0-pro-fast-251015`	Seedance 1.0 Pro Fast，推理速度更快

说明：CreateAsset 创建的素材 Id（需处于 Active 状态）可用于 Seedance 2.0 和 Seedance 2.5 模型生成视频。

接口列表

视频生成

接口	方法	路径
创建视频生成任务	POST	`/api/v3/contents/generations/tasks`
查询视频生成结果	GET	`/api/v3/contents/generations/tasks/{task_id}`
取消任务	POST	`/api/v3/contents/generations/tasks/{task_id}/cancel`

素材库管理（火山原生格式）

接口	Action	说明
创建素材资产组	`CreateAssetGroup`	创建素材资产组合
创建素材资产	`CreateAsset`	上传个人素材资产
查询资产组列表	`ListAssetGroups`	查询素材资产组合列表
查询资产列表	`ListAssets`	查询素材资产列表
查询资产信息	`GetAsset`	查询单个素材资产
查询资产组信息	`GetAssetGroup`	查询单个素材资产组
更新资产组	`UpdateAssetGroup`	更新素材资产组合信息
更新资产	`UpdateAsset`	更新素材资产信息
删除资产	`DeleteAsset`	删除单个素材资产
删除资产组	`DeleteAssetGroup`	删除指定素材组

真人认证（火山原生格式）

接口	Action	说明
拉起真人认证 H5	`CreateVisualValidateSession`	创建真人认证会话
获取认证结果	`GetVisualValidateResult`	获取真人 Asset Group ID

一、视频生成

1. 创建视频生成任务

请求

POST https://api.agentpivot.ai/api/v3/contents/generations/tasks
Content-Type: application/json
x-api-key: <YOUR_API_KEY>

请求体参数

参数	类型	必填	说明
`model`	string	是	模型名称，见上方支持的模型表
`content`	array	是	输入内容数组，可包含文本和/或图片
`content[].type`	string	是	内容类型：`text` 或 `image_url`
`content[].text`	string	条件必填	当 `type` 为 `text` 时，视频描述提示词
`content[].image_url.url`	string	条件必填	当 `type` 为 `image_url` 时，参考图片的 URL
`ratio`	string	否	视频比例，如 `"16:9"`、`"9:16"`、`"1:1"`、`"adaptive"`
`duration`	integer	否	视频时长（秒），如 `5`、`10`
`generate_audio`	boolean	否	是否同时生成音频，`true` 为开启
`watermark`	boolean	否	是否添加水印，`false` 为关闭

请求体示例

图生视频（Image-to-Video）

json

{
  "model": "doubao-seedance-2.0",
  "content": [
    {
      "type": "text",
      "text": "女孩抱着狐狸，女孩睁开眼，温柔地看向镜头，狐狸友善地抱着，镜头缓缓拉出，女孩的头发被风吹动，可以听到风声"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/i2v_foxrgirl.png"
      }
    }
  ],
  "generate_audio": true,
  "ratio": "adaptive",
  "duration": 5,
  "watermark": false
}

文生视频（Text-to-Video）

bash

#!/usr/bin/env bash
curl -X POST "https://api.agentpivot.ai/api/v3/contents/generations/tasks" \
  -H "Content-Type: application/json" \
  -H "x-api-key: <你的API_KEY>" \
  -d '{
    "model": "doubao-seedance-2.0",
    "content": [
      { "type": "text", "text": "女孩抱着狐狸，镜头缓慢拉远，头发随风飘动" }
    ],
    "duration": 5,
    "resolution": "720p",
    "ratio": "16:9"
  }'

响应示例

json

{
  "id": "cgt-20260512160924-r56z5",
  "object": "video",
  "model": "doubao-seedance-2.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1778573371
}

响应字段

字段	类型	说明
`id`	string	任务 ID，用于后续查询任务结果
`model`	string	使用的模型名称
`status`	string	任务状态，如 `generating`（生成中）
`created_at`	integer	任务创建时间（Unix 时间戳）

2. 查询视频生成结果

请求

GET https://api.agentpivot.ai/api/v3/contents/generations/tasks/{task_id}
Content-Type: application/json
x-api-key: <YOUR_API_KEY>

cURL 示例

bash

curl "https://api.agentpivot.ai/api/v3/contents/generations/tasks/cgt-20260326161825-4t8rj" \
  -H "Content-Type: application/json" \
  -H "x-api-key: $API_KEY"

响应字段

字段	类型	说明
`id`	string	任务 ID
`model`	string	使用的模型名称
`status`	string	任务状态：`generating` / `success` / `failed`
`content`	object	生成结果，`status` 为 `success` 时返回
`content.video_url`	string	生成的视频下载地址
`error`	object	错误信息，`status` 为 `failed` 时返回
`created_at`	integer	任务创建时间（Unix 时间戳）

响应示例（成功）

json

{
  "content": {
    "video_url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/xxxx.mp4?X-Tos-Algorithm=..."
  },
  "cost": {
    "currency": "CNY",
    "input_cost": "0.0000000000",
    "output_cost": "5.0093914000",
    "total_cost": "5.0093914000"
  },
  "created_at": 1778573371,
  "draft": false,
  "duration": 5,
  "framespersecond": 24,
  "generate_audio": true,
  "id": "cgt-20260512160924-r56z5",
  "model": "doubao-seedance-2.0",
  "ratio": "16:9",
  "resolution": "720p",
  "seed": 25633,
  "status": "succeeded",
  "updated_at": 1778573700,
  "usage": {
    "completion_tokens": 108900,
    "total_tokens": 108900
  }
}

访问或下载 video_url 即可。

使用流程

1. 调用创建任务接口 → 获取 task_id
2. 轮询查询接口（建议间隔 5-10 秒）→ 检查 status
3. 当 status 为 "success" 时 → 从 content.video_url 下载视频

3. 取消任务

请求

POST /api/v3/contents/generations/tasks/{task_id}/cancel

说明

取消能力受上游线路限制；
当前线路不支持取消时会返回 400。

二、素材库管理（火山原生格式）

服务地址：https://api.agentpivot.net/ 鉴权：Authorization: Bearer sk-<API_TOKEN>

4. 创建素材资产组（CreateAssetGroup）

创建素材资产组合。

POST https://api.agentpivot.net/volc/native/?Action=CreateAssetGroup&Version=2024-01-01

请求体

json

{
  "Name": "ap-win-portrait-group",
  "Description": "虚拟人像素材组示例",
  "GroupType": "AIGC",
  "ProjectName": "default"
}

响应示例

json

{
  "ResponseMetadata": {
    "RequestId": "202608241154123C4EE50918B8D151CA9C",
    "Action": "CreateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-20260824115412-nklqc",
    "ProjectName": "default"
  }
}

5. 创建素材资产（CreateAsset）

创建素材资产。创建后可利用返回的素材 Id（需处于 Active 状态）用于 Seedance 2.0 和 Seedance 2.5 模型生成视频。

POST https://api.agentpivot.net/volc/native/?Action=CreateAsset&Version=2024-01-01

请求体

json

{
  "GroupId": "group-20260824115412-nklqc",
  "URL": "https://ark-media-asset.tos-cn-beijing.volces.com/xxxx/xxxx.jpg?X-Tos-Algorithm=...",
  "Name": "demo-portrait-image",
  "AssetType": "Image",
  "ProjectName": "default"
}

响应示例

json

{
  "ResponseMetadata": {
    "RequestId": "2026082412010217E1208AE1BF30CF305E",
    "Action": "CreateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Error": { "Code": "", "Message": "" },
    "Id": "asset-20260824120102-b7xzd",
    "Moderation": { "Strategy": "Default" },
    "ProjectName": "default"
  }
}

6. 查询素材资产组列表（ListAssetGroups）

POST https://api.agentpivot.net/volc/native/?Action=ListAssetGroups&Version=2024-01-01

请求体

json

{
  "Filter": {
    "GroupIds": ["group-20260824115412-nklqc"],
    "GroupType": "AIGC",
    "Name": "demo-portrait-group-renamed"
  },
  "PageNumber": 1,
  "PageSize": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc"
}

响应示例

json

{
  "ResponseMetadata": {
    "RequestId": "20260824135618362C3E5C3F141ACF331E",
    "Action": "ListAssetGroups",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Items": [
      {
        "CreateTime": "2026-08-24T03:54:12Z",
        "Description": "更新后的虚拟人像素材组描述",
        "GroupType": "AIGC",
        "Id": "group-20260824115412-nklqc",
        "Name": "demo-portrait-group-renamed",
        "ProjectName": "default",
        "UpdateTime": "2026-08-24T04:35:28Z"
      }
    ],
    "PageNumber": 1,
    "PageSize": 10,
    "ProjectName": "default",
    "TotalCount": 95
  }
}

7. 查询素材资产列表（ListAssets）

POST https://api.agentpivot.net/volc/native/?Action=ListAssets&Version=2024-01-01

请求体

json

{
  "Filter": {
    "GroupIds": ["group-20240514212750-b5e9m"],
    "GroupType": "AIGC",
    "Statuses": ["Active"],
    "Name": "demo-portrait-image"
  },
  "PageNumber": 1,
  "PageSize": 10,
  "SortBy": "CreateTime",
  "SortOrder": "Desc",
  "ProjectName": "default"
}

响应示例

json

{
  "ResponseMetadata": {
    "RequestId": "20260824160001E1BE8FDD58D177E03387",
    "Action": "ListAssets",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Error": { "Code": "", "Message": "" },
    "Items": [
      {
        "AssetType": "Video",
        "CreateTime": "2026-08-24T07:59:53Z",
        "Error": { "Code": "", "Message": "" },
        "GroupId": "group-20260716223902-9qdnk",
        "Id": "asset-20260824155952-5jh94",
        "Moderation": { "Strategy": "Default" },
        "Name": "rp_2091797602466406402_video",
        "ProjectName": "default",
        "Status": "Active",
        "URL": "https://ark-media-asset.tos-cn-beijing.volces.com/xxxx/xxxx.mp4?X-Tos-Algorithm=...",
        "UpdateTime": "2026-08-24T07:59:58Z"
      }
    ],
    "Moderation": { "Strategy": "Default" },
    "PageNumber": 1,
    "PageSize": 1,
    "ProjectName": "default",
    "TotalCount": 317972
  }
}

8. 查询素材资产信息（GetAsset）

POST https://api.agentpivot.net/volc/native/?Action=GetAsset&Version=2024-01-01

请求体

json

{
  "Id": "asset-20260824120102-b7xzd",
  "ProjectName": "default"
}

响应示例

json

{
  "ResponseMetadata": {
    "RequestId": "202608241207148E3BF2610D253CD2AA99",
    "Action": "GetAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "AssetType": "Image",
    "CreateTime": "2026-08-24T04:01:02Z",
    "Error": { "Code": "", "Message": "" },
    "GroupId": "group-20260824115412-nklqc",
    "Id": "asset-20260824120102-b7xzd",
    "Moderation": { "Strategy": "Default" },
    "Name": "demo-portrait-image",
    "ProjectName": "default",
    "Status": "Active",
    "URL": "https://ark-media-asset.tos-cn-beijing.volces.com/xxxx/xxxx.jpg?X-Tos-Algorithm=...",
    "UpdateTime": "2026-08-24T04:01:03Z"
  }
}

9. 查询素材资产组信息（GetAssetGroup）

POST https://api.agentpivot.net/volc/native/?Action=GetAssetGroup&Version=2024-01-01

请求体

json

{
  "Id": "group-20260824115412-nklqc",
  "ProjectName": "default"
}

响应示例

json

{
  "ResponseMetadata": {
    "RequestId": "2026082412310174E0574AED238C4DBC6F",
    "Action": "GetAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "CreateTime": "2026-08-24T03:54:12Z",
    "Description": "虚拟人像素材组示例",
    "GroupType": "AIGC",
    "Id": "group-20260824115412-nklqc",
    "Name": "jy-win-portrait-group",
    "ProjectName": "default",
    "UpdateTime": "2026-08-24T03:54:12Z"
  }
}

10. 更新素材资产组（UpdateAssetGroup）

POST https://api.agentpivot.net/volc/native/?Action=UpdateAssetGroup&Version=2024-01-01

请求体

json

{
  "Id": "group-20260824115412-nklqc",
  "Name": "demo-portrait-group-renamed",
  "Description": "更新后的虚拟人像素材组描述",
  "ProjectName": "default"
}

响应示例

json

{
  "ResponseMetadata": {
    "RequestId": "20260824123528C037BD48126C7C52B915",
    "Action": "UpdateAssetGroup",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Id": "group-20260824115412-nklqc",
    "ProjectName": "default"
  }
}

11. 更新素材资产（UpdateAsset）

POST https://api.agentpivot.net/volc/native/?Action=UpdateAsset&Version=2024-01-01

请求体

json

{
  "Id": "asset-20260824120102-b7xzd",
  "Name": "demo-portrait-image-renamed",
  "ProjectName": "default"
}

响应示例

json

{
  "ResponseMetadata": {
    "RequestId": "20260824123935F56E8E045FB71BD64CDE",
    "Action": "UpdateAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {
    "Error": { "Code": "", "Message": "" },
    "Id": "asset-20260824120102-b7xzd",
    "Moderation": { "Strategy": "Default" },
    "ProjectName": "default"
  }
}

12. 删除素材资产（DeleteAsset）

POST https://api.agentpivot.net/volc/native/?Action=DeleteAsset&Version=2024-01-01

请求体

json

{
  "Id": "asset-20260824120102-b7xzd",
  "ProjectName": "default"
}

响应示例

json

{
  "ResponseMetadata": {
    "RequestId": "202608241242071B68038B33A8014B7096",
    "Action": "DeleteAsset",
    "Version": "2024-01-01",
    "Service": "ark",
    "Region": "cn-beijing"
  },
  "Result": {}
}

13. 删除素材资产组（DeleteAssetGroup）

删除指定素材组。

POST https://api.agentpivot.net/volc/native/?Action=DeleteAssetGroup&Version=2024-01-01

请求体

json

{
  "Id": "group-20260824115412-nklqc",
  "ProjectName": "default"
}

三、真人认证（火山原生格式）

服务地址：https://api.agentpivot.net/ 鉴权：Authorization: Bearer sk-<API_TOKEN>

14. 拉起真人认证 H5（CreateVisualValidateSession）

POST https://api.agentpivot.net/volc/native/?Action=CreateVisualValidateSession&Version=2024-01-01

请求体

json

{
  "CallbackURL": "https://your-domain.example.com/callback",
  "ProjectName": "default"
}

15. 获取真人认证结果（GetVisualValidateResult）

获取真人 Asset Group ID。

POST https://api.agentpivot.net/volc/native/?Action=GetVisualValidateResult&Version=2024-01-01

请求体

json

{
  "BytedToken": "vvs-20240514212750-c8f2p",
  "ProjectName": "default"
}

Seedance 视频生成 & 素材库 & 真人认证 API 使用文档 ​

概述 ​

服务地址与鉴权 ​

视频生成 & 素材审核 ​

素材库（原生格式）& 真人认证 ​

支持的模型 ​

接口列表 ​

视频生成 ​

素材库管理（火山原生格式） ​

真人认证（火山原生格式） ​

一、视频生成 ​

1. 创建视频生成任务 ​

请求 ​

请求体参数 ​

请求体示例 ​

图生视频（Image-to-Video） ​

文生视频（Text-to-Video） ​

响应示例 ​

响应字段 ​

2. 查询视频生成结果 ​

请求 ​

cURL 示例 ​

响应字段 ​

响应示例（成功） ​

使用流程 ​

3. 取消任务 ​

二、素材库管理（火山原生格式） ​

4. 创建素材资产组（CreateAssetGroup） ​

5. 创建素材资产（CreateAsset） ​

6. 查询素材资产组列表（ListAssetGroups） ​

7. 查询素材资产列表（ListAssets） ​

8. 查询素材资产信息（GetAsset） ​

9. 查询素材资产组信息（GetAssetGroup） ​

10. 更新素材资产组（UpdateAssetGroup） ​

11. 更新素材资产（UpdateAsset） ​

12. 删除素材资产（DeleteAsset） ​

13. 删除素材资产组（DeleteAssetGroup） ​

三、真人认证（火山原生格式） ​

14. 拉起真人认证 H5（CreateVisualValidateSession） ​

15. 获取真人认证结果（GetVisualValidateResult） ​

Seedance 视频生成 & 素材库 & 真人认证 API 使用文档

概述

服务地址与鉴权

视频生成 & 素材审核

素材库（原生格式）& 真人认证

支持的模型

接口列表

视频生成

素材库管理（火山原生格式）

真人认证（火山原生格式）

一、视频生成

1. 创建视频生成任务

请求

请求体参数

请求体示例

图生视频（Image-to-Video）

文生视频（Text-to-Video）

响应示例

响应字段

2. 查询视频生成结果

请求

cURL 示例

响应字段

响应示例（成功）

使用流程

3. 取消任务

二、素材库管理（火山原生格式）

4. 创建素材资产组（CreateAssetGroup）

5. 创建素材资产（CreateAsset）

6. 查询素材资产组列表（ListAssetGroups）

7. 查询素材资产列表（ListAssets）

8. 查询素材资产信息（GetAsset）

9. 查询素材资产组信息（GetAssetGroup）

10. 更新素材资产组（UpdateAssetGroup）

11. 更新素材资产（UpdateAsset）

12. 删除素材资产（DeleteAsset）

13. 删除素材资产组（DeleteAssetGroup）

三、真人认证（火山原生格式）

14. 拉起真人认证 H5（CreateVisualValidateSession）

15. 获取真人认证结果（GetVisualValidateResult）