From ee7cdec9e3d510c137c4ecddd1131f957d445f8a Mon Sep 17 00:00:00 2001
From: seaislee1209 <seaislee129@gmail.com>
Date: Sat, 4 Apr 2026 13:27:13 +0800
Subject: [PATCH] add docs

---
 ...�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）.md |  961 +++++++++++++
 ...·æ�ƒé™�填客户å��称】Assets API å�‚考文档（邀测用户版）.md | 1005 ++++++++++++++
 ...ance 2.0 & 2.0 fast API文档（邀测用户版）.md |  692 ++++++++++
 ...·æ�ƒé™�填客户å��称】Assets API å�‚考文档（邀测用户版）.md | 1201 +++++++++++++++++
 ...·å��称】控制å�°ä¸Šä¼ è‡ªæœ‰è™šæ‹Ÿäººåƒ�至素æ��资产库（邀测用户版）.md |  128 ++
 ...®¢æˆ·å��称】ç§�域虚拟人åƒ�ç´ æ��资产库使用指å�—（邀测用户版）.md |  314 +++++
 docs/API文档/关于��值.md                    |  487 +++++++
 docs/API文档/推�节点.md                      | 1074 +++++++++++++++
 8 files changed, 5862 insertions(+)
 create mode 100644 docs/API文档/3-28-�申请��填客户�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）.md
 create mode 100644 docs/API文档/3-31「�密信���申请��填客户�称】Assets API �考文档（邀测用户版）.md
 create mode 100644 docs/API文档/old-Seedance 2.0 & 2.0 fast API文档（邀测用户版）.md
 create mode 100644 docs/API文档/old-「�密信���申请��填客户�称】Assets API �考文档（邀测用户版）.md
 create mode 100644 docs/API文档/「�密信���申请��填客户�称】控制�上传自有虚拟人�至素�资产库（邀测用户版）.md
 create mode 100644 docs/API文档/「�密信���申请��填客户�称】�域虚拟人�素�资产库使用指�（邀测用户版）.md
 create mode 100644 docs/API文档/关于��值.md
 create mode 100644 docs/API文档/推�节点.md

diff --git a/docs/API文档/3-28-�申请��填客户�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）.md b/docs/API文档/3-28-�申请��填客户�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）.md
new file mode 100644
index 0000000..8b55529
--- /dev/null
+++ b/docs/API文档/3-28-�申请��填客户�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）.md	
@@ -0,0 +1,961 @@
+# �申请��填客户�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）
+
+该文档目�仅�开白客户使用，���请和销管确认客户是�在开白��内
+
+***�������】该文档�制客户申请��，�有返回了�务�议的客户方�申请***
+
+本文介� Seedance 2.0 & 2.0 fast 模型相较于存�模型 **新增/�置有区别&#x20;**&#x7684; API �数介�，存� API �数的完整介��� [视频生� API](https://www.volcengine.com/docs/82379/1520758?lang=zh)。
+
+> 本文档仅�预览�邀测用户使用：
+>
+> * �承诺正�API上线100%一致。
+>
+> * 仅�邀测用户阅读，请勿截图/分享给其他人员。
+>
+> * 您上传的内容请确�由您原创或已�得授�。
+
+# 模型能力
+
+> **Seedance 2.0 和 Seedance 2.0 fast �供的模型能力一致，**&#x8FFD;求最高生��质，推�使用 **Seedance 2.0**；更注��本与生�速度，��求���质，推�使用 **Seedance 2.0 fast**。
+
+**Seedance 2.0 & 2.0 fast (有声视频/无声视频)**
+
+* **多模��考生视频**：输入�考图片（0\~9）+�考视频（0\~3）+ �考音频（0\~3）+ 文本�示�（�选）生� 1 个目标视频。支�生�全新视频�编辑视频�延长视频。
+
+> **注�：���独输入音频，应至少包� 1 个�考视频或图片。**
+
+* **图生视频-首尾帧**：输入首帧图片+尾帧图片+文本�示�（�选）生� 1 个目标视频。
+
+* **图生视频-首帧**：输入首帧图片+文本�示�（�选）生� 1 个目标视频。
+
+* **文生视频**：输入文本�示�生� 1 个目标视频。
+
+
+
+**模型能力对比表：**
+
+| 模型�称         |          | [Seedance 2.0](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-2-0)  | [Seedance 2.0 fast](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-2-0-fast\&projectName=default) | [Seedance 1.5 pro](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-5-pro\&projectName=default)   | [Seedance 1.0 pro ](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-0-pro\&projectName=default) | [Seedance 1.0 pro fast ](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-0-pro-fast\&projectName=default) | [Seedance 1.0 lite i2v](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-0-lite-i2v\&projectName=default)   | [Seedance-1.0 lite t2v ](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-0-lite-t2v) |
+| ------------ | -------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| Model ID     |          | doubao-seedance-2-0-260128                                                                                    | doubao-seedance-2-0-fast-260128                                                                                                             | doubao-seedance-1-5-pro-251215                                                                                                              | doubao-seedance-1-0-pro-250528                                                                                                             | doubao-seedance-1-0-pro-fast-251015                                                                                                                  | doubao-seedance-1-0-lite-i2v-250428                                                                                                                   | doubao-seedance-1-0-lite-t2v-250428                                                                                             |
+| 文生视频         |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | ✅                                                                                                                                                    | ✅                                                                                                                                                     | ✅                                                                                                                               |
+| 图生视频-首帧      |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | ✅                                                                                                                                                    | ✅                                                                                                                                                     | �                                                                                                                               |
+| 图生视频-首尾帧     |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | �                                                                                                                                                    | ✅                                                                                                                                                     | �                                                                                                                               |
+| 多模��考�New】   | 图片�考     | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | ✅                                                                                                                                                     | �                                                                                                                               |
+|              | 视频�考     | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+|              | 组��考     | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 编辑视频�New】    |          | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 延长视频�New】    |          | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 生�有声视频       |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| �网�索增强�New】  |          | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | [�](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/f359753773c94d97885008ca1223c9bc)                                              | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 样片模�         |          | �                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 返回视频尾帧       |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | ✅                                                                                                                                                    | ✅                                                                                                                                                     | ✅                                                                                                                               |
+| 输出视频规格       | 输出分辨率    | 480p, 720p                                                                                                    |                                                                                                                                             | 480p, 720p, 1080p                                                                                                                           | 480p, 720p, 1080p                                                                                                                          | 480p, 720p, 1080p                                                                                                                                    | 480p, 720p, 1080p                                                                                                                                     | 480p, 720p, 1080p                                                                                                               |
+|              | 输出宽高比    | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16                                                                               |                                                                                                                                             |                                                                                                                                             |                                                                                                                                            |                                                                                                                                                      |                                                                                                                                                       |                                                                                                                                 |
+|              | 输出时长     | 4\~15 秒                                                                                                       |                                                                                                                                             |  4\~12 秒                                                                                                                                    |  2\~12 秒                                                                                                                                   |  2\~12 秒                                                                                                                                             |  2\~12 秒                                                                                                                                              |  2\~12 秒                                                                                                                        |
+|              | 输出视频格�   | mp4                                                                                                           |                                                                                                                                             | mp4                                                                                                                                         | mp4                                                                                                                                        | mp4                                                                                                                                                  | mp4                                                                                                                                                   | mp4                                                                                                                             |
+| 离线推�         |          | [�](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/f359753773c94d97885008ca1223c9bc)                 |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | ✅                                                                                                                                                    | ✅                                                                                                                                                     | ✅                                                                                                                               |
+| 在线推���       | RPM      | 600                                                                                                           |                                                                                                                                             | 600                                                                                                                                         | 600                                                                                                                                        | 600                                                                                                                                                  | 300                                                                                                                                                   | 300                                                                                                                             |
+|              | 并�数      | 10                                                                                                            |                                                                                                                                             | 10                                                                                                                                          | 10                                                                                                                                         | 10                                                                                                                                                   | 5                                                                                                                                                     | 5                                                                                                                               |
+| 离线推���       | TPD      | -                                                                                                             |                                                                                                                                             | 5000亿                                                                                                                                       | 5000亿                                                                                                                                      | 5000亿                                                                                                                                                | 2500亿                                                                                                                                                 | 2500亿                                                                                                                           |
+
+
+
+
+
+# Creat-创建视频生�任务
+
+> POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks
+
+## 请求�数
+
+
+
+#### **content** `object[]` `必选`
+
+输入给模型，生�视频的信�，支�文本�图片�音频�视频�样片任务 ID。支�以下几�组�：
+
+* **文本**
+
+* **文本（�选）+ 图片**
+
+* **文本（�选）+ 视频**
+
+* **文本（�选）+ 图片 + 音频**
+
+* **文本（�选）+ 图片 + 视频**
+
+* **文本（�选）+ 视频 + 音频**
+
+* **文本（�选）+ 图片 + 视频 + 音频**
+
+***
+
+**信�类型：**
+
+* **文本信�**`object`
+
+输入给模型的�示�信�。
+
+***
+
+content.**type&#x20;**`string`  `必选`
+
+输入内容的类型，此处应为 **text**。
+
+***
+
+content.**text&#x20;**`string`  `必选`
+
+输入给模型的文本�示�，�述期望生�的视频。
+
+支�中英文。建议中文�超过500字，英文�超过1000�。字数过多信�容易分散，模型�能因此忽略细节，�关注�点，造�视频缺失部分元素。�示�的更多使用技巧请�� [Seedance �示�指�](https://www.volcengine.com/docs/82379/1587797)。
+
+
+
+
+
+* **图片信�** `object`
+
+输入给模型的图片信�。
+
+***
+
+content.**type&#x20;**`string` `必选`
+
+输入内容的类型，此处应为 **image\_url**。
+
+***
+
+content.**image\_url&#x20;**`object`  `必选`
+
+输入给模型的图片对象。
+
+***
+
+content.image\_url.**url&#x20;**`string`  `必选`
+
+图片 URL �图片 Base64 编��素� ID。
+
+* 图片 URL：填入图片的公网 URL。
+
+* Base64 编�：将本地文件转�为 Base64 编�字符串，然��交给大模型。�循格�：data:image/<图片格�>;base64,\<Base64编�>，注� <图片格�> 需�写，如 data:image/png;base64,{base64\_image}。
+
+* 素� ID：用于视频生�的预置素��虚拟人�的 ID，�循格�：asset://\<ASSET\_ID>，�从 [素�&虚拟人�库](https://console.volcengine.com/ark-stg/region:ark-stg+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128) 获�，详细使用请��[文档](https://www.volcengine.com/docs/82379/2223965?lang=zh)。
+
+> **传入�张图片�求**
+>
+> * 格�：jpeg�png�webp�bmp�tiff�gif
+>
+> * 宽高比（宽/高）： (0.4, 2.5)&#x20;
+>
+> * 宽高长度（px）：(300, 6000)
+>
+> * 大�：�张图片�于 30 MB。请求体大��超过 64 MB。大文件请勿使用Base64编�。
+>
+> * 图片数�：
+>
+>   * 图生视频-首帧：1 张
+>
+>   * 图生视频-首尾帧：2 张
+>
+>   * Seedance 2.0 & 2.0 fast 多模��考生视频：1\~9 张
+
+***
+
+content.**role&#x20;**`string` `�件必填`
+
+图片的�置或用途。
+
+> **注�**
+>
+> * **图生视频-首帧**�**图生视频-首尾帧**�**多模��考生视频**（包括�考图�视频�音频）为 3 �互斥场景，**��混用**。
+>
+> * **多模��考生视频**�通过�示�指定�考图片作为首帧/尾帧，间接实现“首尾帧+多模��考�效果。若需严格�障首尾帧和指定图片一致，**优先使用图生视频-首尾帧**（�置 role 为 **first\_frame / last\_frame**）。
+
+***
+
+**图生视频-首帧**
+
+> 需�传入1个 image\_url 对象
+
+* **字段role�值：**
+
+  * **first\_frame 或�填**
+
+***
+
+**图生视频-首尾帧**
+
+> 需�传入2个 image\_url 对象
+
+* **字段role�值：**
+
+  * 首帧图片对应的字段 role 为：**first\_frame**，必填
+
+  * 尾帧图片对应的字段 role 为：**last\_frame**，必填
+
+***
+
+**图生视频-�考图&#x20;**
+
+> �传入 1\~9 个 image\_url 对象
+
+* **字段role�值**：
+
+  * �张�考图对应的字段 role �为：**reference\_image**，必填
+
+
+
+
+
+* **视频信�** `object`&#x20;
+
+输入给模型的视频信�。仅 Seedance 2.0 & 2.0 fast 支�输入视频。2026年3月11日起，支�使用本账�下 Seedance 2.0 & 2.0 fast 模型产出的视频作为输入素�，进行视频编辑或延长，其中的真人人脸�正常使用，�会触�审核拦截。
+
+***
+
+content.**type&#x20;**`string`  `必选`
+
+输入内容的类型，此处应为 **video\_url**。
+
+***
+
+content.**video\_url&#x20;**`object`  `必选`
+
+输入给模型的视频对象。
+
+***
+
+content.video\_url.**url&#x20;**`string`  `必选`
+
+视频URL�素� ID。
+
+* 视频 URL：填入视频的公网 URL。
+
+* 素� ID：用于视频生�的预置素��虚拟人�视频的 ID，�循格�：asset://\<ASSET\_ID>。�从[素�&虚拟人�库](https://console.volcengine.com/ark-stg/region:ark-stg+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128)获�。
+
+> **传入�个视频�求**
+>
+> * 视频格�：mp4�mov。
+>
+> * 分辨率：480p�720p
+>
+> * 时长：�个视频时长 \[2, 15] s，最多传入 3 个�考视频，所有视频总时长�超过 15s。
+>
+> * 尺寸：
+>
+>   * 宽高比（宽/高）：\[0.4, 2.5]
+>
+>   * 宽高长度（px）：\[300, 6000]
+>
+>   * 画��素（宽 × 高）：\[409600, 927408] ，示例：
+>
+>     * 画�尺寸 640×640=409600 满足最�值 ；
+>
+>     * 画�尺寸 834×1112=927408 满足最大值。
+>
+> * 大�：�个视频�超过 50 MB。
+>
+> * 帧率 (FPS)：\[24, 60]&#x20;
+
+***
+
+content.**role&#x20;**`string` `�件必填`
+
+视频的�置或用途。当�仅支� **reference\_video**。
+
+
+
+
+
+* **音频信�&#x20;**`object`&#x20;
+
+输入给模型的音频信�。仅 Seedance 2.0 & 2.0 fast 支�输入音频。注����独输入音频，应至少包� 1 个�考视频或图片。
+
+***
+
+content.**type&#x20;**`string`  `必选`
+
+输入内容的类型，此处应为 **audio\_url**。
+
+***
+
+content.**audio\_url&#x20;**`object`  `必选`
+
+输入给模型的音频对象。
+
+***
+
+content.audio\_url.**url&#x20;**`string`  `必选`
+
+音频 URL �音频 Base64 编��素� ID。
+
+* 音频 URL：填入音频的公网 URL。
+
+* Base64 编�：将本地文件转�为 Base64 编�字符串，然��交给大模型。�循格�：data:audio/<音频格�>;base64,\<Base64编�>，注� <音频格�> 需�写，如 data:audio/wav;base64,{base64\_audio}。
+
+* 素� ID：用于视频生�的虚拟人的音频素� ID，�循格�：asset://\<ASSET\_ID>。�从[素�&虚拟人�库](https://console.volcengine.com/ark-stg/region:ark-stg+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128)获�。
+
+> **传入�个音频�求**
+>
+> * 格�：wav�mp3
+>
+> * 时长：�个音频时长 \[2, 15] s，最多传入 3 段�考音频，所有音频总时长�超过 15 s。
+>
+> * 大�：�个音频�超过 15 MB，请求体大��超过 64 MB。大文件请勿使用Base64编�。
+
+***
+
+content.**role&#x20;**`string` `�件必填`
+
+音频的�置或用途。当�仅支� **reference\_audio** 。
+
+
+
+#### **service\_tier** `string`
+
+&#x20;Seedance 2.0 & 2.0 fast 暂�支�
+
+
+
+#### **generate\_audio&#x20;**`boolean`&#x20;
+
+> Seedance 2.0 & 2.0 fast 默认值： true
+
+控制生�的视频是�包�与画��步的声音。
+
+* true：模型输出的视频包��步音频。模型会基于文本�示�与视觉内容，自动生�与之匹�的人声�音效�背景音�。建议将对�部分置于�引�内，以优化音频生�效果。例如：男人��女人说：“你记�，以���以用手指指月亮。�
+
+* false：模型输出的视频为无声视频。
+
+> **说明**
+>
+> 生�的有声视频�为�声�，和传入的音频声�数无关。
+
+####
+
+#### **draft&#x20;**`boolean`
+
+&#x20;Seedance 2.0 & 2.0 fast 暂�支�
+
+
+
+#### **tools&#x20;**`object[]`
+
+> 仅 Seedance 2.0 & 2.0 fast 支�
+
+�置模型�调用的工具。
+
+***
+
+tools.**type&#x20;**`string`
+
+指定使用的工具类型。
+
+* web\_search：�网�索工具。当�仅文生视频支�。
+
+> **说明**
+>
+> * 开��网�索�，模型会根�用户的�示�自主判断是��索互�网内容（如商��天气等）。���生�视频的时效性，但也会增加一定的时延。
+>
+> * 实际�索次数�通过 [查询视频生�任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 usage.tool\_usage.**web\_search** 字段获�，如果为 0 表示未�索。
+
+
+
+#### **resolution&#x20;**&#x20;`string`
+
+> Seedance 2.0 & 2.0 fast  默认值：720p
+
+视频分辨率，�值范围：
+
+* 480p
+
+* 720p
+
+
+
+#### **ratio&#x20;**`string`&#x20;
+
+> Seedance 2.0 & 2.0 fast 默认值： adaptive
+
+生�视频的宽高比例。��宽高比对应的宽高�素值�下方表格。
+
+* 16:9&#x20;
+
+* 4:3
+
+* 1:1
+
+* 3:4
+
+* 9:16
+
+* 21:9
+
+* adaptive：根�输入自动选择最�适的宽高比
+
+> **adaptive 适�规则**
+>
+> 当�置 **ratio** 为 adaptive 时，模型会根�生�场景自动适�宽高比；实际生�的视频宽高比�通过 [查询视频生�任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 **ratio** 字段获�。
+>
+> * 文生视频：根�输入的�示�，智能选择最�适的宽高比。
+>
+> * 首帧 / 首尾帧生视频：根�上传的首帧图片比例，自动选择最接近的宽高比。
+>
+> * 多模��考生视频：根�用户�示��图判断，如果是首帧生视频/编辑视频/延长视频，以该图片/视频为准选择最接近的宽高比；�则，以传入的第一个媒体文件为准（优先级：视频＞图片）选择最接近的宽高比。
+
+***
+
+**��宽高比对应的宽高�素值：**
+
+| 分辨率  | 宽高比  | 宽高�素值    |
+| ---- | ---- | -------- |
+| 480p | 16:9 | 864×496  |
+|      | 4:3  | 752×560  |
+|      | 1:1  | 640×640  |
+|      | 3:4  | 560×752  |
+|      | 9:16 | 496×864  |
+|      | 21:9 | 992×432  |
+| 720p | 16:9 | 1280×720 |
+|      | 4:3  | 1112×834 |
+|      | 1:1  | 960×960  |
+|      | 3:4  | 834×1112 |
+|      | 9:16 | 720×1280 |
+|      | 21:9 | 1470×630 |
+
+
+
+#### **duration** `integer`&#x20;
+
+> Seedance 2.0 & 2.0 fast  默认值：5
+
+生�视频时长，仅支�整数，��：秒。
+
+�值范围：
+
+* \[4,15] 或设置为-1
+
+> **�置方法**
+>
+> * 指定具体时长：支�有效范围内的任一整数。
+>
+> * 智能指定：设置为 -1，表示由模型在有效范围内自主选择�适的视频长度（整数秒）。实际生�视频的时长�通过 [查询视频生�任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 **duration** 字段获�。注�视频时长与计费相关，请谨慎设置。
+
+
+
+#### **frames** `integer`&#x20;
+
+Seedance 2.0 & 2.0 fast 暂�支�
+
+
+
+#### **camera\_fixed** `boolean`
+
+&#x20;Seedance 2.0 & 2.0 fast 暂�支�
+
+
+
+# Get/List-查询视频生�任务/列表
+
+> [查询视频生�任务](https://www.volcengine.com/docs/82379/1521309?lang=zh)：GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}
+>
+> [查询视频生�任务列表](https://www.volcengine.com/docs/82379/1521675?lang=zh)：GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks?page\_num={page\_num}\&page\_size={page\_size}\&filter.status={filter.status}\&filter.task\_ids={filter.task\_ids}\&filter.model={filter.model}
+
+## �应�数
+
+#### **tools&#x20;**`object[]`&#x20;
+
+> 仅 Seedance 2.0 & 2.0 fast 支�
+
+�置模型�调用的工具。
+
+***
+
+tools.**type&#x20;**`string`
+
+指定使用的工具类型。
+
+* web\_search：�网�索工具。
+
+
+
+#### **usage** `object`
+
+本次请求的 token 用�。
+
+***
+
+usage.**completion\_tokens** `integer`
+
+模型输出视频花费的 token 数�。
+
+***
+
+usage.**total\_tokens** `integer`
+
+本次请求消耗的总 token 数�。
+
+***
+
+usage.**tool\_usage&#x20;**`object`&#x20;
+
+> 仅 Seedance 2.0 & 2.0 fast 支�
+
+使用工具的用�信�。
+
+***
+
+usage.tool\_usage.**web\_search&#x20;**`integer`&#x20;
+
+实际调用�网�索工具的次数，仅开��网�索时返回。
+
+
+
+# 调用简介�示例
+
+## �程简介
+
+任务接�是异步接�，视频生�任务�程
+
+1. 创建视频生�任务接�创建视频生�任务
+
+2. 定时使用查询接�查询视频生�任务状�
+
+   1. 任务 running，过段时间�查询任务状�
+
+   2. 任务完�，返回视频链接，在24�时内下载生�的视频文件
+
+## 1. 创建视频生�任务
+
+> 以下示例仅展示 Seedance 2.0 & 2.0 fast 新增能力，更多视频生�示例详� [创建视频生�任务 API](https://www.volcengine.com/docs/82379/1520757)。
+
+### 多模��考
+
+```bash
+curl https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $ARK_API_KEY" \
+  -d '{
+    "model": "doubao-seedance-2-0-260128",
+    "content": [
+         {
+            "type": "text",
+            "text": "全程使用视频1的第一视角构图，全程使用音频1作为背景音�。第一人称视角果茶宣传广告，seedance牌「苹苹安安�苹果果茶�定款；首帧为图片1，你的手摘下一颗带晨露的阿克�红苹果，轻脆的苹果碰撞声；2-4 秒：快速切镜，你的手将苹果�投入雪克�，加入冰�与茶底，用力摇晃，冰�碰撞声与摇晃声�点轻快鼓点，背景音：「鲜切现摇�；4-6 秒：第一人称��特写，分层果茶倒入�明�，你的手轻挤奶盖在顶部铺展，在�身贴上粉红包标，镜头拉近看奶盖与果茶的分层纹�；6-8 秒：第一人称手�举�，你将图片2中的果茶举到镜头�（模拟递到观众��的视角），�身标签清晰��，背景音「�一�鲜爽�，尾帧定格为图片2。背景声音统一为女生音色。"
+        },
+        {
+            "type": "image_url",
+            "image_url": {
+                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic1.jpg"
+            },
+            "role": "reference_image"
+        },
+        {
+            "type": "image_url",
+            "image_url": {
+                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_tea_pic2.jpg"
+            },
+            "role": "reference_image"
+        },
+        {
+          "type": "video_url",
+          "video_url": {
+              "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_tea_video1.mp4"
+          },
+          "role": "reference_video"
+        },
+        {
+          "type": "audio_url",
+          "audio_url": {
+              "url": "https://ark-project.tos-cn-beijing.volces.com/doc_audio/r2v_tea_audio1.mp3"
+          },
+          "role": "reference_audio"
+        }
+    ],
+    "generate_audio":true,
+    "ratio": "16:9",
+    "duration": 11,
+    "watermark": false
+}'
+```
+
+### 编辑视频
+
+```bash
+curl https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $ARK_API_KEY" \
+  -d '{
+    "model": "doubao-seedance-2-0-260128",
+    "content": [
+        {
+            "type": "text",
+            "text": "将视频1礼盒中的香水替��图片1中的�霜，�镜��"
+        },
+        {
+            "type": "image_url",
+            "image_url": {
+                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_edit_pic1.jpg"
+            },
+            "role": "reference_image"
+        },
+        {
+            "type": "video_url",
+            "video_url": {
+                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_edit_video1.mp4"
+            },
+            "role": "reference_video"
+        }
+    ],
+    "generate_audio": true,
+    "ratio": "16:9",
+    "duration": 5,
+    "watermark": true
+}'
+```
+
+### 延长视频
+
+```bash
+curl https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $ARK_API_KEY" \
+  -d '{
+    "model": "doubao-seedance-2-0-260128",
+    "content": [
+        {
+            "type": "text",
+            "text": "视频1中的拱形窗户打开，进入美术馆室内，接视频2，之�镜头进入画内，接视频3"
+        },
+        {
+            "type": "video_url",
+            "video_url": {
+                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_extend_video1.mp4"
+            },
+            "role": "reference_video"
+        },
+        {
+            "type": "video_url",
+            "video_url": {
+                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_extend_video2.mp4"
+            },
+            "role": "reference_video"
+        },
+        {
+            "type": "video_url",
+            "video_url": {
+                "url": "https://ark-project.tos-cn-beijing.volces.com/doc_video/r2v_extend_video3.mp4"
+            },
+            "role": "reference_video"
+        }
+    ],
+    "generate_audio": true,
+    "ratio": "16:9",
+    "duration": 8,
+    "watermark": true
+}'
+```
+
+### 使用�网�索
+
+仅支�文本生视频
+
+```bash
+curl https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $ARK_API_KEY" \
+  -d '{
+    "model": "doubao-seedance-2-0-260128",
+    "content": [
+         {
+            "type": "text",
+            "text": "微�镜头对准�片上翠绿的玻璃蛙。焦点��从它光滑的皮肤，转移到它完全�明的腹部，一颗鲜红的心�正在有力地�规律地收缩扩张。"
+        }
+    ],
+    "generate_audio":true,
+    "ratio": "16:9",
+    "duration": 11,
+    "watermark": true,
+    "tools": [
+         {
+             "type": "web_search"
+         }
+     ]
+}'
+```
+
+## 2. 查询视频生�任务
+
+```bash
+//请将 cgt-2026****hzc2z 替�为创建视频生�任务时获得的任务ID
+curl -X GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/cgt-2026****hzc2z \
+  -H "Content-Type: application/json" \
+  -H "Authorization: Bearer $ARK_API_KEY"   
+```
+
+
+
+# 最佳实践
+
+## 使用公共虚拟人�生�视频
+
+平��供公共虚拟人�素�库，目�您�以使用其中的图�素��创建一个统一�完备的视频主角。帮助您更好地控制主角，并确�其形象在多段视频中��一致，��因为真人人脸�制导致角色无法统一的问题。
+
+素�模�目�包�图片，并�供人物背景�述。�个素�对应一个独立素� ID (asset ID)，在体验中心的视频生�任务中，指定角色人脸生�视频。
+
+1. 在�览器中打开[体验中心](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128\&tab=GenVideo)，点击输入框下方的 **虚拟人�库** 页签。
+
+2. 检索需�使用的人�，支�使用自然语言检索�筛选框组�筛选。
+
+| 输入：文本                                                                                                                              | 输入：虚拟人��图片                                                                                                                                                              | 输出 |
+| ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
+| **图片1**中美妆�主用中文进行介�，妆容改为明艳大气，去掉脸部�光，笑容甜美，近景镜头，手�**图片2**的�霜��镜头展示，清新简约背景，元气甜美风格。�主��：挖到本命�霜了�质地�云朵一样软糯，一抹就�收，熬夜急救�补水�湿全�定，素颜都自带柔光感。 | ![Image Token: HTf6bPRukoWaW4xnCSlcvKtUn7c](images/HTf6bPRukoWaW4xnCSlcvKtUn7c.png)![Image Token: YfCDbzJlqo4yzZxCmdscWdsInCf](images/YfCDbzJlqo4yzZxCmdscWdsInCf.jpeg) |    |
+
+
+
+在 [Video Generation API](https://www.volcengine.com/docs/82379/1520758) 的 **content.<模�>\_url.url** 字段中使用 素� URI 生�视频。
+
+> 输入的�考内容，包括人�素�，需符�视频生��制，具体信�请查看使用�制。
+>
+> **注�**：
+>
+> * 首次在 API 中使用虚拟人�素� Asset URI �，需先在[方舟体验中心](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128\&tab=GenVideo)�交一次视频生�任务，阅读并��弹出的 **虚拟人�库使用�议**。
+>
+> * 体验中心支�体验视频生�能力。默认�次生� 4 段视频，为节约�本，建议设置为�次生� 1 �，具体方���考[虚拟人�库](https://www.volcengine.com/docs/82379/2223965?lang=zh)。
+
+���议的�作方�如下：
+
+![Image Token: LK8ybUN9Ko2KkQxq2FdclVQtnkh](images/LK8ybUN9Ko2KkQxq2FdclVQtnkh.gif)
+
+示例代�：
+
+> **注�：**
+> 在传入给模型的 Prompt 中，需�使用**图片 1**�**视频 1&#x20;**&#x7684;方�指代�考素�，素���为素�在请求体中的顺�。请勿直接在 Prompt 中直接使用 Asset ID。
+> 例：“**图片1&#x20;**&#x91CC;的女孩身�**图片2**中的�装，正在整�柜�上的物�。**图片3**中的男孩是一�顾客，他走上�，想��女孩索��系方�。�&#x20;
+>
+> 调用示例请�考[常�问题 4](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe#share-YOKvdYHjro8EjtxucWaczf6vneg)
+
+```python
+import os
+import time
+# Install SDK:  pip install 'volcengine-python-sdk[ark]'
+from volcenginesdkarkruntime import Ark 
+client = Ark(
+    # The base URL for model invocation
+    base_url='https://ark.cn-beijing.volces.com/api/v3',
+    # Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
+    api_key=os.environ.get("ARK_API_KEY"),
+)
+if __name__ == "__main__":
+    print("----- create request -----")
+    create_result = client.content_generation.tasks.create(
+        model="doubao-seedance-2-0-260128", # Replace with Model ID 
+        content=[
+            {
+                "type": "text",
+                # 注�：素�图片指代需使用“图片N�（ N 表示传入素�图片/图片的��，如“图片1��“图片2�）
+                "text": "图片1中美妆�主用中文进行介�，妆容改为明艳大气，去掉脸部�光，笑容甜美，近景镜头，手�图片2的�霜��镜头展示，清新简约背景，元气甜美风格。�主��：挖到本命�霜了�质地�云朵一样软糯，一抹就�收，熬夜急救�补水�湿全�定，素颜都自带柔光感。"
+            },        
+            {
+                "type": "image_url",
+                "image_url": {
+                    "url": "asset://asset-20260224200602-qn7wr"
+                },
+                "role": "reference_image"
+            },
+            {
+                "type": "image_url",
+                "image_url": {
+                    "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_edit_pic1.jpg"
+                },
+                "role": "reference_image"
+            },
+        ],
+        generate_audio=True,
+        ratio="16:9",
+        duration=11,
+        watermark=True,
+    )
+    print(create_result)
+    print("----- polling task status -----")
+    task_id = create_result.id
+    while True:
+        get_result = client.content_generation.tasks.get(task_id=task_id)
+        status = get_result.status
+        if status == "succeeded":
+            print("----- task succeeded -----")
+            print(get_result)
+            break
+        elif status == "failed":
+            print("----- task failed -----")
+            print(f"Error: {get_result.error}")
+            break
+        else:
+            print(f"Current status: {status}, Retrying after 30 seconds...")
+            time.sleep(30)
+```
+
+***
+
+## 使用自有虚拟人�素�生�视频
+
+Seedance 2.0 � 2.0 fast 模型具有完备的防范 Deepfake 和侵犯版�风险能力。在生�视频时，会对有风险的�考素�输入进行拦截，最大�度��生�视频�规和安全性。
+
+为确�创作者能充分利用 Seedance 2.0 系列模型强大的视频生�能力高效生�视频内容，�时规� AI 生�内容的潜在风险，方舟推出了�域�信素�库，支�创作者自助上传虚拟人�素�。完�入库的�信素�将进入您的�域素�库，在视频生�中使用。
+
+> 具体信�请�考文档：[ 「⚠��密信���申请��填客户�称】�域虚拟人�素�资产库使用指�（邀测用户版）](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe)。
+
+***
+
+## 使用模型产物进行二创
+
+Seedance 2.0 � 2.0 fast 模型生�的视频为�信素�。您�使用**本账�下**由上述模型生�的视频，进行视频编辑�视频延长等二次创作，素�中的人脸�正常�与生�，�会触�审核拦截。
+
+> 2026年3月11日起，使用 Seedance 2.0 � 2.0 fast 模型生�的视频，支�二次创作。
+
+| 输入：文本                                                                                                                              | 输入：虚拟人��图片                                                                                                                                                              | 第一次输出视频 | 二次编辑�视频 |
+| ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------- | ------- |
+| **图片1**中美妆�主用中文进行介�，妆容改为明艳大气，去掉脸部�光，笑容甜美，近景镜头，手�**图片2**的�霜��镜头展示，清新简约背景，元气甜美风格。�主��：挖到本命�霜了�质地�云朵一样软糯，一抹就�收，熬夜急救�补水�湿全�定，素颜都自带柔光感。 | ![Image Token: MbrRbjSSDoqaaKx3YmCcbVZUnud](images/MbrRbjSSDoqaaKx3YmCcbVZUnud.png)![Image Token: UGfibSj7soIYJMxoYpEcDBIcnkb](images/UGfibSj7soIYJMxoYpEcDBIcnkb.jpeg) |         |         |
+
+1. 首次生视频，并获�视频 URL。
+
+> **注�：**
+> 在传入给模型的 Prompt 中，需�使用**图片 1**�**视频 1&#x20;**&#x7684;方�指代�考素�，素���为素�在请求体中的顺�。
+>
+> 请勿直接在 Prompt 中直接使用 Asset ID。
+> 例：“**图片1&#x20;**&#x91CC;的女孩身�**图片2**中的�装，正在整�柜�上的物�。**图片3**中的男孩是一�顾客，他走上�，想��女孩索��系方�。�
+
+```python
+import os
+import time
+# Install SDK:  pip install 'volcengine-python-sdk[ark]'
+from volcenginesdkarkruntime import Ark 
+client = Ark(
+    # The base URL for model invocation
+    base_url='https://ark.cn-beijing.volces.com/api/v3',
+    # Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
+    api_key=os.environ.get("ARK_API_KEY"),
+)
+if __name__ == "__main__":
+    print("----- create request -----")
+    create_result = client.content_generation.tasks.create(
+        model="doubao-seedance-2-0-260128", # Replace with Model ID 
+        content=[
+            {
+                "type": "text",
+                # 注�：素�图片指代需使用“图片N�（ N 表示传入素�图片/图片的��，如“图片1��“图片2�）
+                "text": "图片1中美妆�主用中文进行介�，妆容改为明艳大气，去掉脸部�光，笑容甜美，近景镜头，手�图片2的�霜��镜头展示，清新简约背景，元气甜美风格。�主��：挖到本命�霜了�质地�云朵一样软糯，一抹就�收，熬夜急救�补水�湿全�定，素颜都自带柔光感。"
+            },        
+            {
+                "type": "image_url",
+                "image_url": {
+                    "url": "asset://asset-20260224200602-qn7wr"
+                },
+                "role": "reference_image"
+            },
+            {
+                "type": "image_url",
+                "image_url": {
+                    "url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/r2v_edit_pic1.jpg"
+                },
+                "role": "reference_image"
+            },
+        ],
+        generate_audio=True,
+        ratio="16:9",
+        duration=11,
+        watermark=True,
+    )
+    print(create_result)
+    print("----- polling task status -----")
+    task_id = create_result.id
+    while True:
+        get_result = client.content_generation.tasks.get(task_id=task_id)
+        status = get_result.status
+        if status == "succeeded":
+            print("----- task succeeded -----")
+            print(get_result)
+            break
+        elif status == "failed":
+            print("----- task failed -----")
+            print(f"Error: {get_result.error}")
+            break
+        else:
+            print(f"Current status: {status}, Retrying after 30 seconds...")
+            time.sleep(30)
+```
+
+* 对首次生�的视频进行�次编辑。为直观展示效果，本示例中直接使用视频原始 URL。
+
+> 视频原始 URL 的有效期仅 24 �时，实际使用时，建议您��转存视频文件（例如上传至�山引擎TOS）。
+
+```python
+import os
+import time
+# Install SDK:  pip install 'volcengine-python-sdk[ark]'
+from volcenginesdkarkruntime import Ark 
+client = Ark(
+    # The base URL for model invocation
+    base_url='https://ark.cn-beijing.volces.com/api/v3',
+    # Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
+    api_key=os.environ.get("ARK_API_KEY"),
+)
+if __name__ == "__main__":
+    print("----- create request -----")
+    create_result = client.content_generation.tasks.create(
+        model="doubao-seedance-2-0-260128", # Replace with Model ID 
+        content=[
+            {
+                "type": "text",
+                "text": "将视频1中的背景修改为室内，房间布置温馨，包括白色的沙�，梳妆�和鲜花。"
+            },                
+            {
+                "type": "video_url",
+                "video_url": {
+                    "url": "https://ark-acg-cn-beijing.tos-cn-beijing.volces.com/doubao-seedance-2-0/02177390693606300000000000000000000ffffc0a88a7fb18e5d.mp4?X-Tos-Algorithm=TOS4-HMAC-SHA256&X-Tos-Credential=AKLTMjQyZTA4MzFjYTY0NGE5YzgzNTIzMTQzYWI5MmVjMDY%2F20260319%2Fcn-beijing%2Ftos%2Frequest&X-Tos-Date=20260319T075900Z&X-Tos-Expires=86400&X-Tos-Signature=204c1d922d7f563ab0fe2bdf28fe3764df52b3404827acf11c9f3dead82aa3db&X-Tos-SignedHeaders=host"
+                },
+                "role": "reference_video"
+            },
+        ],
+        generate_audio=True,
+        ratio="16:9",
+        duration=11,
+        watermark=True,
+    )
+    print(create_result)
+    print("----- polling task status -----")
+    task_id = create_result.id
+    while True:
+        get_result = client.content_generation.tasks.get(task_id=task_id)
+        status = get_result.status
+        if status == "succeeded":
+            print("----- task succeeded -----")
+            print(get_result)
+            break
+        elif status == "failed":
+            print("----- task failed -----")
+            print(f"Error: {get_result.error}")
+            break
+        else:
+            print(f"Current status: {status}, Retrying after 30 seconds...")
+            time.sleep(30)
+```
+
+
+
+## �域素�资产上传最佳案例
+
+> 在上传素�资产时，**若将目标人脸图�全身�考图�细节�考图�并为�一张图片，�能导致��考元素在画�中�比较�，从而增加模型识别难度**，造�生�视频中的人物形象与所上传素�资产出现�差，或造�生�视频中素人脸被误识别为明星脸而触�风控拦截。
+
+建议在上传素�资产时，将人物�部特写��装细节等关键内容独立分割为�独的图片进行上传。具体��考如下规则�示例：
+
+|      | 应该                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | �应该                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                     |
+| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 输入内容 | 给出背景�考图�人物妆造三视图�人物�部无表情特写图��示�![图片1-背景�考图 (Token: Hi55bqOYyoBWvSxMDjNcEuSJn7c)](images/Hi55bqOYyoBWvSxMDjNcEuSJn7c.png)![图片2-人物妆造三视图 (Token: XQE5bI0tJovdxmxf0qMcFCtEnoc)](images/XQE5bI0tJovdxmxf0qMcFCtEnoc.png)![图片3-人物�部特写图 (Token: BpkhbHY0Co0pB0xTgoRcLDOynGc)](images/BpkhbHY0Co0pB0xTgoRcLDOynGc.png)                                                                                                                                                                                           | 给出背景�考图�人物妆造三视图��示�![图片1-背景�考图 (Token: T572bL5IGooP4HxogzGcwERRn5c)](images/T572bL5IGooP4HxogzGcwERRn5c.png)![图片2-人物妆造三视图 (Token: WZIcbGijXoOOZnxQRS9cA4kMndh)](images/WZIcbGijXoOOZnxQRS9cA4kMndh.png)                                                                                               |                                                                                                                                                                                                                                                                                                     |
+| 输出内容 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                     |
+| 总结   | �样是�风打斗剧情：左边输入内容包括：背景�考图�**人物妆造三视图**�**人物�部无表情特写图**��示�；中间输入内容包括：背景�考图�人物妆造三视图��示�；�边输入内容包括：背景�考图�人物妆造正视图��示�。左边的输出视频更加还原人物�部特�；�边的人物�部特�一致性�循�佳。                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                     |
+| 输入内容 | 给出背景�考图�人物妆造三视图�人物�部无表情特写图��示�![图片1-背景�考图 (Token: JLD7bmUBYo7FpaxiAsicLkMQnKe)](images/JLD7bmUBYo7FpaxiAsicLkMQnKe.jpeg)![图片2-人物妆造三视图 (Token: Xj45b0L5uopyMqxTUOLcwn0ZnCc)](images/Xj45b0L5uopyMqxTUOLcwn0ZnCc.jpeg)![图片3-人物�部特写图 (Token: S7JRbu09Jo9OdkxHy7TcWTarnRh)](images/S7JRbu09Jo9OdkxHy7TcWTarnRh.png)![图片4-人物妆造三视图 (Token: KS5hb2DlCoLL6uxHnfdcl9konBe)](images/KS5hb2DlCoLL6uxHnfdcl9konBe.jpeg)![图片5-人物�部特写图 (Token: NtOnbySAHokJ4JxR4sdcu8oRnyh)](images/NtOnbySAHokJ4JxR4sdcu8oRnyh.jpeg) | 给出背景�考图�人物妆造三视图��示�![图片1-背景�考图 (Token: I3ICbosi0oaR1LxcezKcYJWCnic)](images/I3ICbosi0oaR1LxcezKcYJWCnic.jpeg)![图片2-人物妆造三视图 (Token: JtOLbQ1iLoxTPUxXrkLcMcXknB8)](images/JtOLbQ1iLoxTPUxXrkLcMcXknB8.jpeg)![图片3-人物妆造三视图 (Token: RGoubMdjTokEK3xjJ3KcQqPtnuf)](images/RGoubMdjTokEK3xjJ3KcQqPtnuf.jpeg) | 给出背景�考图�人物妆造正视图��示�![图片1-背景�考图 (Token: YCcmbhQVFoUcHcxExHfcSrSQnab)](images/YCcmbhQVFoUcHcxExHfcSrSQnab.jpeg)![图片2-人物妆造正视图 (Token: OoMFbcfBEoiqkCxOQJpcjgcAnzQ)](images/OoMFbcfBEoiqkCxOQJpcjgcAnzQ.png)![图片3-人物妆造正视图 (Token: ZAs6bIUkQooRUBxxe2EcHDQ2nug)](images/ZAs6bIUkQooRUBxxe2EcHDQ2nug.png) |
+| 输出内容 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                     |
+| 总结   | �样是温馨亲�剧情：左边输入内容包括：背景�考图�**人物妆造三视图�人物�部无表情特写图**��示�；中间输入内容包括：背景�考图�人物妆造三视图��示�；�边输入内容包括：背景�考图�人物妆造正�图��示�。左边的输出视频更加还原人物�部特�；中间的输出视频人物�部特�一致性�循�佳；�边人物妆造��部特�一致性�循�佳。                                                                                                                                                                                                                                                                                                                                    |                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                     |
+
+
+
diff --git a/docs/API文档/3-31「�密信���申请��填客户�称】Assets API �考文档（邀测用户版）.md b/docs/API文档/3-31「�密信���申请��填客户�称】Assets API �考文档（邀测用户版）.md
new file mode 100644
index 0000000..ee890ae
--- /dev/null
+++ b/docs/API文档/3-31「�密信���申请��填客户�称】Assets API �考文档（邀测用户版）.md	
@@ -0,0 +1,1005 @@
+# 「⚠��密信���申请��填客户�称】Assets API �考文档（邀测用户版）
+
+| **文档�更说明** | **时间**    |
+| ---------- | --------- |
+|            | 2026.3.26 |
+|            | 2026.3.28 |
+
+本文介�素�资产（Assets）API 接�的�数。您�以使用以下 Assets API 接�创建�管�个人人�素�资产。
+
+> 本文档仅�预览�邀测用户使用：
+>
+> * �承诺正� API 上线100%一致。
+>
+> * 仅�邀测用户阅读，请勿截图/分享给其他人员。
+>
+> * 上传素� （CreateAsset） API 为异步接�，系统处��能出现排队，导致入库时间增加。�承诺上传时间 SLA。
+>
+> * 素�资产应为虚拟人�，�虚拟人�类素�无需入库。
+>
+> * 您需确�上传的虚拟人�符�以下�件：
+>
+>   * 您�法拥有该素�，并享有完整的使用�处分��。素��包�未获授�的第三方商标�标识类内容。
+>
+>   * 素��得与任何自然人肖�或形象雷�，素��存在抄袭�盗用情形，�会侵害任何第三方的人格��知识产�等�法�益。
+>
+>   * 素��包���法规��背公�良俗��害国家安全的内容。
+
+
+
+# 素�资产库结构说明
+
+* **Asset Group（素�资产组�）**：�个素�文件为一个 Asset，�个 Asset 属于一个 Asset Group。
+
+  * �以使用素�组自由管�素�，例如�将�一虚拟人物素�放入�一素�组�进行管�。
+
+* **Asset（素�资产）**：一个素�文件（当�支�上传图��视频�音频），是方舟 Seedance 2.0 系列模型�直接用于推�的�信资产。
+
+> 注�
+>
+> * 仅需入库推�需使用的素�资产，�需使用的素�资产请勿入库。
+>
+> * 仅�使用已入库素�资产的 Id (Asset ID) 进行视频生�，�一形象未入库素�无法使用。
+>
+> * �个上传的素�资产需�过预处�，�轮询调用 **GetAsset** 接�查询素�状�（对应�数为 **Status）**，仅当状��为 `Active` �，该素�资产方�用于�续推�使用；若状�为 `Failed` 则表示处�失败，无法用于�续推�使用。**详情��考：[上传素�资产并获�素�资产信�代�示例](https://bytedance.larkoffice.com/wiki/FtqVwjinYisraGkT5uncWyd0nEb#share-U55kdtSMVowUy9xkpJBcEazonpe)。**
+
+
+
+# 素�资产（Assets）API 接�功能
+
+## **Asset (Group) 创建接�：**
+
+1. CreateAssetGroup：创建素�资产组�。**首次创建素�资产组�时需在控制�签署授�函，详情�考 [ �域虚拟人�素�库 (WIP)](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe)**
+
+2. CreateAsset：创建素�资产。该接��用于上传个人素�资产，创建素�资产��利用返回字段中的素� **Id （需处于 `Active` 状�）**&#x7528;于 Seedance 2.0 系列模型生�视频。
+
+
+
+## **Asset (Group) 管�接�：**
+
+* ListAssetGroups：查询素�资产组�列表。
+
+* ListAssets：查询素�资产列表。
+
+* GetAsset：查询素�资产信�。
+
+* GetAssetGroup：查询素�资产组�信�。
+
+* UpdateAssetGroup：更新素�资产组�信�。
+
+* UpdateAsset：更新素�资产信�。
+
+* DeleteAsset：删除�个素�资产。
+
+
+
+# 鉴�方�
+
+调用素�资产（Assets）API 接�需使用 Access Key 鉴�，详情�考 [获� API 访问密钥（AK/SK）](https://www.volcengine.com/docs/6257/64983?lang=zh)。
+
+
+
+# ���求
+
+* QPS ��： API接��秒查询请求的总数上�。超过此�制的查询请求会报错。
+
+| 接��              | 账�维度的 QPS �� |
+| ---------------- | ------------ |
+| CreateAssetGroup | 30           |
+| CreateAsset      | 1            |
+| ListAssetGroups  | 30           |
+| ListAssets       | 30           |
+| GetAsset         | 100          |
+| GetAssetGroup    | 100          |
+| UpdateAsset      | 30           |
+| UpdateAssetGroup | 30           |
+
+# CreateAssetGroup
+
+> **POST&#x20;**/open/CreateAssetGroup
+
+创建 Asset Group（素�资产组�）组�，用作素�资产管�。
+
+> **首次创建 Asset Group（素�资产组�）需在控制�签署授�函，详情�考 [ �域虚拟人�素�库 (WIP)](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe)**
+
+## 请求�数
+
+### **Name** `string` `å¿…å¡«`
+
+Asset Group（素�资产组�）的�称，上�为 64 字符。
+
+***
+
+### **Description** `string`
+
+Asset Group（素�资产组�）的�述，上�为 300 字符。
+
+***
+
+### **GroupType &#x20;**`string`
+
+Asset Group（素�资产组�）的类型。�选值：
+
+* AIGC：虚拟人�。
+
+> 当�仅支� AIGC 类型。
+
+
+
+***
+
+### **ProjectName&#x20;**`string`**&#x20;**
+
+资�所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id** `string`
+
+Asset Group（素�资产组�）的 Id。
+
+***
+
+返回示例：
+
+
+
+# CreateAsset&#x20;
+
+> **POST&#x20;**/open/CreateAsset
+
+�指定的Asset Group（素�资产组�）内创建Asset（素�资产）。
+
+> 上传素� （CreateAsset） API 为异步接�，系统处��能出现排队，导致入库时间增加。�承诺上传时间 SLA。
+
+## 请求�数
+
+### **GroupId** `string` `å¿…å¡«`
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+### **URL** `string` `å¿…å¡«`
+
+传入的Asset（素�资产）的公共�访问地�。
+
+***
+
+### **Name** `string`&#x20;
+
+Asset（素�资产）的�称，上�为64个字符。
+
+> 该字段仅用于使用 ListAssets 接�时模糊�索素�，�会被带入模型推�。关于如何使用素�生�视频，请�考[使用人�素�生�视频](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe#share-QF2qdZE5HoRkRDxfs9bcmqECnDb)和[常�问题 4](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe#share-YOKvdYHjro8EjtxucWaczf6vneg)。
+
+***
+
+### **AssetType `string` `å¿…å¡«`**
+
+Asset（素�资产）的类型，支�传入图��音频�视频。�选值：
+
+* Image：Asset（素�资产）的类型为图�。
+
+* Video：Asset（素�资产）的类型为视频。
+
+* Audio：Asset（素�资产）的类型为音频。
+
+> **传入图��音频�视频素�时，仅支�上传 URL ，�支� base64。**
+>
+> **传入�个图��求**
+>
+> * 格�：jpeg�png�webp�bmp�tiff�gif�heic/heif
+>
+> * 宽高比（宽/高）： (0.4, 2.5)&#x20;
+>
+> * 宽高长度（px）：(300, 6000)
+>
+> * 大�：�张图片�于 30 MB
+>
+> **传入�个视频�求**
+>
+> * 格�：mp4�mov
+>
+> * 分辨率：480p�720p
+>
+> * 时长：�个视频时长 \[2, 15] s
+>
+> * 尺寸：
+>
+>   * 宽高比（宽/高）：\[0.4, 2.5]
+>
+>   * 宽高长度（px）：\[300, 6000]
+>
+>   * 总�素数：\[640×640=409600, 834×1112=927408]，�宽和高的乘积符� \[409600, 927408] 的区间�求。
+>
+> * 大�：�个视频�超过 50 MB
+>
+> * 帧率 (FPS)：\[24, 60]&#x20;
+>
+> **传入�个音频�求**
+>
+> * 格�：wav�mp3
+>
+> * 时长：�个音频时长 \[2, 15] s
+>
+> * 大�：�个音频�超过 15 MB
+
+***
+
+### **ProjectName** `string`&#x20;
+
+资�所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+> 需�和待传入的 Asset Group（素�资产组�）的 **ProjectName&#x20;**&#x4FDD;�一致。
+
+***
+
+
+
+## 返回�数
+
+### **Id&#x20;**`string`&#x20;
+
+Asset（素�资产）的 Id。
+
+***
+
+返回示例：
+
+
+
+# ListAssets
+
+> **POST&#x20;**/open/ListAssets
+
+查询符�筛选�件的 Assets（素�资产）列表。
+
+## 请求�数
+
+### **Filter** `object` `å¿…å¡«`
+
+�索的过滤�件。
+
+***
+
+Filter.**GroupIds** `array`
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+Filter.**GroupType** `string` `å¿…å¡«`
+
+Asset Group（素�资产组�）的类型。�选值：
+
+* AIGC：虚拟人�。
+
+***
+
+Filter.**Statuses** `array`**&#x20;**
+
+任务状�。
+
+* Active：素�资产（Asset）已处�完毕，�以使用。
+
+* Processing：素�资产（Asset）正在预处�，无法使用。
+
+* Failed：素�资产（Asset）处�失败。
+
+***
+
+Filter.**Name** `string`**&#x20;**
+
+Asset（素�资产）的�称，上�为64个字符。
+
+***
+
+### **PageNumber** `int (i64)` `å¿…å¡«`
+
+�索页�，�用于列表分页功能，从 1 开始。例如："page\_number": 1，�返回第一页的�索结果。
+
+***
+
+### **PageSize** `int (i64)` `å¿…å¡«`
+
+�页�索结果的数�，上�为100。
+
+***
+
+### **SortBy** `string`
+
+用于排�的字段�称，默认值 `createTime`。支�以下类型：
+
+* CreateTime：根�创建时间排�。
+
+* UpdateTime：根�更新时间排�。
+
+* GroupId：根�资产素�组的 Id 排�。
+
+***
+
+### **SortOrder** `string`
+
+排�顺�，默认值 `Desc`。�选值：
+
+* Desc：��
+
+* Asc：��
+
+***
+
+### **ProjectName** `string`
+
+资�所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Items** `array[]`&#x20;
+
+符�筛选�件的Asset（素�资产）数组。
+
+***
+
+Items.**Id** `string`
+
+Asset（素�资产）的 Id。
+
+***
+
+Items.**name** `string`
+
+Asset（素�资产）的�称，上�为64个字符。
+
+***
+
+Items.**URL** `string`
+
+Asset（素�资产）的公共�访问地�。有效期为12�时，请�时�存。
+
+***
+
+Items.**GroupId** `string`&#x20;
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+Items.**AssetType** `string`
+
+Asset（素�资产）的类型，支�传入图��音频�视频。支�类型：
+
+* Image：Asset（素�资产）的类型为图�。
+
+* Video：Asset（素�资产）的类型为视频。
+
+* Audio：Asset（素�资产）的类型为音频。
+
+***
+
+Items.**Status** `string`
+
+任务状�。
+
+* Active：素�资产（Asset）已处�完毕，�以使用。
+
+* Processing：素�资产（Asset）正在预处�，无法使用。
+
+* Failed：素�资产（Asset）处�失败。
+
+***
+
+Items.**Error** `object`
+
+错误信�。
+
+***
+
+Items.Error.**Code** `string`
+
+错误�。
+
+***
+
+Items.Error.**Message** `string`
+
+错误信�。
+
+***
+
+Items.**ProjectName** `string`
+
+资�所属的项目�称。
+
+***
+
+Items.**CreateTime&#x20;**`string`
+
+创建时间。
+
+***
+
+Items.**UpdateTime&#x20;**`string`
+
+更新时间。
+
+***
+
+### **TotalCount&#x20;**`int (i64)`
+
+返回总数。
+
+***
+
+### **PageNumber&#x20;**`int (i64)`
+
+返回的页数。
+
+***
+
+### **PageSize&#x20;**`int (i64)`
+
+�页�索结果的数�，上�为100。
+
+
+
+# ListAssetGroups
+
+> **POST&#x20;**/open/ListAssetGroups
+
+查询符�筛选�件的Asset Groups（素�资产组�）列表。
+
+## 请求�数
+
+### **Filter** `object` `å¿…å¡«`
+
+�索的过滤�件。
+
+***
+
+Filter.**name** `string`
+
+Asset Group（素�资产组�）的�称，上�为64个字符。
+
+***
+
+Filter.**GroupIds** `array`
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+Filter.**GroupType** `string`**&#x20;**`å¿…å¡«`
+
+Asset Group（素�资产组�）的类型。�选值：
+
+* AIGC：虚拟人�。
+
+***
+
+### **PageNumber** `int (i64)`
+
+�索页�，�用于列表分页功能，从 1 开始。例如："page\_number": 1，�返回第一页的�索结果。
+
+***
+
+### **PageSize** `int (i64)`
+
+�页�索结果的数�，上�为100。
+
+***
+
+### **SortBy** `string`
+
+用于排�的字段�称，默认值 `createTime`。支�以下类型：
+
+* CreateTime：根�创建时间排�。
+
+* UpdateTime：根�更新时间排�。
+
+***
+
+### **SortOrder** `string`
+
+排�顺�，默认值 `Desc`。�选值：
+
+* Desc：��
+
+* Asc：��
+
+***
+
+### **ProjectName** `string`
+
+资�所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **TotalCount&#x20;**`int (i64)`
+
+返回的 Asset Group（素�资产组�）的总数。
+
+***
+
+### **Items** `array[]`&#x20;
+
+符�筛选�件的 Asset Group（素�资产组�）数组。
+
+***
+
+Items.**Id** `string`
+
+Asset Group（素�资产组�）的 Id。
+
+***
+
+Items.**Name** `string`
+
+Asset Group（素�资产组�）的�称，上�为64个字符。
+
+***
+
+Items.**Title** `string`
+
+Asset Group（素�资产组�）的标题。
+
+> 已废弃，请直接使用�数 Name
+
+***
+
+Items.**Description** `string`
+
+Asset Group（素�资产组�）的�述，上�为 300 字符。
+
+***
+
+Items.**GroupType** `string`
+
+Asset Group（素�资产组�）的类型。
+
+* AIGC：虚拟人�。
+
+***
+
+Items.**ProjectName** `string`
+
+资�所属的项目�称。
+
+***
+
+Items.**CreateTime** `string`
+
+创建时间。
+
+***
+
+Items.**UpdateTime** `string`
+
+更新时间。
+
+***
+
+### **PageNumber&#x20;**`int (i64)`
+
+返回的页数。
+
+***
+
+### **PageSize&#x20;**`int (i64)`
+
+�页�索结果的数�，上�为100。
+
+***
+
+
+
+# GetAssetGroup
+
+> **POST&#x20;**/open/GetAssetGroup
+
+获��个Asset Group（素�资产组�）信�。
+
+## 请求�数
+
+
+
+### **Id&#x20;**`string` `å¿…å¡«`
+
+Asset Group（素�资产组�）的 Id
+
+***
+
+### **ProjectName&#x20;**`string`
+
+需�查询的 Asset Group（素�资产组�）所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id** `string`
+
+Asset Group（素�资产组�）的 Id。
+
+***
+
+### **Name** `string`
+
+Asset Group（素�资产组�）的�称，上�为64个字符。
+
+***
+
+### **Title** `string`&#x20;
+
+Asset Group（素�资产组�）的标题。
+
+> 已废弃，请直接使用�数 Name
+
+***
+
+### **Description** `string`
+
+Asset Group（素�资产组�）的�述，上�为 300 字符。
+
+***
+
+### **GroupType &#x20;**`string`
+
+Asset Group（素�资产组�）的类型。
+
+* AIGC：虚拟人�
+
+***
+
+### **ProjectName&#x20;**`string`**&#x20;**
+
+资�所属的项目�称。
+
+***
+
+### **CreateTime&#x20;**`string`
+
+创建时间。
+
+***
+
+### **UpdateTime&#x20;**`string`
+
+更新时间。
+
+***
+
+##
+
+# GetAsset
+
+> **POST&#x20;**/open/GetAsset
+
+获��个Asset（素�资产）信�。
+
+## 请求�数
+
+
+
+### **Id&#x20;**`string`  `å¿…å¡«`&#x20;
+
+Asset（素�资产）的 Id。
+
+***
+
+### **ProjectName&#x20;**`string`
+
+需�查询的 Asset（素�资产）所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id&#x20;**`string`
+
+Asset（素�资产）的 Id。
+
+***
+
+### **Name** `string`
+
+Asset（素�资产）的�称，上�为64个字符。
+
+***
+
+### **URL &#x20;**`string`
+
+Asset（素�资产）的访问地�。有效期为12�时，请�时�存。
+
+***
+
+### **AssetType&#x20;**`string`
+
+Asset（素�资产）的类型，支�传入图��音频�视频。支�类型：
+
+* Image：Asset（素�资产）的类型为图�。
+
+* Video：Asset（素�资产）的类型为视频。
+
+* Audio：Asset（素�资产）的类型为音频。
+
+***
+
+### **GroupId** `string`
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+### **Status** `string`
+
+任务状�。
+
+* Active：素�资产（Asset）已处�完毕，�以使用。
+
+* Processing：素�资产（Asset）正在预处�，无法使用。
+
+* Failed：素�资产（Asset）处�失败。
+
+***
+
+### **Error** `object`
+
+错误信�。
+
+***
+
+Error.**Code** `string`
+
+错误�。
+
+***
+
+Error.**Message** `string`
+
+错误信�。
+
+***
+
+### **CreateTime&#x20;**`string`
+
+创建时间。
+
+***
+
+### **UpdateTime&#x20;**&#x20;`string`
+
+更新时间。
+
+***
+
+### **ProjectName** `string`&#x20;
+
+资�所属的项目�称。
+
+***
+
+##
+
+# **UpdateAssetGroup**
+
+> **POST&#x20;**/open/UpdateAssetGroup
+
+更新�个 Asset Group（素�资产组�）信�。当�仅支�更新 Asset Group（素�资产组�）的 Name 和 Description。
+
+## 请求�数
+
+### **Id&#x20;**`string` `å¿…å¡«`
+
+需�更新的 Asset Group（素�资产组�）的 Id。
+
+***
+
+### **Name&#x20;**`string`&#x20;
+
+需�更新的 Asset Group（素�资产组�）的新�称，上�为64个字符。
+
+***
+
+### **Description** `string`
+
+需�更新的 Asset Group（素�资产组�）的新�述，上�为 300 字符。
+
+***
+
+### **ProjectName** `string`&#x20;
+
+需�更新的 Asset Group（素�资产组�）所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id** `string`
+
+Asset Group（素�资产组�）的 Id。
+
+***
+
+
+
+
+
+# **UpdateAsset**
+
+> **POST&#x20;**/open/UpdateAsset
+
+更新�个Asset（素�资产）信�。当�仅支�更新Asset（素�资产）的 Name。
+
+## 请求�数
+
+### **Id&#x20;**`string` `å¿…å¡«`
+
+需�更新的 Asset（素�资产）的 Id。
+
+***
+
+### **Name&#x20;**`string`&#x20;
+
+需�更新的 Asset（素�资产）的新�称，上�为64个字符。
+
+***
+
+### **ProjectName** `string`
+
+需�更新的 Asset（素�资产）所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id** `string`
+
+Asset（素�资产）的 Id。
+
+***
+
+
+
+# **DeleteAsset**
+
+> **POST&#x20;**/open/DeleteAsset
+
+删除�个 Asset（素�资产）。
+
+## 请求�数
+
+### **Id&#x20;**`string` `å¿…å¡«`
+
+需�删除的 Asset（素�资产）的 Id。
+
+***
+
+### **ProjectName** `string`
+
+需�删除的 Asset（素�资产）所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+本接�无返回�数。
+
+***
+
+
+
+# 代�示例：
+
+> **以下示例为使用 Asset API 创建素�资产并用于视频生�的使用链路：**
+>
+> 1. **创建素�资产组�：**&#x8C03;用 **CreateAssetGroup** 接�创建一个素�资产组�（Asset Group），用于对�一项目或人物的素�进行统一管�。首次创建时需在控制�签署授�函。
+>
+> 2. **上传素�资产并等待预处�完�：**&#x8C03;用 **CreateAsset** 接�上传图片/视频/音频素�，传入素�的公共访问URL�所属的Group ID，获得素�资产ID（Asset ID）。
+>    由于上传的素�资产需�过预处���能使用，�轮询调用 **GetAsset** 接�查询素�状�，直至状��为 `Active`。若状�为 `Failed` 则表示处�失败，无法用于�续推�使用。
+>
+> 3. **在视频生� API 中使用素�：**&#x5F53;素�资产状�为 `Active` �，将素�ID按 `asset://<asset_ID`**`>`** 的格�拼接�URL，在视频生�API（如Seedance 2.0系列模型）的请求中，将该URL作为�考图片/视频/音频的 `image_url` 传入，��使用该素�资产生�视频。
+>
+> **API 鉴�方�区别说明**
+>
+> * **Asset API：**&#x41;ccess Key 鉴�，详情�考 [获� API 访问密钥（AK/SK）](https://www.volcengine.com/docs/6257/64983?lang=zh)。
+>
+> * **视频生� API：**&#x41;PI Key 鉴�，详情�考  [管� API Key](https://www.volcengine.com/docs/82379/1361424?lang=zh)。
+>
+> **素�库[项目](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)（Project）隔离说明**
+>
+> * �指定的 Asset Group（素�资产组�）内创建或查询 Asset（素�资产）时，需��两者的 **ProjectName&#x20;**&#x4E00;致
+>
+> * Asset（素�资产）所属的 **ProjectName** 需与调用视频生� API 接�时使用的 API key 所属的 **ProjectName** 一致
+
+## 1. 创建素�资产组�
+
+返回示例
+
+
+
+## 2. 上传素�资产并获�素�资产信�
+
+返回示例
+
+
+
+更多语言的示例代�详�：
+
+> 注�替� Demo 中的 AK与SK，若需调用其他接�如 ListAssets，需替� ACTION 与对应请求�数。
+
+| **Python** | 创建素�资产组�： 上传素�资产并获�素�资产信�：  |
+| ---------- | --------------------------- |
+| **Java**   | 创建素�资产组�： 上传素�资产并获�素�资产信�：  |
+| **PHP**    | 创建素�资产组�： 上传素�资产：           |
+
+
+
+## 3. 素�资产用于视频生�
+
+> **注�：**
+> 在传入给模型的 Prompt 中，需�使用**图片 1**�**视频 1&#x20;**&#x7684;方�指代�考素�，素���为素�在请求体中的顺�。请勿直接在 Prompt 中直接使用 Asset ID。
+> 例：“**图片1&#x20;**&#x91CC;的女孩身�**图片2**中的�装，正在整�柜�上的物�。**图片3**中的男孩是一�顾客，他走上�，想��女孩索��系方�。�&#x20;
+>
+> 调用示例请�考[常�问题 4](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe#share-YOKvdYHjro8EjtxucWaczf6vneg)
+
+当上传的素�资产状�为 `Active` 时，�将素� Id 按 `asset: //<asset_Id>` 的规则拼接 URL，以在 **视频生� API&#x20;**&#x4E2D;使用对应的素�资产生�视频：
+
+使用素�资产生�视频的具体调用方�请�考[ �申请��填客户�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）](https://bytedance.larkoffice.com/wiki/SANpwJ9bgiKgrykLaMTcAB0InWc#share-ONSwd51ezoXCJqxkAm2cIC61nMX)。
+
+
+
+# 最佳实践--�域素�资产上传最佳案例
+
+> 在上传素�资产时，**若将目标人脸图�全身�考图�细节�考图�并为�一张图片，�能导致��考元素在画�中�比较�，从而增加模型识别难度**，造�生�视频中的人物形象与所上传素�资产出现�差，或造�生�视频中素人脸被误识别为明星脸而触�风控拦截。
+
+建议在上传素�资产时，将人物�部特写��装细节等关键内容独立分割为�独的图片进行上传。具体��考如下规则�示例：
+
+|      | 应该                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | �应该                                                                                                                                                                                                                                                                                                   |                                                                                                                                                                                                                                                                                                     |
+| ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| 输入内容 | 给出背景�考图�人物妆造三视图�人物�部无表情特写图��示�![图片1-背景�考图 (Token: BfvQbdPCDoJgGVx8x3zcMLoanHc)](images/BfvQbdPCDoJgGVx8x3zcMLoanHc.png)![图片2-人物妆造三视图 (Token: G0WaboKgVo3xo7xXxEGc8El6nLe)](images/G0WaboKgVo3xo7xXxEGc8El6nLe.png)![图片3-人物�部特写图 (Token: KIxBbnH6jonG19xgsqrcYkFEn7e)](images/KIxBbnH6jonG19xgsqrcYkFEn7e.png)                                                                                                                                                                                           | 给出背景�考图�人物妆造三视图��示�![图片1-背景�考图 (Token: OnwKbbnpnojwcBxl1rucLDyQnJh)](images/OnwKbbnpnojwcBxl1rucLDyQnJh.png)![图片2-人物妆造三视图 (Token: ASc6b1QjJoi5owx1A9AccO0BnRd)](images/ASc6b1QjJoi5owx1A9AccO0BnRd.png)                                                                                               |                                                                                                                                                                                                                                                                                                     |
+| 输出内容 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                     |
+| 总结   | �样是�风打斗剧情：左边输入内容包括：背景�考图�**人物妆造三视图**�**人物�部无表情特写图**��示�；中间输入内容包括：背景�考图�人物妆造三视图��示�；�边输入内容包括：背景�考图�人物妆造正视图��示�。左边的输出视频更加还原人物�部特�；�边的人物�部特�一致性�循�佳。                                                                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                     |
+| 输入内容 | 给出背景�考图�人物妆造三视图�人物�部无表情特写图��示�![图片1-背景�考图 (Token: Y1ClbEmXPoKnp3xCV4MckLCWnQb)](images/Y1ClbEmXPoKnp3xCV4MckLCWnQb.jpeg)![图片2-人物妆造三视图 (Token: JYWCbGeXpo0QcgxFqQBcviGzn7b)](images/JYWCbGeXpo0QcgxFqQBcviGzn7b.jpeg)![图片3-人物�部特写图 (Token: Txwmbps9yoFd4ux6gOPcZoLEnkd)](images/Txwmbps9yoFd4ux6gOPcZoLEnkd.png)![图片4-人物妆造三视图 (Token: QDfrbDZLDo07MixPmPYcwGHLnjg)](images/QDfrbDZLDo07MixPmPYcwGHLnjg.jpeg)![图片5-人物�部特写图 (Token: Jj0XbeEGxoxNXUx8X2Lcy7BFnab)](images/Jj0XbeEGxoxNXUx8X2Lcy7BFnab.jpeg) | 给出背景�考图�人物妆造三视图��示�![图片1-背景�考图 (Token: IJLmbyIAHoNI7KxFYb7cfkrBn0f)](images/IJLmbyIAHoNI7KxFYb7cfkrBn0f.jpeg)![图片2-人物妆造三视图 (Token: Zq9xbc7pyo1K8gxKbocclO9ZnPb)](images/Zq9xbc7pyo1K8gxKbocclO9ZnPb.jpeg)![图片3-人物妆造三视图 (Token: G8l5b5qXKoqyB0xfQNDcVOMRn9b)](images/G8l5b5qXKoqyB0xfQNDcVOMRn9b.jpeg) | 给出背景�考图�人物妆造正视图��示�![图片1-背景�考图 (Token: CcIPbldwjoacLuxErVUcJA5CnPe)](images/CcIPbldwjoacLuxErVUcJA5CnPe.jpeg)![图片2-人物妆造正视图 (Token: BPutbuFU7oeJkfxE3KkcuOQUnAh)](images/BPutbuFU7oeJkfxE3KkcuOQUnAh.png)![图片3-人物妆造正视图 (Token: PUR8bJ0g5o6VsAxWhqpcnS9vn4l)](images/PUR8bJ0g5o6VsAxWhqpcnS9vn4l.png) |
+| 输出内容 |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                     |
+| 总结   | �样是温馨亲�剧情：左边输入内容包括：背景�考图�**人物妆造三视图�人物�部无表情特写图**��示�；中间输入内容包括：背景�考图�人物妆造三视图��示�；�边输入内容包括：背景�考图�人物妆造正�图��示�。左边的输出视频更加还原人物�部特�；中间的输出视频人物�部特�一致性�循�佳；�边人物妆造��部特�一致性�循�佳。                                                                                                                                                                                                                                                                                                                                    |                                                                                                                                                                                                                                                                                                       |                                                                                                                                                                                                                                                                                                     |
+
diff --git a/docs/API文档/old-Seedance 2.0 & 2.0 fast API文档（邀测用户版）.md b/docs/API文档/old-Seedance 2.0 & 2.0 fast API文档（邀测用户版）.md
new file mode 100644
index 0000000..969cf38
--- /dev/null
+++ b/docs/API文档/old-Seedance 2.0 & 2.0 fast API文档（邀测用户版）.md	
@@ -0,0 +1,692 @@
+# �申请��填客户�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）
+
+该文档目�仅�开白客户使用，���请和销管确认客户是�在开白��内
+
+***�������】该文档�制客户申请��，�有返回了�务�议的客户方�申请***
+
+本文介� Seedance 2.0 & 2.0 fast 模型相较于存�模型 **新增/�置有区别&#x20;**&#x7684; API �数介�，存� API �数的完整介��� [视频生� API](https://www.volcengine.com/docs/82379/1520758?lang=zh)。
+
+> 本文档仅�预览�邀测用户使用：
+>
+> * �承诺正�API上线100%一致。
+>
+> * 仅�邀测用户阅读，请勿截图/分享给其他人员。
+>
+> * 您上传的内容请确�由您原创或已�得授�。
+
+# 模型能力
+
+> **Seedance 2.0 和 Seedance 2.0 fast �供的模型能力一致，**&#x8FFD;求最高生��质，推�使用 **Seedance 2.0**；更注��本与生�速度，��求���质，推�使用 **Seedance 2.0 fast**。
+
+**Seedance 2.0 & 2.0 fast (有声视频/无声视频)**
+
+* **多模��考生视频**：输入�考图片（0\~9）+�考视频（0\~3）+ �考音频（0\~3）+ 文本�示�（�选）生� 1 个目标视频。支�生�全新视频�编辑视频�延长视频。
+
+> **注�：���独输入音频，应至少包� 1 个�考视频或图片。**
+
+* **图生视频-首尾帧**：输入首帧图片+尾帧图片+文本�示�（�选）生� 1 个目标视频。
+
+* **图生视频-首帧**：输入首帧图片+文本�示�（�选）生� 1 个目标视频。
+
+* **文生视频**：输入文本�示�生� 1 个目标视频。
+
+
+
+**模型能力对比表：**
+
+| 模型�称         |          | [Seedance 2.0](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-2-0)  | [Seedance 2.0 fast](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-2-0-fast\&projectName=default) | [Seedance 1.5 pro](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-5-pro\&projectName=default)   | [Seedance 1.0 pro ](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-0-pro\&projectName=default) | [Seedance 1.0 pro fast ](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-0-pro-fast\&projectName=default) | [Seedance 1.0 lite i2v](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-0-lite-i2v\&projectName=default)   | [Seedance-1.0 lite t2v ](https://console.volcengine.com/ark/region:ark+cn-beijing/model/detail?Id=doubao-seedance-1-0-lite-t2v) |
+| ------------ | -------- | ------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| Model ID     |          | doubao-seedance-2-0-260128                                                                                    | doubao-seedance-2-0-fast-260128                                                                                                             | doubao-seedance-1-5-pro-251215                                                                                                              | doubao-seedance-1-0-pro-250528                                                                                                             | doubao-seedance-1-0-pro-fast-251015                                                                                                                  | doubao-seedance-1-0-lite-i2v-250428                                                                                                                   | doubao-seedance-1-0-lite-t2v-250428                                                                                             |
+| 文生视频         |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | ✅                                                                                                                                                    | ✅                                                                                                                                                     | ✅                                                                                                                               |
+| 图生视频-首帧      |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | ✅                                                                                                                                                    | ✅                                                                                                                                                     | �                                                                                                                               |
+| 图生视频-首尾帧     |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | �                                                                                                                                                    | ✅                                                                                                                                                     | �                                                                                                                               |
+| 多模��考�New】   | 图片�考     | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | ✅                                                                                                                                                     | �                                                                                                                               |
+|              | 视频�考     | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+|              | 组��考     | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 编辑视频�New】    |          | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 延长视频�New】    |          | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 生�有声视频       |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| �网�索增强�New】  |          | ✅                                                                                                             |                                                                                                                                             | �                                                                                                                                           | [�](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/f359753773c94d97885008ca1223c9bc)                                              | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 样片模�         |          | �                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | �                                                                                                                                          | �                                                                                                                                                    | �                                                                                                                                                     | �                                                                                                                               |
+| 返回视频尾帧       |          | ✅                                                                                                             |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | ✅                                                                                                                                                    | ✅                                                                                                                                                     | ✅                                                                                                                               |
+| 输出视频规格       | 输出分辨率    | 480p, 720p                                                                                                    |                                                                                                                                             | 480p, 720p, 1080p                                                                                                                           | 480p, 720p, 1080p                                                                                                                          | 480p, 720p, 1080p                                                                                                                                    | 480p, 720p, 1080p                                                                                                                                     | 480p, 720p, 1080p                                                                                                               |
+|              | 输出宽高比    | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16                                                                               |                                                                                                                                             |                                                                                                                                             |                                                                                                                                            |                                                                                                                                                      |                                                                                                                                                       |                                                                                                                                 |
+|              | 输出时长     | 4\~15 秒                                                                                                       |                                                                                                                                             |  4\~12 秒                                                                                                                                    |  2\~12 秒                                                                                                                                   |  2\~12 秒                                                                                                                                             |  2\~12 秒                                                                                                                                              |  2\~12 秒                                                                                                                        |
+|              | 输出视频格�   | mp4                                                                                                           |                                                                                                                                             | mp4                                                                                                                                         | mp4                                                                                                                                        | mp4                                                                                                                                                  | mp4                                                                                                                                                   | mp4                                                                                                                             |
+| 离线推�         |          | [�](https://p9-arcosite.byteimg.com/obj/tos-cn-i-goo7wpa0wc/f359753773c94d97885008ca1223c9bc)                 |                                                                                                                                             | ✅                                                                                                                                           | ✅                                                                                                                                          | ✅                                                                                                                                                    | ✅                                                                                                                                                     | ✅                                                                                                                               |
+| 在线推���       | RPM      | 600                                                                                                           |                                                                                                                                             | 600                                                                                                                                         | 600                                                                                                                                        | 600                                                                                                                                                  | 300                                                                                                                                                   | 300                                                                                                                             |
+|              | 并�数      | 10                                                                                                            |                                                                                                                                             | 10                                                                                                                                          | 10                                                                                                                                         | 10                                                                                                                                                   | 5                                                                                                                                                     | 5                                                                                                                               |
+| 离线推���       | TPD      | -                                                                                                             |                                                                                                                                             | 5000亿                                                                                                                                       | 5000亿                                                                                                                                      | 5000亿                                                                                                                                                | 2500亿                                                                                                                                                 | 2500亿                                                                                                                           |
+
+
+
+
+
+# Creat-创建视频生�任务
+
+> POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks
+
+## 请求�数
+
+
+
+#### **content** `object[]` `必选`
+
+输入给模型，生�视频的信�，支�文本�图片�音频�视频�样片任务 ID。支�以下几�组�：
+
+* **文本**
+
+* **文本（�选）+ 图片**
+
+* **文本（�选）+ 视频**
+
+* **文本（�选）+ 图片 + 音频**
+
+* **文本（�选）+ 图片 + 视频**
+
+* **文本（�选）+ 视频 + 音频**
+
+* **文本（�选）+ 图片 + 视频 + 音频**
+
+***
+
+**信�类型：**
+
+* **文本信�**`object`
+
+输入给模型的�示�信�。
+
+***
+
+content.**type&#x20;**`string`  `必选`
+
+输入内容的类型，此处应为 **text**。
+
+***
+
+content.**text&#x20;**`string`  `必选`
+
+输入给模型的文本�示�，�述期望生�的视频。
+
+支�中英文。建议中文�超过500字，英文�超过1000�。字数过多信�容易分散，模型�能因此忽略细节，�关注�点，造�视频缺失部分元素。�示�的更多使用技巧请�� [Seedance �示�指�](https://www.volcengine.com/docs/82379/1587797)。
+
+
+
+
+
+* **图片信�** `object`
+
+输入给模型的图片信�。
+
+***
+
+content.**type&#x20;**`string` `必选`
+
+输入内容的类型，此处应为 **image\_url**。
+
+***
+
+content.**image\_url&#x20;**`object`  `必选`
+
+输入给模型的图片对象。
+
+***
+
+content.image\_url.**url&#x20;**`string`  `必选`
+
+图片 URL �图片 Base64 编��素� ID。
+
+* 图片 URL：填入图片的公网 URL。
+
+* Base64 编�：将本地文件转�为 Base64 编�字符串，然��交给大模型。�循格�：data:image/<图片格�>;base64,\<Base64编�>，注� <图片格�> 需�写，如 data:image/png;base64,{base64\_image}。
+
+* 素� ID：用于视频生�的预置素��虚拟人�的 ID，�循格�：asset://\<ASSET\_ID>，�从 [素�&虚拟人�库](https://console.volcengine.com/ark-stg/region:ark-stg+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128) 获�，详细使用请��[文档](https://www.volcengine.com/docs/82379/2223965?lang=zh)。
+
+> **传入�张图片�求**
+>
+> * 格�：jpeg�png�webp�bmp�tiff�gif
+>
+> * 宽高比（宽/高）： (0.4, 2.5)&#x20;
+>
+> * 宽高长度（px）：(300, 6000)
+>
+> * 大�：�张图片�于 30 MB。请求体大��超过 64 MB。大文件请勿使用Base64编�。
+>
+> * 图片数�：
+>
+>   * 图生视频-首帧：1 张
+>
+>   * 图生视频-首尾帧：2 张
+>
+>   * Seedance 2.0 & 2.0 fast 多模��考生视频：1\~9 张
+
+***
+
+content.**role&#x20;**`string` `�件必填`
+
+图片的�置或用途。
+
+> **注�**
+>
+> * **图生视频-首帧**�**图生视频-首尾帧**�**多模��考生视频**（包括�考图�视频�音频）为 3 �互斥场景，**��混用**。
+>
+> * **多模��考生视频**�通过�示�指定�考图片作为首帧/尾帧，间接实现“首尾帧+多模��考�效果。若需严格�障首尾帧和指定图片一致，**优先使用图生视频-首尾帧**（�置 role 为 **first\_frame / last\_frame**）。
+
+***
+
+**图生视频-首帧**
+
+> 需�传入1个 image\_url 对象
+
+* **字段role�值：**
+
+  * **first\_frame 或�填**
+
+***
+
+**图生视频-首尾帧**
+
+> 需�传入2个 image\_url 对象
+
+* **字段role�值：**
+
+  * 首帧图片对应的字段 role 为：**first\_frame**，必填
+
+  * 尾帧图片对应的字段 role 为：**last\_frame**，必填
+
+***
+
+**图生视频-�考图&#x20;**
+
+> �传入 1\~9 个 image\_url 对象
+
+* **字段role�值**：
+
+  * �张�考图对应的字段 role �为：**reference\_image**，必填
+
+
+
+
+
+* **视频信�** `object`&#x20;
+
+输入给模型的视频信�。仅 Seedance 2.0 & 2.0 fast 支�输入视频。
+
+***
+
+content.**type&#x20;**`string`  `必选`
+
+输入内容的类型，此处应为 **video\_url**。
+
+***
+
+content.**video\_url&#x20;**`object`  `必选`
+
+输入给模型的视频对象。
+
+***
+
+content.video\_url.**url&#x20;**`string`  `必选`
+
+视频URL�素� ID。
+
+* 视频 URL：填入视频的公网 URL。
+
+* 素� ID：用于视频生�的预置素��虚拟人�视频的 ID，�循格�：asset://\<ASSET\_ID>。�从[素�&虚拟人�库](https://console.volcengine.com/ark-stg/region:ark-stg+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128)获�。
+
+> **传入�个视频�求**
+>
+> * 视频格�：mp4�mov。
+>
+> * 分辨率：480p�720p
+>
+> * 时长：�个视频时长 \[2, 15] s，最多传入 3 个�考视频，所有视频总时长�超过 15s。
+>
+> * 尺寸：
+>
+>   * 宽高比（宽/高）：\[0.4, 2.5]
+>
+>   * 宽高长度（px）：\[300, 6000]
+>
+>   * 画��素（宽 × 高）：\[409600, 927408] ，示例：
+>
+>     * 画�尺寸 640×640=409600 满足最�值 ；
+>
+>     * 画�尺寸 834×1112=927408 满足最大值。
+>
+> * 大�：�个视频�超过 50 MB。
+>
+> * 帧率 (FPS)：\[24, 60]&#x20;
+
+***
+
+content.**role&#x20;**`string` `�件必填`
+
+视频的�置或用途。当�仅支� **reference\_video**。
+
+
+
+
+
+* **音频信�&#x20;**`object`&#x20;
+
+输入给模型的音频信�。仅 Seedance 2.0 & 2.0 fast 支�输入音频。注����独输入音频，应至少包� 1 个�考视频或图片。
+
+***
+
+content.**type&#x20;**`string`  `必选`
+
+输入内容的类型，此处应为 **audio\_url**。
+
+***
+
+content.**audio\_url&#x20;**`object`  `必选`
+
+输入给模型的音频对象。
+
+***
+
+content.audio\_url.**url&#x20;**`string`  `必选`
+
+音频 URL �音频 Base64 编��素� ID。
+
+* 音频 URL：填入音频的公网 URL。
+
+* Base64 编�：将本地文件转�为 Base64 编�字符串，然��交给大模型。�循格�：data:audio/<音频格�>;base64,\<Base64编�>，注� <音频格�> 需�写，如 data:audio/wav;base64,{base64\_audio}。
+
+* 素� ID：用于视频生�的虚拟人的音频素� ID，�循格�：asset://\<ASSET\_ID>。�从[素�&虚拟人�库](https://console.volcengine.com/ark-stg/region:ark-stg+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128)获�。
+
+> **传入�个音频�求**
+>
+> * 格�：wav�mp3
+>
+> * 时长：�个音频时长 \[2, 15] s，最多传入 3 段�考音频，所有音频总时长�超过 15 s。
+>
+> * 大�：�个音频�超过 15 MB，请求体大��超过 64 MB。大文件请勿使用Base64编�。
+
+***
+
+content.**role&#x20;**`string` `�件必填`
+
+音频的�置或用途。当�仅支� **reference\_audio** 。
+
+
+
+#### **service\_tier** `string`
+
+&#x20;Seedance 2.0 & 2.0 fast 暂�支�
+
+
+
+#### **generate\_audio&#x20;**`boolean`&#x20;
+
+> Seedance 2.0 & 2.0 fast 默认值： true
+
+控制生�的视频是�包�与画��步的声音。
+
+* true：模型输出的视频包��步音频。模型会基于文本�示�与视觉内容，自动生�与之匹�的人声�音效�背景音�。建议将对�部分置于�引�内，以优化音频生�效果。例如：男人��女人说：“你记�，以���以用手指指月亮。�
+
+* false：模型输出的视频为无声视频。
+
+> **说明**
+>
+> 生�的有声视频�为�声�，和传入的音频声�数无关。
+
+####
+
+#### **draft&#x20;**`boolean`
+
+&#x20;Seedance 2.0 & 2.0 fast 暂�支�
+
+
+
+#### **tools&#x20;**`object[]`
+
+> 仅 Seedance 2.0 & 2.0 fast 支�
+
+�置模型�调用的工具。
+
+***
+
+tools.**type&#x20;**`string`
+
+指定使用的工具类型。
+
+* web\_search：�网�索工具。
+
+> **说明**
+>
+> * 开��网�索�，模型会根�用户的�示�自主判断是��索互�网内容（如商��天气等）。���生�视频的时效性，但也会增加一定的时延。
+>
+> * 实际�索次数�通过 [查询视频生�任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 usage.tool\_usage.**web\_search** 字段获�，如果为 0 表示未�索。
+
+
+
+#### **resolution&#x20;**&#x20;`string`
+
+> Seedance 2.0 & 2.0 fast  默认值：720p
+
+视频分辨率，�值范围：
+
+* 480p
+
+* 720p
+
+
+
+#### **ratio&#x20;**`string`&#x20;
+
+> Seedance 2.0 & 2.0 fast 默认值： adaptive
+
+生�视频的宽高比例。��宽高比对应的宽高�素值�下方表格。
+
+* 16:9&#x20;
+
+* 4:3
+
+* 1:1
+
+* 3:4
+
+* 9:16
+
+* 21:9
+
+* adaptive：根�输入自动选择最�适的宽高比
+
+> **adaptive 适�规则**
+>
+> 当�置 **ratio** 为 adaptive 时，模型会根�生�场景自动适�宽高比；实际生�的视频宽高比�通过 [查询视频生�任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 **ratio** 字段获�。
+>
+> * 文生视频：根�输入的�示�，智能选择最�适的宽高比。
+>
+> * 首帧 / 首尾帧生视频：根�上传的首帧图片比例，自动选择最接近的宽高比。
+>
+> * 多模��考生视频：根�用户�示��图判断，如果是首帧生视频/编辑视频/延长视频，以该图片/视频为准选择最接近的宽高比；�则，以传入的第一个媒体文件为准（优先级：视频＞图片）选择最接近的宽高比。
+
+***
+
+**��宽高比对应的宽高�素值：**
+
+| 分辨率  | 宽高比  | 宽高�素值    |
+| ---- | ---- | -------- |
+| 480p | 16:9 | 864×496  |
+|      | 4:3  | 752×560  |
+|      | 1:1  | 640×640  |
+|      | 3:4  | 560×752  |
+|      | 9:16 | 496×864  |
+|      | 21:9 | 992×432  |
+| 720p | 16:9 | 1280×720 |
+|      | 4:3  | 1112×834 |
+|      | 1:1  | 960×960  |
+|      | 3:4  | 834×1112 |
+|      | 9:16 | 720×1280 |
+|      | 21:9 | 1470×630 |
+
+
+
+#### **duration** `integer`&#x20;
+
+> Seedance 2.0 & 2.0 fast  默认值：5
+
+生�视频时长，仅支�整数，��：秒。
+
+�值范围：
+
+* \[4,15] 或设置为-1
+
+> **�置方法**
+>
+> * 指定具体时长：支�有效范围内的任一整数。
+>
+> * 智能指定：设置为 -1，表示由模型在有效范围内自主选择�适的视频长度（整数秒）。实际生�视频的时长�通过 [查询视频生�任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 **duration** 字段获�。注�视频时长与计费相关，请谨慎设置。
+
+
+
+#### **frames** `integer`&#x20;
+
+Seedance 2.0 & 2.0 fast 暂�支�
+
+
+
+#### **camera\_fixed** `boolean`
+
+&#x20;Seedance 2.0 & 2.0 fast 暂�支�
+
+
+
+# Get/List-查询视频生�任务/列表
+
+> 查询视频生�任务：GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks/{id}
+>
+> 查询视频生�任务列表：GET https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks?page\_num={page\_num}\&page\_size={page\_size}\&filter.status={filter.status}\&filter.task\_ids={filter.task\_ids}\&filter.model={filter.model}
+
+## �应�数
+
+#### **tools&#x20;**`object[]`&#x20;
+
+> 仅 Seedance 2.0 & 2.0 fast 支�
+
+�置模型�调用的工具。
+
+***
+
+tools.**type&#x20;**`string`
+
+指定使用的工具类型。
+
+* web\_search：�网�索工具。
+
+
+
+#### **usage** `object`
+
+本次请求的 token 用�。
+
+***
+
+usage.**completion\_tokens** `integer`
+
+模型输出视频花费的 token 数�。
+
+***
+
+usage.**total\_tokens** `integer`
+
+本次请求消耗的总 token 数�。
+
+***
+
+usage.**tool\_usage&#x20;**`object`&#x20;
+
+> 仅 Seedance 2.0 & 2.0 fast 支�
+
+使用工具的用�信�。
+
+***
+
+usage.tool\_usage.**web\_search&#x20;**`integer`&#x20;
+
+实际调用�网�索工具的次数，仅开��网�索时返回。
+
+
+
+# 调用简介�示例
+
+## �程简介
+
+任务接�是异步接�，视频生�任务�程
+
+1. 创建视频生�任务接�创建视频生�任务
+
+2. 定时使用查询接�查询视频生�任务状�
+
+   1. 任务 running，过段时间�查询任务状�
+
+   2. 任务完�，返回视频链接，在24�时内下载生�的视频文件
+
+## 1. 创建视频生�任务
+
+> 以下示例仅展示 Seedance 2.0 & 2.0 fast 新增能力，更多视频生�示例详� [创建视频生�任务 API](https://www.volcengine.com/docs/82379/1520757)。
+
+### 多模��考
+
+### 编辑视频
+
+### 延长视频
+
+### 使用�网�索
+
+仅支�文本生视频
+
+## 2. 查询视频生�任务
+
+# 最佳实践-使用公共虚拟人�生�视频
+
+平��供公共虚拟人�素�库，目�您�以使用其中的图�素��创建一个统一�完备的视频主角。帮助您更好地控制主角，并确�其形象在多段视频中��一致，��因为真人人脸�制导致角色无法统一的问题。
+
+素�模�目�包�图片，并�供人物背景�述。�个素�对应一个独立素� ID (asset ID)，在体验中心的视频生�任务中，指定角色人脸生�视频。
+
+1. 在�览器中打开[体验中心](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128\&tab=GenVideo)，点击输入框下方的 **虚拟人�库** 页签。
+
+2. 检索需�使用的人�，支�使用自然语言检索�筛选框组�筛选。
+
+| 输入：文本                                                                                                                              | 输入：虚拟人��图片                                                                                                                                                              | 输出 |
+| ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
+| **图片1**中美妆�主用中文进行介�，妆容改为明艳大气，去掉脸部�光，笑容甜美，近景镜头，手�**图片2**的�霜��镜头展示，清新简约背景，元气甜美风格。�主��：挖到本命�霜了�质地�云朵一样软糯，一抹就�收，熬夜急救�补水�湿全�定，素颜都自带柔光感。 | ![Image Token: HTf6bPRukoWaW4xnCSlcvKtUn7c](images/HTf6bPRukoWaW4xnCSlcvKtUn7c.png)![Image Token: YfCDbzJlqo4yzZxCmdscWdsInCf](images/YfCDbzJlqo4yzZxCmdscWdsInCf.jpeg) |    |
+
+
+
+在 [Video Generation API](https://www.volcengine.com/docs/82379/1520758) 的 **content.<模�>\_url.url** 字段中使用 素� URI 生�视频。
+
+> 输入的�考内容，包括人�素�，需符�视频生��制，具体信�请查看使用�制。
+>
+> **注�**：
+>
+> * 首次在 API 中使用虚拟人�素� Asset URI �，需先在[方舟体验中心](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128\&tab=GenVideo)�交一次视频生�任务，阅读并��弹出的 **虚拟人�库使用�议**。
+>
+> * 体验中心支�体验视频生�能力。默认�次生� 4 段视频，为节约�本，建议设置为�次生� 1 �，具体方���考[虚拟人�库](https://www.volcengine.com/docs/82379/2223965?lang=zh)。
+
+���议的�作方�如下：
+
+![Image Token: LK8ybUN9Ko2KkQxq2FdclVQtnkh](images/LK8ybUN9Ko2KkQxq2FdclVQtnkh.gif)
+
+示例代�：
+
+# 使用自有虚拟人�素�生�视频（线下�交）
+
+方舟�供�域人�素�库，您�在视频生�中使用自有虚拟人物或真人（仅�素人）素�，生�短剧等更定制化的视频内容。平�将对您�供的素�进行审核，规��能产生的法律风险。
+
+* 自有素�需入库�使用，您�将虚拟人�或真人素���给销售代表，�时完��规承诺函�其他�明�料的准备。
+
+* 入库�，您�使用素�的 Asset ID，在视频生� API 中使用自有素�。
+
+> **��**：
+>
+> * 对虚拟人�素�，您需签署虚拟人�素��规承诺函，并�供签署承诺函所需的�料。
+>
+> * 对真实人物素�，除承诺函外，您还需�外�供真人授��料。
+>
+> * 具体�程�所需�料，请和您的销售代表确认。
+
+�交自有人�素�时，需按人物将素�分组：
+
+* �个人物为一个素�组。
+
+* �组�包�多个素�文件，素�文件对应唯一 ID (asset ID)。
+
+## 入库�程
+
+�交自有虚拟人�素�方�大致如下，请�系您的销售代表了解详情。
+
+1. 准备素�文件，完�承诺函签署，并准备其他�明�料。
+
+2. 准备素�文件，完�承诺函签署，并准备其他�明�料。
+
+   * �个人物素�需至少�供一张正�图片文件。此外，您�按需�供该人物的其他图片�视频素�。
+
+     * 需确��个人物组中的素�与该正�图片为�一人物。
+
+     * �个人物创建一个文件夹（命�：“*虚拟人� 1-<人��>*�）
+
+       �交素�文件夹示例：
+
+   ![Image Token: XMQ9bz6vhof7vxxsac8cqIZmneB](images/XMQ9bz6vhof7vxxsac8cqIZmneB.png)
+
+   > **注�**：
+   >
+   > * 以上示例仅供�考，您�根�视频创作需求，�交虚拟人物素�。
+   >
+   > * 您仅需上传视频生�任务中需�使用的素�。
+
+   * 素�文件需满足视频生� API 对输入文件的�求：
+
+   > **传入�张图片�求**
+   >
+   > * 格�：jpeg�png�webp�bmp�tiff�gif
+   >
+   > * 宽高比（宽/高）： (0.4, 2.5)&#x20;
+   >
+   > * 宽高长度（px）：(300, 6000)
+   >
+   > * 大�：�张图片�于 30 MB。请求体大��超过 64 MB。大文件请勿使用Base64编�。
+
+
+
+   > **传入�个视频�求**
+   >
+   > * 视频格�：mp4�mov。
+   >
+   > * 分辨率：480p�720p
+   >
+   > * 时长：�个视频时长 \[2, 15] s，最多传入 3 个�考视频，所有视频总时长�超过 15s。
+   >
+   > * 尺寸：
+   >
+   >   * 宽高比（宽/高）：\[0.4, 2.5]
+   >
+   >   * 宽高长度（px）：\[300, 6000]
+   >
+   >   * 画��素（宽 × 高）：\[409600, 927408] ，示例：
+   >
+   >     * 画�尺寸 640×640=409600 满足最�值 ；
+   >
+   >     * 画�尺寸 834×1112=927408 满足最大值。
+   >
+   > * 大�：�个视频�超过 50 MB。
+   >
+   > * 帧率 (FPS)：\[24, 60]&#x20;
+
+
+
+   > **注�**：
+   >
+   > 有关�交�程�承诺函签署所需�料的具体信�，请�系您的销售代表了解详情。
+
+3. 方舟将对您�供的素�进行审核，通过审核的素�将被上传至虚拟人�库。
+
+4. 入库�，�个人物组素�将通过以下示例中的形�返回，您�解压�查看：
+
+   ![Image Token: PKu6b3391oUbVKxxEGjchxBVnbg](images/PKu6b3391oUbVKxxEGjchxBVnbg.png)
+
+示例中：
+
+* Andy 为您�交的人物�称
+
+* group-20260310035119-9mzqn 为该人物组的 ID
+
+* 解压�，�查看�张素�的 Asset ID，如：
+
+![Image Token: VV0ybrxNfouEhZxTjqCcX1epnzb](images/VV0ybrxNfouEhZxTjqCcX1epnzb.png)
+
+* 您�按 `asset: //<asset_id>` 规则拼接 URI，在 API 中使用对应素�生�视频：
+
+具体调用方�请�考 [最佳实践-使用虚拟人�生�视频](https://bytedance.larkoffice.com/wiki/SANpwJ9bgiKgrykLaMTcAB0InWc#share-YurKdrLfAocLErxsTWDcKidPnGd)。
+
+## **注�事项**
+
+1. 首次在 API 中使用虚拟人�素� Asset URI �，需先在[方舟体验中心](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128\&tab=GenVideo)�交一次视频生�任务，阅读并��弹出的 **虚拟人�库使用�议**，�作方�如下：
+
+![Image Token: IFfPbDgceoFXZCxdriIcnwkPnUc](images/IFfPbDgceoFXZCxdriIcnwkPnUc.gif)
+
+* 仅支�使用已入库素�生�视频。
diff --git a/docs/API文档/old-「�密信���申请��填客户�称】Assets API �考文档（邀测用户版）.md b/docs/API文档/old-「�密信���申请��填客户�称】Assets API �考文档（邀测用户版）.md
new file mode 100644
index 0000000..75cb4f3
--- /dev/null
+++ b/docs/API文档/old-「�密信���申请��填客户�称】Assets API �考文档（邀测用户版）.md	
@@ -0,0 +1,1201 @@
+# 「⚠��密信���申请��填客户�称】Assets API �考文档（邀测用户版）
+
+本文介�素�资产（Assets）API 接�的�数。您�以使用以下 Assets API 接�创建�管�个人人�素�资产。
+
+> 本文档仅�预览�邀测用户使用：
+>
+> * �承诺正� API 上线100%一致。
+>
+> * 仅�邀测用户阅读，请勿截图/分享给其他人员。
+>
+> * 您需确�上传的虚拟人�符�以下�件：
+>
+>   * 您�法拥有该素�，并享有完整的使用�处分��。素��包�未获授�的第三方商标�标识类内容。
+>
+>   * 素��得与任何自然人肖�或形象雷�，素��存在抄袭�盗用情形，�会侵害任何第三方的人格��知识产�等�法�益。
+>
+>   * 素��包���法规��背公�良俗��害国家安全的内容。
+
+
+
+# 素�资产（Assets）API 接�功能
+
+> **素�资产的概念说明：**
+>
+> * **Asset（素�资产）**：一个素�文件（图片），是方舟 Seedance 2.0 系列模型�直接用于推�的�信资产。
+>
+>   * 仅需入库推�需使用的素�资产，�需使用的素�资产请勿入库。
+>
+>   * 仅�使用已入库素�资产的 Id (Asset ID) 进行视频生�，�一形象未入库素�无法使用。
+>
+> * **Asset Group（素�资产组�）**：�个素�文件为一个 Asset，�个 Asset 属于一个 Asset Group。
+>
+>   * �以使用素�组自由管�素�，例如�将�一人物��一工作室或项目组的素�放入�一素�组�进行管�。
+
+**Asset (Group) 创建接�：**
+
+1. CreateAssetGroup：创建素�资产组�。**首次创建素�资产组�时需在控制�签署授�函，详情�考 [ �域虚拟人�素�库 (WIP)](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe)**
+
+2. CreatAsset：创建素�资产。该接��用于上传个人素�资产，创建素�资产��利用返回字段中的素� **Id （需处于 `active` 状�）**&#x7528;于 Seedance 2.0 系列模型生�视频。
+
+
+
+**Asset (Group) 管�接�：**
+
+* ListAssetGroups：查询素�资产组�列表。
+
+* ListAssets：查询素�资产列表。
+
+* GetAsset：查询素�资产信�。
+
+* GetAssetGroup：查询素�资产组�信�。
+
+* UpdateAssetGroup：更新素�资产组�信�。
+
+* UpdateAsset：更新素�资产信�。
+
+
+
+# 鉴�方�
+
+调用素�资产（Assets）API 接�需使用 Access Key 鉴�，详情�考 [获� API 访问密钥（AK/SK）](https://www.volcengine.com/docs/6257/64983?lang=zh)。
+
+
+
+# ���求
+
+* 并�数�制：账�下�一时刻在处�中的任务数�上�，超过此�制的任务将进入队列等待处�。**�时进行处�的asset创建任务�超过30。**
+
+* QPS ��： API接��秒查询请求的总数上�。超过此�制的查询请求会报错。
+
+| 接��              | 账�维度的 QPS �� |
+| ---------------- | ------------ |
+| CreateAssetGroup | 30           |
+| CreateAsset      | 30           |
+| ListAssetGroups  | 30           |
+| ListAssets       | 30           |
+| GetAsset         | 100          |
+| GetAssetGroup    | 100          |
+| UpdateAsset      | 30           |
+| UpdateAssetGroup | 30           |
+
+# CreateAssetGroup
+
+> **POST&#x20;**/open/CreateAssetGroup
+
+创建 Asset Group（素�资产组�）组�，用作素�资产管�。
+
+> **首次创建 Asset Group（素�资产组�）需在控制�签署授�函，详情�考 [ �域虚拟人�素�库 (WIP)](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe)**
+
+### **Name** `string` `å¿…å¡«`
+
+Asset Group（素�资产组�）的�称，上�为 64 字符。
+
+***
+
+### **Description** `string`
+
+Asset Group（素�资产组�）的�述，上�为 300 字符。
+
+***
+
+### **GroupType &#x20;**`string`
+
+Asset Group（素�资产组�）的类型。�选值：
+
+* AIGC：虚拟人�。
+
+***
+
+### **ProjectName&#x20;**`string`**&#x20;**
+
+资�所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id** `string`
+
+Asset Group（素�资产组�）的 Id。
+
+***
+
+返回示例：
+
+```bash
+{
+    "Id": "group-2026**********-*****"
+}
+```
+
+
+
+# CreateAsset&#x20;
+
+> **POST&#x20;**/open/CreateAsset
+
+�指定的Asset Group（素�资产组�）内创建Asset（素�资产）。
+
+
+
+## 请求�数
+
+### **GroupId** `string` `å¿…å¡«`
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+### **URL** `string` `å¿…å¡«`
+
+传入的Asset（素�资产）的公共�访问地�。
+
+***
+
+### **Name** `string`&#x20;
+
+Asset（素�资产）的�称，上�为64个字符。
+
+***
+
+### **AssetType `string` `å¿…å¡«`**
+
+Asset（素�资产）的类型，当�仅支�传入图�。�选值：
+
+* Image：Asset（素�资产）的类型为图�。
+
+> **传入图�的�求说明**
+>
+> * 格�：jpeg�png�webp�bmp�tiff�gif�heic/heif
+>
+> * 宽高比（宽/高）： (0.4, 2.5)&#x20;
+>
+> * 宽高长度（px）：(300, 6000)
+>
+> * 大�：�张图片�于 30 MB。
+
+***
+
+### **ProjectName** `string`&#x20;
+
+资�所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+> 需�和待传入的 Asset Group（素�资产组�）的 **ProjectName&#x20;**&#x4FDD;�一致。
+
+***
+
+
+
+## 返回�数
+
+### **Id&#x20;**`string`&#x20;
+
+Asset（素�资产）的 Id。
+
+***
+
+返回示例：
+
+```bash
+{
+    "Id": "Asset-2026**********-*****"
+}
+```
+
+
+
+# ListAssets
+
+> **POST&#x20;**/open/ListAssets
+
+查询符�筛选�件的Assets（素�资产）列表。
+
+## 请求�数
+
+### **Filter** `object` `å¿…å¡«`
+
+�索的过滤�件。
+
+***
+
+Filter.**GroupIds** `array`
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+Filter.**GroupType** `string` `å¿…å¡«`
+
+Asset Group（素�资产组�）的类型。�选值：
+
+* AIGC：虚拟人�。
+
+***
+
+Filter.**Statuses** `array`**&#x20;**
+
+任务状�。
+
+* Active：素�资产（Asset）已处�完毕，�以使用。
+
+* Processing：素�资产（Asset）正在预处�，无法使用。
+
+* Failed：素�资产（Asset）处�失败。
+
+***
+
+Filter.**Name** `string`**&#x20;**
+
+Asset（素�资产）的�称，上�为64个字符。
+
+***
+
+### **PageNumber** `int (i64)` `å¿…å¡«`
+
+�索页�，�用于列表分页功能，从 1 开始。例如："page\_number": 1，�返回第一页的�索结果。
+
+***
+
+### **PageSize** `int (i64)` `å¿…å¡«`
+
+�页�索结果的数�，上�为100。
+
+***
+
+### **SortBy** `string`
+
+用于排�的字段�称，默认值 `createTime`。支�以下类型：
+
+* CreateTime：根�创建时间排�。
+
+* UpdateTime：根�更新时间排�。
+
+* GroupId：根�资产素�组的 Id 排�。
+
+***
+
+### **SortOrder** `string`
+
+排�顺�，默认值 `Desc`。�选值：
+
+* Desc：��
+
+* Asc：��
+
+***
+
+### **ProjectName** `string`
+
+资�所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Items** `array[]`&#x20;
+
+符�筛选�件的Asset（素�资产）数组。
+
+***
+
+Items.**Id** `string`
+
+Asset（素�资产）的 Id。
+
+***
+
+Items.**name** `string`
+
+Asset（素�资产）的�称，上�为64个字符。
+
+***
+
+Items.**URL** `string`
+
+Asset（素�资产）的公共�访问地�。
+
+***
+
+Items.**GroupId** `string`&#x20;
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+Items.**AssetType** `string`
+
+Asset（素�资产）的类型。
+
+* Image：Asset（素�资产）的类型为图�。
+
+***
+
+Items.**Status** `string`
+
+任务状�。
+
+* Active：素�资产（Asset）已处�完毕，�以使用。
+
+* Processing：素�资产（Asset）正在预处�，无法使用。
+
+* Failed：素�资产（Asset）处�失败。
+
+***
+
+Items.**Error** `object`
+
+错误信�。
+
+***
+
+Items.Error.**Code** `string`
+
+错误�。
+
+***
+
+Items.Error.**Message** `string`
+
+错误信�。
+
+***
+
+Items.**ProjectName** `string`
+
+资�所属的项目�称。
+
+***
+
+Items.**CreateTime&#x20;**`string`
+
+创建时间。
+
+***
+
+Items.**UpdateTime&#x20;**`string`
+
+更新时间。
+
+***
+
+### **TotalCount&#x20;**`int (i64)`
+
+返回总数。
+
+***
+
+### **PageNumber&#x20;**`int (i64)`
+
+返回的页数。
+
+***
+
+### **PageSize&#x20;**`int (i64)`
+
+�页�索结果的数�，上�为100。
+
+
+
+# ListAssetGroups
+
+> **POST&#x20;**/open/ListAssetGroups
+
+查询符�筛选�件的Asset Groups（素�资产组�）列表。
+
+## 请求�数
+
+### **Filter** `object` `å¿…å¡«`
+
+�索的过滤�件。
+
+***
+
+Filter.**name** `string`
+
+Asset Group（素�资产组�）的�称，上�为64个字符。
+
+***
+
+Filter.**GroupIds** `array`
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+Filter.**GroupType** `string`**&#x20;**`å¿…å¡«`
+
+Asset Group（素�资产组�）的类型。�选值：
+
+* AIGC：虚拟人�。
+
+***
+
+### **PageNumber** `int (i64)`
+
+�索页�，�用于列表分页功能，从 1 开始。例如："page\_number": 1，�返回第一页的�索结果。
+
+***
+
+### **PageSize** `int (i64)`
+
+�页�索结果的数�，上�为100。
+
+***
+
+### **SortBy** `string`
+
+用于排�的字段�称，默认值 `createTime`。支�以下类型：
+
+* CreateTime：根�创建时间排�。
+
+* UpdateTime：根�更新时间排�。
+
+***
+
+### **SortOrder** `string`
+
+排�顺�，默认值 `Desc`。�选值：
+
+* Desc：��
+
+* Asc：��
+
+***
+
+### **ProjectName** `string`
+
+资�所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **TotalCount&#x20;**`int (i64)`
+
+返回的 Asset Group（素�资产组�）的总数。
+
+***
+
+### **Items** `array[]`&#x20;
+
+符�筛选�件的 Asset Group（素�资产组�）数组。
+
+***
+
+Items.**Id** `string`
+
+Asset Group（素�资产组�）的 Id。
+
+***
+
+Items.**Name** `string`
+
+Asset Group（素�资产组�）的�称，上�为64个字符。
+
+***
+
+Items.**Title** `string`
+
+Asset Group（素�资产组�）的标题。
+
+> �将下线，请直接使用�数 Name
+
+***
+
+Items.**Description** `string`
+
+Asset Group（素�资产组�）的�述，上�为 300 字符。
+
+***
+
+Items.**GroupType** `string`
+
+Asset Group（素�资产组�）的类型。
+
+* AIGC：虚拟人�。
+
+***
+
+Items.**ProjectName** `string`
+
+资�所属的项目�称。
+
+***
+
+Items.**CreateTime** `string`
+
+创建时间。
+
+***
+
+Items.**UpdateTime** `string`
+
+更新时间。
+
+***
+
+### **PageNumber&#x20;**`int (i64)`
+
+返回的页数。
+
+***
+
+### **PageSize&#x20;**`int (i64)`
+
+�页�索结果的数�，上�为100。
+
+***
+
+
+
+# GetAssetGroup
+
+> **POST&#x20;**/open/GetAssetGroup
+
+获��个Asset Group（素�资产组�）信�。
+
+## 请求�数
+
+
+
+### **Id&#x20;**`string` `å¿…å¡«`
+
+Asset Group（素�资产组�）的 Id
+
+***
+
+### **ProjectName&#x20;**`string`
+
+需�查询的 Asset Group（素�资产组�）所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id** `string`
+
+Asset Group（素�资产组�）的 Id。
+
+***
+
+### **Name** `string`
+
+Asset Group（素�资产组�）的�称，上�为64个字符。
+
+***
+
+### **Title** `string`&#x20;
+
+Asset Group（素�资产组�）的标题。
+
+> �将下线，请直接使用�数 Name
+
+***
+
+### **Description** `string`
+
+Asset Group（素�资产组�）的�述，上�为 300 字符。
+
+***
+
+### **GroupType &#x20;**`string`
+
+Asset Group（素�资产组�）的类型。
+
+* AIGC：虚拟人�
+
+***
+
+### **ProjectName&#x20;**`string`**&#x20;**
+
+资�所属的项目�称。
+
+***
+
+### **CreateTime&#x20;**`string`
+
+创建时间。
+
+***
+
+### **UpdateTime&#x20;**`string`
+
+更新时间。
+
+***
+
+##
+
+# GetAsset
+
+> **POST&#x20;**/open/GetAsset
+
+获��个Asset（素�资产）信�。
+
+## 请求�数
+
+
+
+### **Id&#x20;**`string`  `å¿…å¡«`&#x20;
+
+Asset（素�资产）的 Id。
+
+***
+
+### **ProjectName&#x20;**`string`
+
+需�查询的 Asset（素�资产）所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id&#x20;**`string`
+
+Asset（素�资产）的 Id。
+
+***
+
+### **Name** `string`
+
+Asset（素�资产）的�称，上�为64个字符。
+
+***
+
+### **URL &#x20;**`string`
+
+Asset（素�资产）的访问地�。
+
+***
+
+### **AssetType&#x20;**`string`
+
+Asset（素�资产）的类型。
+
+* Image：Asset（素�资产）的类型为图�。
+
+***
+
+### **GroupId** `string`
+
+Asset（素�资产）所属的 Asset Group（素�资产组�）的 Id。
+
+***
+
+### **Status** `string`
+
+任务状�。
+
+* Active：素�资产（Asset）已处�完毕，�以使用。
+
+* Processing：素�资产（Asset）正在预处�，无法使用。
+
+* Failed：素�资产（Asset）处�失败。
+
+***
+
+### **Error** `object`
+
+错误信�。
+
+***
+
+Error.**Code** `string`
+
+错误�。
+
+***
+
+Error.**Message** `string`
+
+错误信�。
+
+***
+
+### **CreateTime&#x20;**`string`
+
+创建时间。
+
+***
+
+### **UpdateTime&#x20;**&#x20;`string`
+
+更新时间。
+
+***
+
+### **ProjectName** `string`&#x20;
+
+资�所属的项目�称。
+
+***
+
+##
+
+# **UpdateAssetGroup**
+
+> **POST&#x20;**/open/UpdateAssetGroup
+
+更新�个 Asset Group（素�资产组�）信�。当�仅支�更新 Asset Group（素�资产组�）的 Name 和 Description。
+
+## 请求�数
+
+### **Id&#x20;**`string` `å¿…å¡«`
+
+需�更新的 Asset Group（素�资产组�）的 Id
+
+***
+
+### **Name&#x20;**`string`&#x20;
+
+需�更新的 Asset Group（素�资产组�）的新�称，上�为64个字符。
+
+***
+
+### **Description** `string`
+
+需�更新的 Asset Group（素�资产组�）的新�述，上�为 300 字符。
+
+***
+
+### **ProjectName** `string`&#x20;
+
+需�更新的 Asset Group（素�资产组�）所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id** `string`
+
+Asset Group（素�资产组�）的 Id。
+
+***
+
+
+
+
+
+# **UpdateAsset**
+
+> **POST&#x20;**/open/UpdateAsset
+
+更新�个Asset（素�资产）信�。当�仅支�更新Asset（素�资产）的 Name。
+
+## 请求�数
+
+### **Id&#x20;**`string` `å¿…å¡«`
+
+需�更新的 Asset（素�资产）的 Id
+
+***
+
+### **Name&#x20;**`string`&#x20;
+
+需�更新的 Asset（素�资产）的新�称，上�为64个字符。
+
+***
+
+### **ProjectName** `string`
+
+需�更新的 Asset（素�资产）所属的项目�称，默认值为`default`。
+
+若资��在默认项目中，需填写正确的项目�称，获�项目�称，请查看 [文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+***
+
+
+
+## 返回�数
+
+### **Id** `string`
+
+Asset（素�资产）的 Id。
+
+***
+
+
+
+# 代�示例：
+
+> **以下示例为使用 Asset API 创建素�资产并用于视频生�的使用链路：**
+>
+> 1. **创建素�资产组�：**&#x8C03;用 **CreateAssetGroup** 接�创建一个素�资产组�（Asset Group），用于对�一项目或人物的素�进行统一管�。首次创建时需在控制�签署授�函。
+>
+> 2. **上传素�资产并等待预处�完�：**&#x8C03;用 **CreateAsset** 接�上传图片素�，传入图片的公共访问URL�所属的Group ID，获得素�资产ID（Asset ID）。
+>    由于上传的素�资产需�过预处���能使用，�轮询调用 **GetAsset** 接�查询素�状�，直至状��为 `Active`。若状�为 `Failed` 则表示处�失败。
+>
+> 3. **在视频生� API 中使用素�：**&#x5F53;素�资产状�为 `Active` �，将素�ID按 `Asset://<Asset_Id>` 的格�拼接�URL，在视频生�API（如Seedance 2.0系列模型）的请求中，将该URL作为�考图�的 `image_url` 传入，��使用该素�资产生�视频。
+>
+> **API 鉴�方�区别说明**
+>
+> * **Asset API：**&#x41;ccess Key 鉴�，详情�考 [获� API 访问密钥（AK/SK）](https://www.volcengine.com/docs/6257/64983?lang=zh)。
+>
+> * **视频生� API：**&#x41;PI Key 鉴�，详情�考  [管� API Key](https://www.volcengine.com/docs/82379/1361424?lang=zh)。
+>
+> **素�库[项目](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)（Project）隔离说明**
+>
+> * �指定的 Asset Group（素�资产组�）内创建或查询 Asset（素�资产）时，需��两者的 **ProjectName&#x20;**&#x4E00;致
+>
+> * Asset（素�资产）所属的 **ProjectName** 需与调用视频生� API 接�时使用的 API key 所属的 **ProjectName** 一致
+
+## 1. 创建素�资产组�
+
+```go
+package main
+
+import (
+    "fmt"
+
+    "github.com/bytedance/sonic"
+    "github.com/volcengine/volcengine-go-sdk/volcengine"
+    "github.com/volcengine/volcengine-go-sdk/volcengine/credentials"
+    "github.com/volcengine/volcengine-go-sdk/volcengine/session"
+    "github.com/volcengine/volcengine-go-sdk/volcengine/universal"
+)
+
+func main() {
+    config := volcengine.NewConfig().WithCredentials(credentials.NewStaticCredentials("<your_ak>", "<your_sk>", "")).WithRegion("cn-beijing")
+    sess, _ := session.NewSession(config)
+    resp, err := universal.New(sess).DoCall(
+        universal.RequestUniversal{
+            ServiceName: "ark",
+            Action:      "CreateAssetGroup",
+            Version:     "2024-01-01",
+            HttpMethod:  universal.POST,
+            ContentType: universal.ApplicationJSON,
+        },
+        //根�实际情况填写
+        &map[string]any{
+            "Name":        "test",
+            "Description": "test",
+            "GroupType":   "AIGC",
+        },
+    )
+    if err != nil {
+        return
+    }
+    if resp == nil {
+        return
+    }
+    respData, err := sonic.Marshal(resp)
+    fmt.Println(string(respData))
+}
+```
+
+返回示例
+
+```json
+{"ResponseMetadata":{"RequestId":"20260318155041036F7CB6362358FB40FC","Action":"CreateAssetGroup","Version":"2024-01-01","Service":"ark","Region":"cn-beijing"},"Result":{"Id":"group-2026**********-*****"}}
+```
+
+
+
+## 2. 上传素�资产并获�素�资产信�
+
+```go
+package main
+
+import (
+    "errors"
+    "fmt"
+    "time"
+
+    "github.com/bytedance/sonic"
+    "github.com/volcengine/volcengine-go-sdk/volcengine"
+    "github.com/volcengine/volcengine-go-sdk/volcengine/credentials"
+    "github.com/volcengine/volcengine-go-sdk/volcengine/session"
+    "github.com/volcengine/volcengine-go-sdk/volcengine/universal"
+)
+
+const (
+    region      = "cn-beijing"
+    serviceName = "ark"
+    version     = "2024-01-01"
+
+    // 轮询�置
+    pollInterval = 3 * time.Second
+    pollTimeout  = 2 * time.Minute
+)
+
+func main() {
+    // TODO: 替�为你的 AK / SK
+    ak := "<your_ak>"
+    sk := "<your_sk>"
+
+    // TODO: 替�为你的实际�数
+    groupID := "<group-20260318033332-*****>"
+    assetURL := "<image_url>"
+    assetType := "Image"
+    projectName := "Default"
+
+    config := volcengine.NewConfig().
+        WithCredentials(credentials.NewStaticCredentials(ak, sk, "")).
+        WithRegion(region)
+
+    sess, err := session.NewSession(config)
+    if err != nil {
+        fmt.Printf("create session failed: %v\n", err)
+        return
+    }
+
+    client := universal.New(sess)
+
+    // 1. 创建素�资产
+    assetID, err := createAsset(client, groupID, assetURL, assetType, projectName)
+    if err != nil {
+        fmt.Printf("create asset failed: %v\n", err)
+        return
+    }
+
+    fmt.Printf("asset created, AssetId = %s\n", assetID)
+
+    // 2. 查询素�资产状�
+    finalURL, err := waitForAssetActive(client, assetID, pollInterval, pollTimeout)
+    if err != nil {
+        fmt.Printf("poll asset failed: %v\n", err)
+        return
+    }
+
+    fmt.Printf("asset is active, URL = %s\n", finalURL)
+}
+
+// createAsset 调用 CreateAsset 并返回 AssetId
+func createAsset(client *universal.Universal, groupID, url, assetType, projectName string) (string, error) {
+    resp, err := client.DoCall(
+        universal.RequestUniversal{
+            ServiceName: serviceName,
+            Action:      "CreateAsset",
+            Version:     version,
+            HttpMethod:  universal.POST,
+            ContentType: universal.ApplicationJSON,
+        },
+        &map[string]any{
+            "GroupId":     groupID,
+            "URL":         url,
+            "AssetType":   assetType,
+            "ProjectName": projectName,
+        },
+    )
+    if err != nil {
+        return "", err
+    }
+    if resp == nil {
+        return "", errors.New("create asset response is nil")
+    }
+
+    // 打�原始返回，便于排查
+    respData, _ := sonic.Marshal(resp)
+    fmt.Printf("CreateAsset response: %s\n", string(respData))
+
+    assetID := extractString(resp, "Result", "Id")
+    if assetID == "" {
+        assetID = extractString(resp, "Result", "AssetId")
+    }
+    if assetID == "" {
+        assetID = extractString(resp, "Id")
+    }
+    if assetID == "" {
+        assetID = extractString(resp, "AssetId")
+    }
+
+    if assetID == "" {
+        return "", fmt.Errorf("cannot find AssetId in response: %s", string(respData))
+    }
+
+    return assetID, nil
+}
+
+// waitForAssetActive 查询 GetAsset，直到 Active / Failed / 超时
+func waitForAssetActive(client *universal.Universal, assetID string, interval, timeout time.Duration) (string, error) {
+    deadline := time.Now().Add(timeout)
+
+    for {
+        if time.Now().After(deadline) {
+            return "", fmt.Errorf("polling timeout after %v, assetID=%s", timeout, assetID)
+        }
+
+        status, url, errMsg, err := getAssetStatus(client, assetID)
+        if err != nil {
+            return "", err
+        }
+
+        fmt.Printf("asset status: %s\n", status)
+
+        switch status {
+        case "Processing":
+            time.Sleep(interval)
+            continue
+        case "Active":
+            if url == "" {
+                return "", fmt.Errorf("asset is Active but URL is empty, assetID=%s", assetID)
+            }
+            return url, nil
+        case "Failed":
+            if errMsg == "" {
+                errMsg = "unknown asset processing error"
+            }
+            return "", fmt.Errorf("asset processing failed: %s", errMsg)
+        default:
+            // 若返回其他状�，�守处�为继续查询
+            fmt.Printf("unexpected status %q, continue polling...\n", status)
+            time.Sleep(interval)
+        }
+    }
+}
+
+// getAssetStatus 调用 GetAsset，返回 Status / URL / Error
+func getAssetStatus(client *universal.Universal, assetID string) (status, url, errMsg string, err error) {
+    resp, err := client.DoCall(
+        universal.RequestUniversal{
+            ServiceName: serviceName,
+            Action:      "GetAsset",
+            Version:     version,
+            HttpMethod:  universal.POST,
+            ContentType: universal.ApplicationJSON,
+        },
+        &map[string]any{
+            "Id": assetID,
+        },
+    )
+    if err != nil {
+        return "", "", "", err
+    }
+    if resp == nil {
+        return "", "", "", errors.New("get asset response is nil")
+    }
+
+    // 打�原始返回，便于排查
+    respData, _ := sonic.Marshal(resp)
+    fmt.Printf("GetAsset response: %s\n", string(respData))
+
+    // 兼容��层级的字段�置
+    status = extractString(resp, "Result", "Status")
+    if status == "" {
+        status = extractString(resp, "Status")
+    }
+
+    url = extractString(resp, "Result", "URL")
+    if url == "" {
+        url = extractString(resp, "URL")
+    }
+
+    errMsg = extractString(resp, "Result", "Error")
+    if errMsg == "" {
+        errMsg = extractString(resp, "Error")
+    }
+
+    return status, url, errMsg, nil
+}
+
+// extractString 从�应中按层级安全��字符串
+func extractString(data any, keys ...string) string {
+    current := data
+
+    for _, key := range keys {
+        switch v := current.(type) {
+        case map[string]any:
+            next, ok := v[key]
+            if !ok {
+                return ""
+            }
+            current = next
+
+        case *map[string]any:
+            if v == nil {
+                return ""
+            }
+            next, ok := (*v)[key]
+            if !ok {
+                return ""
+            }
+            current = next
+
+        default:
+            return ""
+        }
+    }
+
+    switch v := current.(type) {
+    case string:
+        return v
+    case fmt.Stringer:
+        return v.String()
+    case nil:
+        return ""
+    default:
+        return fmt.Sprintf("%v", v)
+    }
+}
+```
+
+返回示例
+
+```json
+CreateAsset response: {"ResponseMetadata":{"RequestId":"202603181520431F067112A17FC078A6DF","Action":"CreateAsset","Version":"2024-01-01","Service":"ark","Region":"cn-beijing"},"Result":{"Id":"Asset-2026**********-*****"}}
+asset created, AssetId = asset-20260318072044-n8bcl
+GetAsset response: {"ResponseMetadata":{"Service":"ark","Region":"cn-beijing","RequestId":"202603181520448A995106924553F77D0E","Action":"GetAsset","Version":"2024-01-01"},"Result":{"Name":"","GroupId":"group-2026**********-*****","CreateTime":"2026-03-18T07:20:44Z","ProjectName":"default","Id":"Asset-2026**********-*****","URL":"","AssetType":"Image","Status":"Processing","UpdateTime":"2026-03-18T07:20:44Z"}}
+asset status: Processing
+GetAsset response: {"Result":{"UpdateTime":"2026-03-18T07:20:47Z","ProjectName":"default","Id":"Asset-2026**********-*****","CreateTime":"2026-03-18T07:20:44Z","Name":"","URL":"","AssetType":"Image","GroupId":"group-2026**********-*****","Status":"Processing"},"ResponseMetadata":{"Version":"2024-01-01","Service":"ark","Region":"cn-beijing","RequestId":"2026031815204766FE2BA543E6FF666F66","Action":"GetAsset"}}
+asset status: Processing
+GetAsset response: {"ResponseMetadata":{"Version":"2024-01-01","Service":"ark","Region":"cn-beijing","RequestId":"202603181520511F067112A17FC078A75A","Action":"GetAsset"},"Result":{"Name":"","URL":"https://ark-media-asset-stg.tos-cn-beijing.volces.com/xxxx","AssetType":"Image","Status":"Active","Id":"Asset-2026**********-*****","GroupId":"group-2026**********-*****","CreateTime":"2026-03-18T07:20:44Z","UpdateTime":"2026-03-18T07:20:47Z","ProjectName":"default"}}
+asset status: Active
+asset is active, URL = https://ark-media-asset-stg.tos-cn-beijing.volces.com/xxxx
+```
+
+
+
+更多语言的示例代�详�：
+
+> 注�替� Demo 中的 AK与SK，若需调用其他接�如 ListAssets，需替� ACTION 与对应请求�数。
+
+| **Python** | 创建素�资产组�： 上传素�资产并获�素�资产信�：  |
+| ---------- | --------------------------- |
+| **Java**   | 创建素�资产组�： 上传素�资产并获�素�资产信�：  |
+| **PHP**    | 创建素�资产组�： 上传素�资产：           |
+
+
+
+## 3. 素�资产用于视频生�
+
+当上传的素�资产状�为 `Active` 时，�将素� Id 按 `Asset: //<Asset_Id>` 的规则拼接 URL，以在 **视频生� API&#x20;**&#x4E2D;使用对应的素�资产生�视频：
+
+```json
+            {
+                "type": "image_url",
+                "image_url": {
+                    "url": "Asset://Asset-2026**********-*****"
+                },
+                "role": "reference_image"
+            },
+```
+
+使用素�资产生�视频的具体调用方�请�考[ �申请��填客户�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）](https://bytedance.larkoffice.com/wiki/SANpwJ9bgiKgrykLaMTcAB0InWc#share-ONSwd51ezoXCJqxkAm2cIC61nMX)。
+
diff --git a/docs/API文档/「�密信���申请��填客户�称】控制�上传自有虚拟人�至素�资产库（邀测用户版）.md b/docs/API文档/「�密信���申请��填客户�称】控制�上传自有虚拟人�至素�资产库（邀测用户版）.md
new file mode 100644
index 0000000..acb3826
--- /dev/null
+++ b/docs/API文档/「�密信���申请��填客户�称】控制�上传自有虚拟人�至素�资产库（邀测用户版）.md
@@ -0,0 +1,128 @@
+# 「⚠��密信���申请��填客户�称】控制�上传自有虚拟人�至素�资产库（邀测用户版）
+
+> 请注�，仅开白用户在控制��&#x89C1;**《上传虚拟人�素��规承诺函》**&#x7684;签署入�，若仅�&#x89C1;**《素�资产功能使用规则》**，则需申请开白
+
+# 1. 介�
+
+3月19日起功能上线�，�山方舟会在控制�支�完�开白的B端客户批�上传和管�虚拟人资产，�时支�使用API创建�管�，�许�业上传**自有AIGC虚拟人**（��牌定制 IP�自制数字人�采购的�规虚拟人等），在线勾选确&#x8BA4;**《上传虚拟人�素��规承诺函》**，承诺上传的虚拟人�为�业�法所有�未侵犯任何第三方�益��与任何自然人的肖�形象相�或相似�仅用于�规用途，��完�确�，将虚拟人�上传入库，在推�中使用，仅�使用已入库的素�资产进行视频生�，未入库素�，�使为已入库�一角色的��妆造，也无法使用。
+
+
+
+# 2. 使用�程
+
+![画� 1](images/whiteboard_1_1774075398978.png)
+
+|                 | 释义                                              | 举例                                                                                                                                                                                                                                                        |
+| --------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **素�资产（Asset）** | 一个素�文件（本期**仅支�图片**），是方舟Seedance系列模型�直接用于推�的�信资产 | ![Image Token: QwfCbg7HWodX84x6Jwdl8iWxg6d](images/QwfCbg7HWodX84x6Jwdl8iWxg6d.png)                                                                                                                                                                       |
+| **资产组�（Group）** | 将原�化的资产（Asset）组�起�，�以人物�工作室�项目组等维度将素�进行分组管�     | ![Image Token: KXmAbBvXTophYGxhUzulqOfWgab](images/KXmAbBvXTophYGxhUzulqOfWgab.png)![Image Token: S1KRbfaOzoyqNux7uh4laVqVgZc](images/S1KRbfaOzoyqNux7uh4laVqVgZc.png)![Image Token: YMKAbeeLpowghBxfQxmlzfPngAf](images/YMKAbeeLpowghBxfQxmlzfPngAf.png) |
+
+## 2.1 方舟控制�
+
+1. **首次使用签署使用承诺函**：开白用户��**�山方舟体验中心-视觉模型-视频生�页�顶部�我的素�资产】**，点击进入素�资产管�界�，首次使用�需签署《上传虚拟人�素��规承诺函》《素�资产功能使用规则》（仅需授�一次）
+
+![Image Token: ZD36bcZEgo9FXnxm6lvlEX00gqY](images/ZD36bcZEgo9FXnxm6lvlEX00gqY.png)
+
+![体验中心�我的资产】首次进入时，调起�议弹窗 (Token: EHCSbgUCyocNvdxn4Qql6nHfgab)](images/EHCSbgUCyocNvdxn4Qql6nHfgab.png)
+
+* **创建素�资产组�（Group）**：�通过控制�上传�个或多个资产文件批�创建素�资产组�（Group），**当�仅支�上传的�个文件分别创建资产组，暂�支�创建一个资产组，�时注入多个资产**
+
+![�我的素�资产】��，�上角点击�添加素�资产组】 (Token: HfQvbsOknoJ2MfxVTuVlpKqjg0c)](images/HfQvbsOknoJ2MfxVTuVlpKqjg0c.png)
+
+![Image Token: H7fabAsJSon7mqx0yzklmB20gXb](images/H7fabAsJSon7mqx0yzklmB20gXb.png)
+
+![点击上传/拖拽上传文件 (Token: XNrTbx6f9onxK6xzEHmlpPApgNb)](images/XNrTbx6f9onxK6xzEHmlpPApgNb.png)
+
+* �次创建上�为**100个资产组�（Group）**，�账��许的资产组�（Group）数�本期�设�
+
+* �个素�上传�求：
+
+> - **图片格�**：控制�本期仅支�文件�缀为`.jpg`�`.jpeg`�`.png`（与API有差异）
+>
+> - **文件大�**：�张图片�于30M
+>
+> - **宽高比（宽/高）**：(0.4, 2.5)
+>
+> - **宽高长度（px）**：(300, 6000)
+
+* 资产组�标题/�述/资产�称字段：
+
+  | **资产组��称（Group Name）**        | 必填，最大字符12（与API有差异）  |
+  | ----------------------------- | ------------------- |
+  | **资产组��述（Group Description）** | 选填，最大字符100（与API有差异） |
+  | **资产�称（Asset Name）**          | 必填，最大字符12（与API有差异）  |
+
+  ![Image Token: OLX5bqDmuoFvScxMSjoldvMngcg](images/OLX5bqDmuoFvScxMSjoldvMngcg.png)
+
+  * 控制�上传时暂�支�直接编辑上述字段， 支�通过文件命�自动解�
+
+  > 命�规范：`{AssetName1}&&{GroupName1}&&{GroupDescription1(选填)}.jpg`
+  >
+  > 若无`&&`连接符，则文件�=`GroupName`=`AssetName`
+
+  * `GroupName`**或**`GroupDescription`**被审核拦截时，Group会创建失败**
+
+  * 创建完��支�修改上述字段
+
+![资产组�标题��述修改 (Token: CpDGb1DkHoT0H7xymYXl0fl5gci)](images/CpDGb1DkHoT0H7xymYXl0fl5gci.png)
+
+![资产�称修改 (Token: FGx3bIe8toKJVixJekllAYmXgsc)](images/FGx3bIe8toKJVixJekllAYmXgsc.png)
+
+
+
+* **批�新增素�**：�点击进入�个资产组�（Group），在当�资产组�（Group）下新增资产（Asset）
+
+![点击�一Group进入详情 (Token: J2bibWD6SoH170xehXWler3ugrg)](images/J2bibWD6SoH170xehXWler3ugrg.png)
+
+![Image Token: NfxBbdQa9oXQpWxT1GoljirmgXe](images/NfxBbdQa9oXQpWxT1GoljirmgXe.png)
+
+![点击�上角�添加素�资产】上传Asset (Token: CsgQbFnXOoTJACx2TeZlrQlHgrd)](images/CsgQbFnXOoTJACx2TeZlrQlHgrd.png)
+
+* �次新增素�上�为**500个资产**，�账��许的资产（Asset）数�本期**�设�**
+
+* �个素�上传�求：
+
+> - **图片格�**：控制�本期仅支�文件�缀为`.jpg`�`.jpeg`�`.png`（与API有差异）
+>
+> - **文件大�**：�张图片�于30M
+>
+> - **宽高比（宽/高）**：(0.4, 2.5)
+>
+> - **宽高长度（px）**：(300, 6000)
+
+* 文件�会自动解�填入AssetName
+
+| **资产�称（Asset Name）** | 必填，最大字符12（与API有差异） |
+| -------------------- | ------------------ |
+
+* **文件内容或**`AssetName`**被审核拦截时，Asset列表会展示失败状�，有对应报错信�。**
+
+![报错示� (Token: Bt9Vbf3ajohV07xVrK1lYKe2gOc)](images/Bt9Vbf3ajohV07xVrK1lYKe2gOc.png)
+
+
+
+* **库内资产使用**：�在体验中心界�查看已上传的资产组�（Group）和对应组�下的资产（Asset），一键填入体验中心输入框，或一键�制URI通过API传入
+
+![Image Token: Cv3AbbvFHoQuTcxacZclfNfggRc](images/Cv3AbbvFHoQuTcxacZclfNfggRc.png)
+
+![Image Token: DuDib9l3Ao8NsTx8E0Fl9eQEglb](images/DuDib9l3Ao8NsTx8E0Fl9eQEglb.png)
+
+![体验中心使用�程示� (Token: YdKqbTI8fojMc5xAqAElrdOggff)](images/YdKqbTI8fojMc5xAqAElrdOggff.png)
+
+
+
+## 2.2 API入库&#x20;
+
+1. **首次使用签署使用承诺函**：通过�山方舟控制�开通管�，点击�上角的�开通素�资产库��】，勾选���议，进行功能开通使用
+
+![Image Token: Vvu2bZwhGoTs8MxPc9jlB1rigjh](images/Vvu2bZwhGoTs8MxPc9jlB1rigjh.png)
+
+
+
+* **通过Asset API创建�管�素�资产：**
+
+  > **�对客�料】**
+  >
+  > * **素�资产库实践手册：**[ �申请��填客户�称】�域虚拟人�素�资产库（邀测用户版）](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe)
+  >
+  > * **Asset API文档：**[ �申请��填客户�称】Asset API �考文档（邀测用户版）](https://bytedance.larkoffice.com/wiki/FtqVwjinYisraGkT5uncWyd0nEb)
diff --git a/docs/API文档/「�密信���申请��填客户�称】�域虚拟人�素�资产库使用指�（邀测用户版）.md b/docs/API文档/「�密信���申请��填客户�称】�域虚拟人�素�资产库使用指�（邀测用户版）.md
new file mode 100644
index 0000000..4ec7452
--- /dev/null
+++ b/docs/API文档/「�密信���申请��填客户�称】�域虚拟人�素�资产库使用指�（邀测用户版）.md
@@ -0,0 +1,314 @@
+# 「⚠��密信���申请��填客户�称】�域虚拟人�素�资产库使用指�（邀测用户版）
+
+> 本文档仅�预览�邀测用户使用：
+>
+> * �承诺正� API 上线100%一致。
+>
+> * 仅�邀测用户阅读，请勿截图/分享给其他人员。
+>
+> * 您需确�上传的虚拟人�符�以下�件：
+>
+>   * 您�法拥有该素�，并享有完整的使用�处分��。素��包�未获授�的第三方商标�标识类内容。
+>
+>   * 素��得与任何自然人肖�或形象雷�，素��存在抄袭�盗用情形，�会侵害任何第三方的人格��知识产�等�法�益。
+>
+>   * 素��包���法规��背公�良俗��害国家安全的内容。
+
+Seedance 2.0 系列模型具有完备的防范 Deepfake 和侵犯版�风险能力。在生�视频时，会对有风险的�考素�输入进行拦截，最大�度��生�视频�规和安全性。
+
+为确�创作者能充分利用 Seedance 2.0 强大的视频生�能力高效生�视频内容，�时规� AI 生�内容的潜在风险，方舟推出了�域�信素�库。完�入库的�信素�将进入您的�域素�库，在视频生�中使用。
+
+�域素�库使用�程如下：
+
+![Image Token: CWyVbkJYSoxmeExAhjCcYDOOnPe](images/CWyVbkJYSoxmeExAhjCcYDOOnPe.png)
+
+## 素�资产库结构说明
+
+> �个素�文件为一个 Asset（素�资产），�个 Asset 属于一个 Group（素�组�）。
+>
+> * �使用素�组自由管�素�。例如，�将�一人物�工作室或项目组的素�放入一个素�组�进行管�。
+>
+> * **仅�使用已入库素�的 ID (Asset ID)进行视频生�，�一形象未入库素�无法使用。**
+>
+> * 仅需入库推�需使用的素�，�需使用的素�请勿入库。
+
+以�人物形象为一素�组�为例：
+
+* 素�资产：一个素�文件（图片），是方舟 Seedance 2.0 系列模型�直接用于推�的�信资产。
+
+  * 举例：一张人物装造。
+
+  * 文件类型：图片
+
+  > **�张图片�求**
+  >
+  > * 格�：jpeg�png�webp�bmp�tiff�gif�heic/heif
+  >
+  > * 宽高比（宽/高）： (0.4, 2.5)&#x20;
+  >
+  > * 宽高长度（px）：(300, 6000)
+  >
+  > * 大�：�张图片�于 30 MB。
+
+  * 资产 ID 示例：`asset-20260310035119-h8tq4`
+
+![Image Token: NfNnbPdRUoLmRdxjoIUcwMvOnAf](images/NfNnbPdRUoLmRdxjoIUcwMvOnAf.png)
+
+* 素�资产组：
+
+  * �自由组�素�，以人物�工作室�项目组等维度将素�进行分组管�。
+
+  * Group ID 示例：`group-20260310035119-*****`
+
+  * 示例：
+
+![Image Token: E58BbrAcoo1E68xdZPecGDQgn1c](images/E58BbrAcoo1E68xdZPecGDQgn1c.jpeg)
+
+![Image Token: YX14bprrpoxvgXxHoABczW8EnNb](images/YX14bprrpoxvgXxHoABczW8EnNb.jpeg)
+
+![Image Token: YoLEbaqR6oic3mx2Ow6cQ1j2nnf](images/YoLEbaqR6oic3mx2Ow6cQ1j2nnf.jpeg)
+
+
+
+## 上传素�至�域虚拟人�库 （API & 控制�）
+
+您�将自有的虚拟形象上传至�域虚拟人�库。
+
+> **警告：**
+>
+> 您需确�上传的虚拟人�符�以下�件：
+>
+> * 您�法拥有该素�，并享有完整的使用�处分��。素��包�未获授�的第三方商标�标识类内容。
+>
+> * 素��得与任何自然人肖�或形象雷�，素��存在抄袭�盗用情形，�会侵害任何第三方的人格��知识产�等�法�益。
+>
+> * 素��包���法规��背公�良俗��害国家安全的内容。
+
+方舟将对您上传的素�进行安全审核。审核通过�，��在体验中心和 API 中使用素�生�视频。
+
+您�使用 OpenAPI 或在体验中心上传虚拟素�。
+
+### 阅读并���议
+
+首次入库�，需打开 [控制�](https://console.volcengine.com/ark/region:ark+cn-beijing/overview?briefPage=0\&briefType=introduce\&type=new) > **开通管�** > **开通素�资产库��，**&#x9605;读和��相关规则和�议：
+
+![Image Token: ZR4SbE6GColaYKxVTFZcSW1LnFc](images/ZR4SbE6GColaYKxVTFZcSW1LnFc.png)
+
+先创建 Asset Group, �� Group 中添加虚拟人�素�。
+
+> 素�格�的具体�求，请�考[素�库结构说明](https://bytedance.larkoffice.com/docx/MpHOdxYbwobmIWxk5rucBLranJb#share-V4mMdM92woylBlxML62c5Aelneh)。
+
+### 使用控制�
+
+1. 打开 [方舟控制�](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128\&tab=GenVideo) > **我的素�资产** > **我的虚拟人� > 添加虚拟人�**，或左上方 **我的资产**。
+
+   ![Image Token: VolnbkTKkoQ81kxcksWc3Ts6nDf](images/VolnbkTKkoQ81kxcksWc3Ts6nDf.png)
+
+   ![Image Token: R5wRbFyexonHeRxbIK1cs3ScnAd](images/R5wRbFyexonHeRxbIK1cs3ScnAd.png)
+
+
+
+2. 创建素�组�。
+
+3. �素�组�中上传素�。
+
+### 使用 API
+
+先使用 `CreateAssetGroup` API 创建素�组�，�使用 `CreateAsset` API �组�中上传素�。请求示例：
+
+1. **创建素�组�**
+
+> **注�**：
+>
+> * 调用素�资产（Assets）API 接�需使用 Access Key 鉴�，详情�考 [API访问密钥管�](https://www.volcengine.com/docs/6257/64983?lang=zh)。
+>
+> * API �数信�请�考[ Asset API �考 （WIP） 副本](https://bytedance.larkoffice.com/wiki/FtqVwjinYisraGkT5uncWyd0nEb)。
+
+使&#x7528;**&#x20;POST` `**`CreateAssetGroup` 接�创建素�组�。
+
+在请求中传入：
+
+* **Name**：素�组�的�称。
+
+* **Description**: 素�组�的文字�述。
+
+* **GroupType**:  选填，默认为 AIGC（虚拟人�素�）。
+
+* **ProjectName**：选填，指定资�项目�称，默认为 default。一个项目中的资�仅�被该项目下的推�接入点使用，获�项目�称请�考[文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+> **注�**
+>
+> 如果请求中�指定 **ProjectName**，默认将创建素�组至 **default** 项目中。
+
+请求示例：
+
+**注�**：需使用 AK/SK 鉴�，详情�考 [API访问密钥管�](https://www.volcengine.com/docs/6257/64983?lang=zh)。
+
+返回示例：
+
+* **上传素�**
+
+使用 **POST&#x20;**`CreateAsset`接�上传素�。
+
+在请求中�供：
+
+* **GroupId**：必填，素�组� ID
+
+* **URL**: 必填，图片�访问的 URL
+
+* **AssetType**: 必填，仅支�上传图片类型素�，需指定为 **Image**
+
+* **Name**: 选填，素��称，�用于管�素�，如素�文件�。
+
+* **ProjectName**：选填，指定资�项目�称，默认为 **default**。一个项目中的资�仅�被该项目下的推�接入点使用，获�项目�称请�考[文档](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)。
+
+> **注�**
+>
+> 如果请求中�指定 **ProjectName**，则默认上传素�至 **default** 项目中。您需使用该字段确�将素�上传至对应的项目中。
+
+**注�**：
+
+* �次请求上传一个素�文件。
+
+* 该请求返回素� ID，�使用 GetAsset API 查看是�上传�功。
+
+返回示例：
+
+## 检索虚拟人�资产 （API & 控制�）
+
+您�使用以下方�检索虚拟人�资产。
+
+* **控制�**：您�在 [方舟控制�](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128\&tab=GenVideo) >**&#x20;我的** > **我的虚拟人�&#x20;**&#x4E2D;�索和查看已上传的虚拟人�资产。
+
+* **API**：
+
+  * **POST&#x20;**`GetAsset `获��个素�
+
+  * **POST&#x20;**`ListAssets` 查询素�
+
+  * **POST&#x20;**`ListAssetGroups` 查询素�组�信�
+
+
+
+### 获��个素�信�
+
+�使用 **POST&#x20;**&#x47;etAsset 获��个素�信�，指定素�资产 ID。
+
+> **注�**：�获�完整的 API �数���等信�，请查看[ Asset API �考 （WIP） 副本](https://bytedance.larkoffice.com/docx/DZdUd9J3lo6JTGxDrjscv1g9nVg)。
+
+返回示例：
+
+### 查询素�资产
+
+�使用 **POST&#x20;**&#x4C;istAssets 查询 Assets。
+
+* 支�根�组� ID (GroupId)�素�状�（Statuses）和素��称（Name）查询。筛选出符�所有�件的素�。
+
+* 支�使用 Name 进行模糊�索，�时使用 GroupId 精确�索，便于检索所需的素�。
+
+支�使用 SortBy，SortOrder 对结果进行排�
+
+> **注�**：获�完整的 API �考文档，请查看[ Asset API �考 （WIP） 副本](https://bytedance.larkoffice.com/docx/DZdUd9J3lo6JTGxDrjscv1g9nVg)。
+
+返回示例：
+
+### 查询素�组
+
+使用 **POST&#x20;**&#x4C;istAssetGroups 查询素�组�信�。
+
+支�模糊�索素�组��称（Name）或�供多个素�组�（GroupId）。
+
+如有多个素�组，�使用 Name 字段进行模糊�索。
+
+> **注�**：�获�完整的 API �考文档，请查看[ Asset API �考 （WIP） 副本](https://bytedance.larkoffice.com/docx/DZdUd9J3lo6JTGxDrjscv1g9nVg)。
+
+返回示例：
+
+## 示例：上传素�并使用 GetAsset 获�素�信�
+
+以下示例创建素�资产�，查询资产 Status 并根�状�，判断是�继续查询或返回对应结果。
+
+代�执行以下逻辑：
+
+1. createAsset： 上传资�，获� AssetId
+
+2. waitForAssetActive：开始查询，循环调用 getAssetStatus 查询当�资产状�
+
+3. 根� Status 判断
+
+   * Processing → 继续轮询
+
+   * Active → 返回 URL（结�）状�为 **Active** �，�使用该素� Asset ID (URI格�) 进行视频生�，如何使用人�素�生�视频，详�[下文](https://bytedance.larkoffice.com/wiki/RtHgwpJgviwFXLkQ9hLcRooEnVe#share-GrbXdVvYjonbMkxQWHEcGf2Inlf)。
+
+   * Failed → 返回错误（结�）
+
+4. 返回结果并打�结果
+
+查询结果示�如下：
+
+
+
+## 使用人�素�生�视频
+
+在获�素� Asset ID�，�使用�域人�素�生�视频。效果预览�使用方�请�考下文。
+
+### 效果预览
+
+| 输入：文本                                                                                                                              | 输入：虚拟人��图片                                                                                                                                                              | 输出 |
+| ---------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- |
+| **图片1**中美妆�主用中文进行介�，妆容改为明艳大气，去掉脸部�光，笑容甜美，近景镜头，手�**图片2**的�霜��镜头展示，清新简约背景，元气甜美风格。�主��：挖到本命�霜了�质地�云朵一样软糯，一抹就�收，熬夜急救�补水�湿全�定，素颜都自带柔光感。 | ![Image Token: HX4abuktdoOdZgxrqbxcNBlznSh](images/HX4abuktdoOdZgxrqbxcNBlznSh.png)![Image Token: MHRTb8420oORTqxTohYcrFkRnhc](images/MHRTb8420oORTqxTohYcrFkRnhc.jpeg) |    |
+
+### 视频生�
+
+在 Video Generation API 的 **content.<模�>\_url.url** 字段中使用 素� URI 生�视频。
+
+> 资产 URI 拼接方�：`Asset://<asset_ID`**`>`**
+
+具体方�请�考[ �申请��填客户�称】Seedance 2.0 & 2.0 fast API文档（邀测用户版）](https://bytedance.larkoffice.com/wiki/SANpwJ9bgiKgrykLaMTcAB0InWc#share-ONSwd51ezoXCJqxkAm2cIC61nMX)。
+
+示例代�：
+
+## 常�问题
+
+### 1. 为什么素�上传�功�，无法使用素�生�视频或获�素�信�？
+
+素�库&#x6309;**[项目](https://www.volcengine.com/docs/82379/1359411?lang=zh#03ec4a65)（Project）隔离**。
+
+* 在视频生�时，必须使用**素�所在项目**中的推�接入点进行推�。
+
+* 如果素�上传�功，但使用获�素�接�获�素�失败，�能是因为调用上传素�(CreateAsset)和获�素�接�时传入了��的 **ProjectName**。
+
+  * **ProjectName** 默认值为 `default`，�如果�指定该字段，则默认将资�创建至 `default` 项目中。
+
+  * 建议在�一个项目中管�素�。
+
+### 2. 怎样管�用户对素�库的��？
+
+您�使用[访问控制](https://console.volcengine.com/iam/identitymanage/user) （IAM）精细化管�用户�作素�库的��。�按以下方�设置：
+
+1. **创建自定义策略**
+
+   1. 打开[访问控制](https://console.volcengine.com/iam/policymanage) >**&#x20;新建自定义策略**
+
+   2. 输入策略�称。
+
+   3. 切�到 **JSON编辑器**，将下方自定义策略粘贴至编辑器中，点击 **�交** �存。
+
+![Image Token: F0bnb6AanolkCVxjbTdcKMOenkh](images/F0bnb6AanolkCVxjbTdcKMOenkh.png)
+
+* **为用户/用户组赋�**
+
+  1. 点击 **用户管�** > **用户**/**用户组**，选择需�赋�的用户或用户组，点击�侧的 **添加��。**
+
+  2. 在 **授�策略** 中选择**步骤 1** 中创建的策略。
+
+  3. （�选）在 **�制到项目资�&#x20;**&#x4E2D;选择策略应用的项目。
+
+  4. 点击 **�交。**
+
+完�上述�作�，该用户/用户组��在对应项目中管�素�。
+
+关于 IAM 的更多信�，请�考[访问控制](http://volcengine.com/docs/6257?lang=zh)。
+
+
+
diff --git a/docs/API文档/关于��值.md b/docs/API文档/关于��值.md
new file mode 100644
index 0000000..2951acd
--- /dev/null
+++ b/docs/API文档/关于��值.md
@@ -0,0 +1,487 @@
+`POST https://ark.cn-beijing.volces.com/api/v3/contents/generations/tasks`   [ ](https://api.volcengine.com/api-explorer/?action=CreateContentsGenerationsTasks&data=%7B%7D&groupName=%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90API&query=%7B%7D&serviceCode=ark&version=2024-01-01)[�行](https://api.volcengine.com/api-explorer/?action=CreateContentsGenerationsTasks&data=%7B%7D&groupName=%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90API&query=%7B%7D&serviceCode=ark&version=2024-01-01)
+本文介�创建视频生�任务 API 的输入输出�数，供您使用接�时查阅字段�义。模型会��传入的图片�文本信�生�视频，待生�完��，您�以按�件查询任务并获�生�的视频。
+:::warning
+Seedance 2.0 模型目�仅支� [控制�体验中心](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision?modelId=doubao-seedance-2-0-260128&tab=GenVideo) 在�费�度内体验，暂�支� API 调用，敬请期待。
+
+:::
+**��模型支�的视频生�能力简介**
+
+* **Seedance 1.5 pro==^new^==** ** ** **==^有声视频^==** **(自定义是�包�音频)** 
+   * 图生视频\-首尾帧，根�您输入的++首帧图片+尾帧图片+文本�示�（�选）+�数（�选）++ 生�目标视频。
+   * 图生视频\-首帧，根�您输入的++首帧图片+文本�示�（�选）+�数（�选）++ 生�目标视频。
+   * 文生视频，根�您输入的++文本�示�+�数（�选）++ 生�目标视频。
+* **Seedance 1.0 pro**
+   * 图生视频\-首尾帧，根�您输入的++首帧图片+尾帧图片+文本�示�（�选）+�数（�选）++ 生�目标视频。
+   * 图生视频\-首帧，根�您输入的++首帧图片+文本�示�（�选）+�数（�选）++ 生�目标视频。
+   * 文生视频，根�您输入的++文本�示�+�数（�选）++ 生�目标视频。
+* **Seedance 1.0 pro fast**
+   * 图生视频\-首帧，根�您输入的++首帧图片+文本�示�（�选）+�数（�选）++ 生�目标视频。
+   * 文生视频，根�您输入的++文本�示�+�数（�选）++ 生�目标视频。
+* **Seedance 1.0 lite**
+   * **doubao\-seedance\-1\-0\-lite\-t2v：** 文生视频，根�您输入的++文本�示�+�数（�选）++ 生�目标视频。
+   * **doubao\-seedance\-1\-0\-lite\-i2v：** 
+      * 图生视频\-�考图，根�您输入的**++�考图片（1\-4张）++ **  +++文本�示�（�选）+ �数（�选）++ 生�目标视频。
+      * 图生视频\-首尾帧，根�您输入的++首帧图片+尾帧图片+文本�示�（�选）+�数（�选）++ 生�目标视频。
+      * 图生视频\-首帧，根�您输入的++首帧图片+文本�示�（�选）+�数（�选）++ 生�目标视频。
+
+
+Tips：一键展开折�，快速检索内容
+打开页��上角开关，**ctrl ** + **f** �检索页�内所有内容。
+<span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_cae7ddb0e1977b68b353f17897b8574c.png) </span>
+
+
+```mixin-react
+return (<Tabs>
+<Tabs.TabPane title="在线调试" key="cKmdyIjR"><RenderMd content={`<APILink link="https://api.volcengine.com/api-explorer/?action=CreateContentsGenerationsTasks&data=%7B%7D&groupName=%E8%A7%86%E9%A2%91%E7%94%9F%E6%88%90API&query=%7B%7D&serviceCode=ark&version=2024-01-01" description="API Explorer 您�以通过 API Explorer 在线�起调用，无需关注签�生�过程，快速获�调用结果。"></APILink>
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="鉴�说明" key="vRJT6oJZ"><RenderMd content={`本接�仅支� API Key 鉴�，请在 [获� API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey) 页�，获�长效 API Key。
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="快速入�" key="MlbBRTbjal"><RenderMd content={` [ ](#)[体验中心](https://console.volcengine.com/ark/region:ark+cn-beijing/experience/vision)       <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_2abecd05ca2779567c6d32f0ddc7874d.png =20x) </span>[模型列表](https://www.volcengine.com/docs/82379/1330310?lang=zh#2705b333)       <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_a5fdd3028d35cc512a10bd71b982b6eb.png =20x) </span>[模型计费](https://www.volcengine.com/docs/82379/1544106?redirect=1&lang=zh#02affcb8)       <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_afbcf38bdec05c05089d5de5c3fd8fc8.png =20x) </span>[API Key](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey?apikey=%7B%7D)
+ <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_57d0bca8e0d122ab1191b40101b5df75.png =20x) </span>[调用教程](https://www.volcengine.com/docs/82379/1366799)       <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_f45b5cd5863d1eed3bc3c81b9af54407.png =20x) </span>[接�文档](https://www.volcengine.com/docs/82379/1520758)       <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_1609c71a747f84df24be1e6421ce58f0.png =20x) </span>[常�问题](https://www.volcengine.com/docs/82379/1359411)       <span>![图片](https://portal.volccdn.com/obj/volcfe/cloud-universal-doc/upload_bef4bc3de3535ee19d0c5d6c37b0ffdd.png =20x) </span>[开通模型](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)
+`}></RenderMd></Tabs.TabPane></Tabs>);
+```
+
+
+---
+
+
+<span id="RxN8G2nH"></span>
+## 请求�数 
+> 跳转 [�应�数](#y2hhTyHB)
+
+<span id="BJ5XLFqM"></span>
+### 请求体
+
+---
+
+
+**model** `string` %%require%%
+您需�调用的模型的 ID （Model ID），[开通模型�务](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement?LLM=%7B%7D&OpenTokenDrawer=false)，并[查询 Model ID](https://www.volcengine.com/docs/82379/1330310) 。
+您也�通过 Endpoint ID �调用模型，获得���计费类型（�付费/�付费）��行状�查询�监控�安全等高级能力，��考[获� Endpoint ID](https://www.volcengine.com/docs/82379/1099522)。
+
+---
+
+
+**content** `object[]` %%require%%
+输入给模型，生�视频的信�，支�文本�图片和视频（样片，Draft 视频）格�。支�以下几�组�：
+
+* 文本
+* 文本+图片
+* 视频：其中视频指已�功生�的样片视频，模型�基于样片生�高质�正�视频。
+
+
+信�类型
+
+---
+
+
+**文本信�** `object`
+输入给模型生�视频的内容，文本内容部分。
+
+属性
+
+---
+
+
+content.**type ** `string` %%require%%
+输入内容的类型，此处应为 `text`。
+
+---
+
+
+content.**text ** `string` %%require%%
+输入给模型的文本�示�，�述期望生�的视频。
+支�中英文。建议中文�超过500字，英文�超过1000�。字数过多信�容易分散，模型�能因此忽略细节，�关注�点，造�视频缺失部分元素。�示�的更多使用技巧请�� [Seedance �示�指�](https://www.volcengine.com/docs/82379/1587797)。
+
+
+---
+
+
+**图片信�** `object`
+输入给模型生�视频的内容，图片信�部分。
+
+属性
+
+---
+
+
+content.**type ** `string` %%require%%
+输入内容的类型，此处应为 `image_url`。支�图片URL或图片 Base64 编�。
+
+---
+
+
+content.**image_url ** `object` %%require%%
+输入给模型的图片对象。
+
+属性
+
+---
+
+
+content.image_url.**url ** `string` %%require%%
+图片信�，�以是图片URL或图片 Base64 编�。
+
+* 图片URL：请确�图片URL�被访问。
+* Base64编�：请�循此格�`data:image/<图片格�>;base64,<Base64编�>`，注� `<图片格�>` 需�写，如 `data:image/png;base64,{base64_image}`。
+
+:::tip
+传入图片需�满足以下�件：
+
+* 图片格�：jpeg�png�webp�bmp�tiff�gif。其中，Seedance 1.5 pro 新增支� heic 和 heif。
+* 宽高比（宽/高）： (0.4, 2.5) 
+* 宽高长度（px）：(300, 6000)
+* 大�：�于 30 MB
+
+:::
+
+---
+
+
+content.**role ** `string` `�件必填`
+图片的�置或用途。
+:::warning
+首帧图生视频�首尾帧图生视频��考图生视频为 3 �互斥的场景，�支�混用。
+
+:::
+图生视频\-首帧
+
+* **支�模型：** 所有图生视频模型
+* **字段role�值：** 需�传入1个image_url对象，且字段role��填，或字段role为：first_frame
+
+
+图生视频\-首尾帧
+
+* **支�模型：** Seedance 1.5 pro�Seedance 1.0 pro�Seedance 1.0 lite i2v 
+* **字段role�值：** 需�传入2个image_url对象，且字段role必填。
+   * 首帧图片对应的字段role为：first_frame
+   * 尾帧图片对应的字段role为：last_frame
+
+:::tip
+传入的首尾帧图片�相�。首尾帧图片的宽高比�一致时，以首帧图片为主，尾帧图片会自动�剪适�。
+
+:::
+
+图生视频\-�考图
+
+* **支�模型：** Seedance 1.0 lite i2v
+* **字段role�值：** 需�传入1～4个image_url对象，且字段role必填。
+   * �张�考图片对应的字段role�为：reference_image
+
+:::tip
+�考图生视频功能的文本�示�，�以用自然语言指定多张图片的组�。但若想有更好的指令�循效果，**推�使用“[图1]xxx，[图2]xxx�的方��指定图片**。
+示例1：戴�眼镜穿��色T�的男生和柯基�狗，�在��上，3D�通风格
+示例2：[图1]戴�眼镜穿��色T�的男生和[图2]的柯基�狗，�在[图3]的��上，3D�通风格
+
+:::
+
+
+---
+
+
+**样片信�==^new^==** ** **  `object`
+基于样片任务 ID，生�正�视频。仅 Seedance 1.5 pro 支�该功能。[阅读](https://www.volcengine.com/docs/82379/1366799?lang=zh#5acd28c8)[文档](https://www.volcengine.com/docs/82379/1366799?lang=zh#5acd28c8) 获� draft 功能的使用教程和注�事项。
+
+属性
+
+---
+
+
+content.**type ** `string` %%require%%
+输入内容的类型，此处应为 `draft_task`。
+
+---
+
+
+content.**draft_task** ** ** `object` %%require%%
+输入给模型的样片任务。
+
+属性
+
+---
+
+
+content.draft_task.**id ** `string` %%require%%
+样片任务 ID。平�将自动�用 Draft 视频使用的用户输入（**model�** content.**text�** content.**image_url�generate_audio�seed�ratio�duration�camera_fixed ** ），生�正�视频。其余�数支�指定，�指定将使用本模型的默认值。
+使用分为两步：Step1: 调用本接�生� Draft 视频。Step2: 如果确认 Draft 视频符�预期，�基于 Step1 返回的 Draft 视频任务 ID，调用本接�生�最终视频。[阅读文档](https://www.volcengine.com/docs/82379/1366799?lang=zh#5acd28c8) 获�详细教程。
+
+
+
+
+---
+
+
+**callback_url** `string` 
+填写本次生�任务结果的回调通知地�。当视频生�任务有状��化时，方舟将�此地�推� POST 请求。
+回调请求内容结构与[查询任务API](https://www.volcengine.com/docs/82379/1521309)的返回体一致。
+回调返回的 status 包括以下状�：
+
+* queued：排队中。
+* running：任务�行中。
+* succeeded： 任务�功。（如��失败，�5秒内没有接收到�功��的信�，回调三次）
+* failed：任务失败。（如��失败，�5秒内没有接收到�功��的信�，回调三次）
+* expired：任务超时，�任务处于**�行中或排队中**状�超过过期时间。�通过 **execution_expires_after ** 字段设置过期时间。
+
+
+---
+
+
+**return_last_frame** `boolean` `默认值 false`
+
+* true：返回生�视频的尾帧图�。设置为 `true` �，�通过 [查询视频生�任务接�](https://www.volcengine.com/docs/82379/1521309) 获�视频的尾帧图�。尾帧图�的格�为 png，宽高�素值与生�的视频��一致，无水�。
+   使用该�数�实现生�多个连续视频：以上一个生�视频的尾帧作为下一个视频任务的首帧，快速生�多个连续视频，调用示例详� [教程](https://www.volcengine.com/docs/82379/1366799?lang=zh#141cf7fa)。
+* false：�返回生�视频的尾帧图�。
+
+
+---
+
+
+**service_tier** `string` `默认值 default`
+> �支�修改已�交任务的�务等级
+
+指定处�本次请求的�务等级类型，枚举值：
+
+* default：在线推�模�，RPM 和并�数��较低（详� [模型列表](https://www.volcengine.com/docs/82379/1330310?lang=zh#2705b333)），适�对推�时效性�求较高的场景。
+* flex：离线推�模�，TPD ��更高（详� [模型列表](https://www.volcengine.com/docs/82379/1330310?lang=zh#2705b333)），价格为在线推�的 50%， 适�对推�时延�求�高的场景。
+
+
+---
+
+
+**execution_expires_after** ** ** `integer` `默认值 172800`
+任务超时阈值。指定任务�交�的过期时间（��：秒），从 **created at** 时间戳开始计算。默认值 172800 秒，� 48 �时。�值范围：[3600，259200]。
+�论使用哪� **service_tier**，都建议根�业务场景设置�适的超时时间。超过该时间�任务会被自动终止，并标记为`expired`状�。
+
+---
+
+
+**generate_audio==^new^==** ** ** `boolean` `默认值 true`
+> 仅 Seedance 1.5 pro 支�
+
+控制生�的视频是�包�与画��步的声音。
+
+* true：模型输出的视频包��步音频。Seedance 1.5 pro 能够基于文本�示�与视觉内容，自动生�与之匹�的人声�音效�背景音�。建议将对�部分置于�引�内，以优化音频生�效果。例如：男人��女人说：“你记�，以���以用手指指月亮。�
+* false：模型输出的视频为无声视频。
+
+
+---
+
+
+**draft==^new^==** ** ** `boolean` `默认值 false`
+> 仅 Seedance 1.5 pro 支�
+
+控制是�开�样片模�。[阅读文档](https://www.volcengine.com/docs/82379/1366799?lang=zh#5acd28c8) 获�使用教程和注�事项。
+
+* true：开�样片模�，生�一段预览视频，快速验�场景结构�镜头调度�主体动作与 prompt �图是�符�预期。消耗 token 数较正常视频更少，使用�本更低。
+* false：关闭样片模�，正常生�一段视频。
+
+:::tip
+开�样片模��，将使用 480p 分辨率生� Draft 视频（使用其他分辨率会报错），�支�返回尾帧功能，�支�离线推�功能。
+
+:::
+---
+
+
+:::warning 部分�数�级说明
+
+* **对于 resolution�ratio�duration�frames�seed�camera_fixed�watermark �数，平��级了�数传入方�，示例如下。Seedance 1.0\-1.5 系列模型�然兼容支�旧方�。** 
+* ��模型，�能对应支���的�数与�值，详� [输出视频格�](https://www.volcengine.com/docs/82379/1366799?lang=zh#9fe4cce0)。当输入的�数或�值�符�所选的模型时，该�数将被忽略或触�报错：
+   * 新方�：在 request body 中直接传入�数。此方�为**强校验，** 若�数填写错误，模型会返回错误�示。 
+   * 旧方�：在文本�示��追加 \-\-[parameters]。此方�为**弱校验，** 若�数填写错误，模型将自动使用默认值且�会报错。
+
+
+:::
+**新方�（推�）：在 request body 中直接传入�数**
+```JSON
+... 
+   // Specify the aspect ratio of the generated video as 16:9, duration as 5 seconds, resolution as 720p, seed as 11, and include a watermark. The camera is not fixed. 
+    "model": "doubao-seedance-1-5-pro-251215", 
+    "content": [ 
+        { 
+            "type": "text", 
+            "text": "�猫对�镜头打哈欠" 
+        } 
+    ], 
+    // All parameters must be written in full; abbreviations are not supported 
+    "resolution": "720p", 
+    "ratio":"16:9", 
+    "duration": 5, 
+    // "frames": 29, Either duration or frames is required 
+    "seed": 11, 
+    "camera_fixed": false, 
+    "watermark": true 
+... 
+```
+
+
+
+
+**旧方�：在文本�示��追加 \-\-[parameters]** 
+```JSON
+... 
+   // Specify the aspect ratio of the generated video as 16:9, duration as 5 seconds, resolution as 720p, seed as 11, and include a watermark. The camera is not fixed. 
+    "model": "doubao-seedance-1-5-pro-251215", 
+    "content": [ 
+        { 
+            "type": "text", 
+            "text": "�猫对�镜头打哈欠 --rs 720p --rt 16:9 --dur 5 --seed 11 --cf false --wm true"
+            // "text": "�猫对�镜头打哈欠 --resolution 720p --ratio 16:9 --duration 5 --seed 11 --camerafixed false --watermark true"
+        } 
+    ]
+... 
+```
+
+
+
+
+---
+
+
+**resolution **  `string` 
+> Seedance 1.5 pro�Seedance 1.0 lite 默认值：`720p`
+> Seedance 1.0 pro & pro\-fast 默认值：`1080p`
+
+视频分辨率，枚举值：
+
+* 480p
+* 720p
+* 1080p：�考图场景�支�
+
+
+---
+
+
+**ratio ** `string` 
+> 文生视频：默认值 `16:9`（ Seedance 1.5 Pro 默认值为 `adaptive`）
+> 图生视频：默认值 `adaptive`（�考图生视频场景默认值为 `16:9`）
+
+生�视频的宽高比例。��宽高比对应的宽高�素值�下方表格。
+
+* 16:9 
+* 4:3
+* 1:1
+* 3:4
+* 9:16
+* 21:9
+* adaptive：根�输入自动选择最�适的宽高比（详�下文说明）
+
+:::warning **adaptive ** 适�规则
+当�置 **ratio** 为 `adaptive` 时，模型会根�生�场景自动适�宽高比；实际生�的视频宽高比�通过 [查询视频生�任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 **ratio** 字段获�。
+
+* 文生视频场景：根�输入的�示�，自动选择最�适的宽高比（仅 Seedance 1.5 Pro 支�）。
+* 图生视频场景：
+   * �考图生视频：�支��置 **ratio** 为 `adaptive`。
+   * 首帧 / 首尾帧生视频：根�上传的首帧图片比例，自动选择最�适的宽高比。
+
+
+:::
+**��宽高比对应的宽高�素值**
+Note：图生视频，选择的宽高比与您上传的图片宽高比�一致时，方舟会对您的图片进行�剪，�剪时会居中�剪，详细规则� [图片�剪规则](https://www.volcengine.com/docs/82379/1366799?lang=zh#f76aafc8)。
+
+|分辨率 |宽高比|宽高�素值|宽高�素值|\
+| | |Seedance 1.0 系列 |Seedance 1.5 pro |
+|---|---|---|---|
+|480p |16:9 |864×480 |864×496 |
+|^^|4:3 |736×544 |752×560 |
+|^^|1:1 |640×640 |640×640 |
+|^^|3:4 |544×736 |560×752 |
+|^^|9:16 |480×864 |496×864 |
+|^^|21:9 |960×416 |992×432 |
+|720p |16:9 |1248×704 |1280×720 |
+|^^|4:3 |1120×832 |1112×834 |
+|^^|1:1 |960×960 |960×960 |
+|^^|3:4 |832×1120 |834×1112 |
+|^^|9:16 |704×1248 |720×1280 |
+|^^|21:9 |1504×640 |1470×630 |
+|1080p |16:9 |1920×1088 |1920×1080 |\
+|> 1.0 lite �考图场景�支� | | | |
+|^^|4:3 |1664×1248 |1664×1248 |
+|^^|1:1 |1440×1440 |1440×1440 |
+|^^|3:4 |1248×1664 |1248×1664 |
+|^^|9:16 |1088×1920 |1080×1920 |
+|^^|21:9 |2176×928 |2206×946 |
+
+
+
+
+---
+
+
+**duration** `integer` `默认值 5` 
+> duration 和 frames 二选一��，frames 的优先级高于 duration。如果您希望生�整数秒的视频，建议指定 duration。
+
+生�视频时长，��：秒。支� 2~12 秒。
+:::warning
+Seedance 1.5 pro 支�两��置方法
+
+   * 指定具体时长：支� [4,12] 范围内的任一整数。
+   * �指定具体生�时长：设置为 `-1`，表示由模型在 [4,12] 范围内自主选择�适的视频长度（整数秒）。实际生�视频的时长�通过 [查询视频生�任务 API](https://www.volcengine.com/docs/82379/1521309?lang=zh) 返回的 **duration** 字段获�。注�视频时长与计费相关，请谨慎设置。
+
+
+:::
+---
+
+
+**frames** `integer` 
+> Seedance 1.5 pro 暂�支�
+> duration 和 frames 二选一��，frames 的优先级高于 duration。如果您希望生��数秒的视频，建议指定 frames。
+
+生�视频的帧数。通过指定帧数，�以�活控制生�视频的长度，生��数秒的视频。
+由于 frames 的�值�制，仅能支�有��数秒，您需�根�公�推算最接近的帧数。
+
+* 计算公�：帧数 = 时长 × 帧率（24）。
+* �值范围：支� [29, 289] 区间内所有满足 `25 + 4n` 格�的整数值，其中 n 为正整数。
+
+例如：�设需�生� 2.4 秒的视频，帧数=2.4×24=57.6。由于 frames �支� 57.6，此时您�能选择一个最接近的值。根� 25+4n 计算出最接近的帧数为 57，实际生�的视频为 57/24=2.375 秒。
+
+---
+
+
+**seed** `integer` `默认值 -1` 
+��整数，用于控制生�内容的�机性。
+�值范围：[\-1, 2^32\-1]之间的整数。
+:::warning
+
+* 相�的请求下，模型收到��的seed值，如：�指定seed值或令seed�值为\-1（会使用�机数替代）�或手动�更seed值，将生���的结果。
+* 相�的请求下，模型收到相�的seed值，会生�类似的结果，但���完全一致。
+
+
+:::
+---
+
+
+**camera_fixed** `boolean` `默认值 false` 
+> �考图场景�支�
+
+是�固定摄�头。枚举值：
+
+* true：固定摄�头。平�会在用户�示�中追加固定摄�头，实际效果���。
+* false：�固定摄�头。
+
+
+---
+
+
+**watermark** `boolean` `默认值 false` 
+生�视频是�包�水�。枚举值：
+
+* false：��水�。
+* true：�有水�。
+
+
+---
+
+
+<span id="y2hhTyHB"></span>
+## �应�数
+> 跳转 [请求�数](#RxN8G2nH)
+
+**id ** `string`
+视频生�任务 ID 。仅�存 7 天（从 **created at** 时间戳开始计算），超时�将自动清除。
+
+* 设置`"draft": true`，为 Draft 视频任务 ID。
+* 设置 `"draft": false`，为正常视频任务 ID。
+
+创建视频生�任务为异步接�，获� ID �，需�通过 [查询视频生�任务 API](https://www.volcengine.com/docs/82379/1521309) �查询视频生�任务的状�。任务�功�，会输出生�视频的`video_url`。
+
+
diff --git a/docs/API文档/推�节点.md b/docs/API文档/推�节点.md
new file mode 100644
index 0000000..194284a
--- /dev/null
+++ b/docs/API文档/推�节点.md
@@ -0,0 +1,1074 @@
+数分钟内完�你的首次 API 调用。
+
+<columns>
+<columnsItem zoneid="yYwBlMOVs1">
+
+
+<card mode="container" href="https://www.volcengine.com/docs/82379/2272060" >
+
+**快速入门(新手版)** 
+专为零基础用户设计的快速入门
+
+</card>
+
+
+
+
+</columnsItem>
+<columnsItem zoneid="ztHVepV3uP">
+
+
+<card mode="container" href="https://console.volcengine.com/ark/region:ark+cn-beijing/experience" >
+
+**体验中心**
+“0�代�，交互�体验模型能力
+
+</card>
+
+
+
+
+</columnsItem>
+<columnsItem zoneid="GuKcRXv7YX">
+
+
+<card mode="container" href="https://www.volcengine.com/docs/82379/1928261" >
+
+**Coding Plan**
+兼容主� AI 编�工具，助力高效编�开�
+
+</card>
+
+
+
+
+</columnsItem>
+</columns>
+
+<span id="da0e9d90"></span>
+# 1 获�并�置 API Key
+
+1. 获� API Key：访问[API Key 管�](https://console.volcengine.com/ark/region:ark+cn-beijing/apiKey) ，创建你的 API Key。
+2. �置环境��：在终端中�行下�命令（替�`your_api_key_here` 为你的方舟API Key），�置 API Key 到环境��。
+> �置�久化环境��方法�� [环境���置指�](/docs/82379/1820161)。
+
+
+```mixin-react
+return (<Tabs>
+<Tabs.TabPane title="MacOS" key="jKB2Z5Uv9I"><RenderMd content={`\`\`\`Bash
+export ARK_API_KEY="your_api_key_here"
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Linux" key="jaHSIUv1CP"><RenderMd content={`\`\`\`Bash
+export ARK_API_KEY="your_api_key_here"
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Windows_CMD" key="QaotrMwBYV"><RenderMd content={`\`\`\`Bash
+setx ARK_API_KEY "your_api_key_here"
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Windows_PowerShell" key="iwjs9oDt8B"><RenderMd content={`\`\`\`PowerShell
+$env:ARK_API_KEY = "your_api_key_here"
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane></Tabs>);
+```
+
+
+<span id="1008bfdb"></span>
+# 2 开通模型�务
+访问 [开通管�页�](https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement) 开通模型�务。
+<span id="b30fecf4"></span>
+# 3 安装 SDK
+安装官方或三方 SDK。
+
+```mixin-react
+return (<Tabs>
+<Tabs.TabPane title="Python" key="hB5KjbMxpL"><RenderMd content={`> �行环境中需安装 [Python](https://www.python.org/downloads/) 版本 3.7 或以上。
+
+* 安装方舟 SDK：
+   \`\`\`Bash
+   pip install 'volcengine-python-sdk[ark]'
+   \`\`\`
+   
+* 安装 OpenAI SDK：
+   \`\`\`Bash
+   pip install openai
+   \`\`\`
+   
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Go" key="QJHMnneke7"><RenderMd content={`> 环境中安装 [Go](https://golang.google.cn/doc/install) 版本 1.18 或以上。
+
+在代�中通过下方方法引入 Go SDK
+\`\`\`Go
+import (
+  "github.com/volcengine/volcengine-go-sdk"
+)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Java" key="i9ImXRL8dJ"><RenderMd content={`> 环境中安装 [Java](https://www.java.com/en/download/help/index_installing.html) 版本 1.8 或以上。
+
+在项目的\`pom.xml\`文件中添加以下�赖�置。
+\`\`\`XML
+<dependency>
+  <groupId>com.volcengine</groupId>
+  <artifactId>volcengine-java-sdk-ark-runtime</artifactId>
+  <version>LATEST</version>
+</dependency>
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane></Tabs>);
+```
+
+<span id="f97e77a7"></span>
+# 4 �起 API 请求
+以下按输入输出类别列举的典型任务，选择任�示例代�体验如何通过 API 调用�体验大模型�方舟平�能力。
+<span id="b25b812a"></span>
+## 文本生�
+传入文本类信�给模型，进行问答�分��改写�摘��编程�翻译等任务，并返回文本结果。
+
+<span aceTableMode="list" aceTableWidth="4,4"></span>
+|输入 |输出预览 |
+|---|---|
+|Hello |* �考：Got it, let's see. The user said "hello". I need to respond in a friendly and welcoming way. Since the system prompt mentions a professional but friendly tone, I should keep it natural. Maybe something like "Hello! How can I assist you today?" That's simple, polite, and open\-ended to encourage the user to share what they need help with.|\
+| |* 回答：Hello! How can I assist you today? Whether you have a question, need help with something specific, or just want to chat, feel free to let me know. 😊 |
+
+
+```mixin-react
+return (<Tabs>
+<Tabs.TabPane title="Python" key="hTKqBzvt1w"><RenderMd content={`\`\`\`Python
+import os
+from volcenginesdkarkruntime import Ark
+
+client = Ark(
+    base_url='https://ark.cn-beijing.volces.com/api/v3',
+    api_key=os.getenv('ARK_API_KEY'),
+)
+
+response = client.responses.create(
+    model="doubao-seed-2-0-lite-260215",
+    input="hello", # Replace with your prompt
+    # thinking={"type": "disabled"}, #  Manually disable deep thinking
+)
+print(response)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Curl" key="XWzKCOwadg"><RenderMd content={`\`\`\`Bash
+curl https://ark.cn-beijing.volces.com/api/v3/responses \\
+  -H "Authorization: Bearer $ARK_API_KEY" \\
+  -H "Content-Type: application/json" \\
+  -d '{
+      "model": "doubao-seed-2-0-lite-260215",
+      "input": "hello"
+  }'
+\`\`\`
+
+
+* 关闭深度�考：�置 \`"thinking":{"type": "disabled"}\`。
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Go" key="qBbpTiAsc3"><RenderMd content={`\`\`\`Go
+package main
+
+import (
+    "context"
+    "fmt"
+    "os"
+    "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
+    "github.com/volcengine/volcengine-go-sdk/service/arkruntime/model/responses"
+)
+
+func main() {
+    client := arkruntime.NewClientWithApiKey(
+        // Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
+        os.Getenv("ARK_API_KEY"),
+        arkruntime.WithBaseUrl("https://ark.cn-beijing.volces.com/api/v3"),
+    )
+    ctx := context.Background()
+
+    resp, err := client.CreateResponses(ctx, &responses.ResponsesRequest{
+        Model: "doubao-seed-2-0-lite-260215",
+        Input: &responses.ResponsesInput{Union: &responses.ResponsesInput_StringValue{StringValue: "hello"}}, // Replace with your prompt
+        // Thinking: &responses.ResponsesThinking{Type: responses.ThinkingType_disabled.Enum()}, // Manually disable deep thinking
+    })
+    if err != nil {
+        fmt.Printf("response error: %v\\n", err)
+        return
+    }
+    fmt.Println(resp)
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Java" key="uaScGs0GuJ"><RenderMd content={`\`\`\`Java
+package com.ark.sample;
+
+import com.volcengine.ark.runtime.service.ArkService;
+import com.volcengine.ark.runtime.model.responses.request.*;
+import com.volcengine.ark.runtime.model.responses.response.ResponseObject;
+
+public class demo {
+    public static void main(String[] args) {
+        String apiKey = System.getenv("ARK_API_KEY");
+        // The base URL for model invocation
+        ArkService arkService = ArkService.builder().apiKey(apiKey).baseUrl("https://ark.cn-beijing.volces.com/api/v3").build();
+
+        CreateResponsesRequest request = CreateResponsesRequest.builder()
+                .model("doubao-seed-2-0-lite-260215")
+                .input(ResponsesInput.builder().stringValue("hello").build()) // Replace with your prompt
+                // .thinking(ResponsesThinking.builder().type(ResponsesConstants.THINKING_TYPE_DISABLED).build()) //  Manually disable deep thinking
+                .build();
+
+        ResponseObject resp = arkService.createResponse(request);
+        System.out.println(resp);
+
+        arkService.shutdownExecutor();
+    }
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="OpenAI SDK" key="nTVGYVY9kv"><RenderMd content={`\`\`\`Python
+import os
+from openai import OpenAI
+
+client = OpenAI(
+    base_url='https://ark.cn-beijing.volces.com/api/v3',
+    api_key=os.getenv('ARK_API_KEY'),
+)
+
+response = client.responses.create(
+    model="doubao-seed-2-0-lite-260215",
+    input="hello", # Replace with your prompt
+    extra_body={
+        # "thinking": {"type": "disabled"}, #  Manually disable deep thinking
+    },
+)
+
+print(response)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane></Tabs>);
+```
+
+
+* [文本生�](/docs/82379/1399009)：文本生�使用指�。
+* [深度�考](/docs/82379/1956279)：深度�考能力使用指�。
+* [�移至 Responses API](/docs/82379/1585128)：新用户推�，更简�的上下文管�能力�强大的工具调用能力。
+* [Chat API](https://www.volcengine.com/docs/82379/1494384)：存�业务迭代推�，广泛使用的 API。
+
+<span id="efbfe823"></span>
+## 多模��解
+传入图片�视频�PDF文件给模型，进行分��内容审核�问答�视觉定�等基于多模��解相关任务，并返回文本结果。
+
+<span aceTableMode="list" aceTableWidth="4,4"></span>
+|输入 |输出预览 |
+|---|---|
+|<span>![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/a31c2edfbe844461a43f5e8f74fbcce4~tplv-goo7wpa0wc-image.image =275x) </span>|* �考：用户现在需�找支�输入图片的模型系列，看表格里的输入列中的图�列，哪个模型对应的图�输入是√。看表格，Doubao\-1.5\-vision那一行的输入图�列是√，其他两个Doubao\-1.5\-pro和lite的输入图�都是×，所以答案是Doubao\-1.5\-vision。|\
+|> 支�输入图片的模型系列是哪个？ |* 回答：支�输入图片的模型系列是Doubao\-1.5\-vision |
+
+
+```mixin-react
+return (<Tabs>
+<Tabs.TabPane title="Python" key="Xbz51XeC28"><RenderMd content={`\`\`\`Python
+import os
+from volcenginesdkarkruntime import Ark
+
+client = Ark(
+    base_url='https://ark.cn-beijing.volces.com/api/v3',
+    api_key=os.getenv('ARK_API_KEY'),
+)
+
+response = client.responses.create(
+    model="doubao-seed-2-0-lite-260215",
+    input=[
+        {
+            "role": "user",
+            "content": [
+                {
+                    "type": "input_image",
+                    "image_url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/ark_demo_img_1.png"
+                },
+                {
+                    "type": "input_text",
+                    "text": "支�输入图片的模型系列是哪个？"
+                },
+            ],
+        }
+    ]
+)
+
+print(response)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Curl" key="cGe83NpoRv"><RenderMd content={`\`\`\`Bash
+curl https://ark.cn-beijing.volces.com/api/v3/responses \\
+-H "Authorization: Bearer $ARK_API_KEY" \\
+-H 'Content-Type: application/json' \\
+-d '{
+    "model": "doubao-seed-2-0-lite-260215",
+    "input": [
+        {
+            "role": "user",
+            "content": [
+                {
+                    "type": "input_image",
+                    "image_url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/ark_demo_img_1.png"
+                },
+                {
+                    "type": "input_text",
+                    "text": "支�输入图片的模型系列是哪个？"
+                }
+            ]
+        }
+    ]
+}'
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Go" key="E1Nbc6AMyl"><RenderMd content={`\`\`\`Go
+package main
+
+import (
+    "context"
+    "fmt"
+    "os"    
+    "github.com/samber/lo"
+    "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
+    "github.com/volcengine/volcengine-go-sdk/service/arkruntime/model/responses"
+)
+
+func main() {
+    client := arkruntime.NewClientWithApiKey(
+        // Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
+        os.Getenv("ARK_API_KEY"),
+        arkruntime.WithBaseUrl("https://ark.cn-beijing.volces.com/api/v3"),
+    )
+    ctx := context.Background()
+
+    inputMessage := &responses.ItemInputMessage{
+        Role: responses.MessageRole_user,
+        Content: []*responses.ContentItem{
+            {
+                Union: &responses.ContentItem_Image{
+                    Image: &responses.ContentItemImage{
+                        Type:     responses.ContentItemType_input_image,
+                        ImageUrl: lo.ToPtr("https://ark-project.tos-cn-beijing.volces.com/doc_image/ark_demo_img_1.png"),
+                    },
+                },
+            },
+            {
+                Union: &responses.ContentItem_Text{
+                    Text: &responses.ContentItemText{
+                        Type: responses.ContentItemType_input_text,
+                        Text: "支�输入图片的模型系列是哪个？",
+                    },
+                },
+            },
+        },
+    }
+
+    resp, err := client.CreateResponses(ctx, &responses.ResponsesRequest{
+        Model: "doubao-seed-2-0-lite-260215",
+        Input: &responses.ResponsesInput{
+            Union: &responses.ResponsesInput_ListValue{
+                ListValue: &responses.InputItemList{ListValue: []*responses.InputItem{{
+                    Union: &responses.InputItem_InputMessage{
+                        InputMessage: inputMessage,
+                    },
+                }}},
+            },
+        },
+    })
+    if err != nil {
+        fmt.Printf("response error: %v\\n", err)
+        return
+    }
+    fmt.Println(resp)
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Java" key="FfxbbkFitZ"><RenderMd content={`\`\`\`Java
+package com.ark.sample;
+
+import com.volcengine.ark.runtime.service.ArkService;
+import com.volcengine.ark.runtime.model.responses.request.*;
+import com.volcengine.ark.runtime.model.responses.content.*;
+import com.volcengine.ark.runtime.model.responses.item.*;
+import com.volcengine.ark.runtime.model.responses.response.ResponseObject;
+import com.volcengine.ark.runtime.model.responses.constant.ResponsesConstants;
+
+public class demo {
+  public static void main(String[] args) {
+    String apiKey = System.getenv("ARK_API_KEY");
+    ArkService arkService = ArkService.builder().apiKey(apiKey).baseUrl("https://ark.cn-beijing.volces.com/api/v3")
+        .build();
+
+    CreateResponsesRequest request = CreateResponsesRequest.builder()
+        .model("doubao-seed-2-0-lite-260215")
+        .input(ResponsesInput.builder().addListItem(
+            ItemEasyMessage.builder().role(ResponsesConstants.MESSAGE_ROLE_USER).content(
+                MessageContent.builder()
+                    .addListItem(InputContentItemImage.builder()
+                        .imageUrl("https://ark-project.tos-cn-beijing.volces.com/doc_image/ark_demo_img_1.png").build())
+                    .addListItem(InputContentItemText.builder().text("支�输入图片的模型系列是哪个？").build())
+                    .build())
+                .build())
+            .build())
+        .build();
+    ResponseObject resp = arkService.createResponse(request);
+    System.out.println(resp);
+
+    arkService.shutdownExecutor();
+  }
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="OpenAI SDK" key="HbmPUDWyjH"><RenderMd content={`\`\`\`Python
+import os
+from openai import OpenAI
+
+client = OpenAI(
+    base_url='https://ark.cn-beijing.volces.com/api/v3',
+    api_key=os.getenv('ARK_API_KEY'),
+)
+
+response = client.responses.create(
+    model="doubao-seed-2-0-lite-260215",
+    input=[
+        {
+            "role": "user",
+            "content": [
+                {
+                    "type": "input_image",
+                    "image_url": "https://ark-project.tos-cn-beijing.volces.com/doc_image/ark_demo_img_1.png"
+                },
+                {
+                    "type": "input_text",
+                    "text": "支�输入图片的模型系列是哪个？"
+                },
+            ],
+        }
+    ]
+)
+
+print(response)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane></Tabs>);
+```
+
+
+* [多模��解](/docs/82379/1958521)：多模��解详细使用指�。
+* [视觉定� Grounding](/docs/82379/1616136)：图片中找到对应目标并返回�标任务。
+* [GUI 任务处�](/docs/82379/1584296)：在计算机/移动设备中完�自动化任务。
+* [文件输入(File API)](/docs/82379/1885708)：传入图片�视频�文档接�。
+
+<span id="d481ca5b"></span>
+## 图片生�
+传入图片�文字给模型，进行以下场景&任务：
+
+* 广告�海报�组图等图片生�；
+* 增改元素�颜色更�等图片编辑；
+* 油墨�水墨等风格切�。
+
+
+<span aceTableMode="list" aceTableWidth="4,4"></span>
+|�示� |输出预览 |
+|---|---|
+|充满活力的特写编辑肖�，模特眼神犀利，头戴雕塑感帽�，色彩拼接丰富，眼部焦点�利，景深较浅，具有Vogue�志��的美学风格，采用中画幅�摄，工作室�光效果强烈。 |<span>![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/00fb66006eb84b16965b620b6e1f2d78~tplv-goo7wpa0wc-image.image =275x) </span> |
+
+
+```mixin-react
+return (<Tabs>
+<Tabs.TabPane title="Python" key="RvDKXPATgT"><RenderMd content={`\`\`\`Python
+import os
+# Install SDK:  pip install 'volcengine-python-sdk[ark]' 
+from volcenginesdkarkruntime import Ark 
+
+client = Ark(
+    # The base URL for model invocation
+    base_url="https://ark.cn-beijing.volces.com/api/v3", 
+    # Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
+    api_key=os.getenv('ARK_API_KEY'), 
+)
+ 
+imagesResponse = client.images.generate( 
+    # Replace with Model ID
+    model="doubao-seedream-5-0-260128",
+    prompt="充满活力的特写编辑肖�，模特眼神犀利，头戴雕塑感帽�，色彩拼接丰富，眼部焦点�利，景深较浅，具有Vogue�志��的美学风格，采用中画幅�摄，工作室�光效果强烈。",
+    size="2K",
+    response_format="url",
+    watermark=False
+) 
+ 
+print(imagesResponse.data[0].url)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Curl" key="RmuE5dOE6b"><RenderMd content={`\`\`\`Bash
+curl https://ark.cn-beijing.volces.com/api/v3/images/generations \\
+  -H "Content-Type: application/json" \\
+  -H "Authorization: Bearer $ARK_API_KEY" \\
+  -d '{
+    "model": "doubao-seedream-5-0-260128",
+    "prompt": "充满活力的特写编辑肖�，模特眼神犀利，头戴雕塑感帽�，色彩拼接丰富，眼部焦点�利，景深较浅，具有Vogue�志��的美学风格，采用中画幅�摄，工作室�光效果强烈。",
+    "size": "2K",
+    "watermark": false
+}'
+\`\`\`
+
+
+* 您�按需替� Model ID。Model ID 查询� [模型列表](/docs/82379/1330310)。
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Java" key="gsQAbe5k8E"><RenderMd content={`\`\`\`Java
+package com.ark.sample;
+
+import com.volcengine.ark.runtime.model.images.generation.*;
+import com.volcengine.ark.runtime.service.ArkService;
+import okhttp3.ConnectionPool;
+import okhttp3.Dispatcher;
+import java.util.concurrent.TimeUnit;
+
+public class ImageGenerationsExample { 
+    public static void main(String[] args) {
+        // Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
+        String apiKey = System.getenv("ARK_API_KEY");
+        ConnectionPool connectionPool = new ConnectionPool(5, 1, TimeUnit.SECONDS);
+        Dispatcher dispatcher = new Dispatcher();
+        ArkService service = ArkService.builder()
+                .baseUrl("https://ark.cn-beijing.volces.com/api/v3") // The base URL for model invocation
+                .dispatcher(dispatcher)
+                .connectionPool(connectionPool)
+                .apiKey(apiKey)
+                .build();
+                
+        GenerateImagesRequest generateRequest = GenerateImagesRequest.builder()
+                .model("doubao-seedream-5-0-260128") // Replace with Model ID
+                .prompt("充满活力的特写编辑肖�，模特眼神犀利，头戴雕塑感帽�，色彩拼接丰富，眼部焦点�利，景深较浅，具有Vogue�志��的美学风格，采用中画幅�摄，工作室�光效果强烈。")
+                .size("2K")
+                .sequentialImageGeneration("disabled")
+                .responseFormat(ResponseFormat.Url)
+                .stream(false)
+                .watermark(false)
+                .build();
+        ImagesResponse imagesResponse = service.generateImages(generateRequest);
+        System.out.println(imagesResponse.getData().get(0).getUrl());
+
+        service.shutdownExecutor();
+    }
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Go" key="BsgTxPmN3m"><RenderMd content={`\`\`\`Go
+package main
+
+import (
+    "context"
+    "fmt"
+    "os"
+    "strings"    
+    "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
+    "github.com/volcengine/volcengine-go-sdk/service/arkruntime/model"
+    "github.com/volcengine/volcengine-go-sdk/volcengine"
+)
+
+func main() {
+    client := arkruntime.NewClientWithApiKey(        
+        os.Getenv("ARK_API_KEY"), // Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey        
+        arkruntime.WithBaseUrl("https://ark.cn-beijing.volces.com/api/v3"), // The base URL for model invocation
+    )    
+    ctx := context.Background()
+
+    generateReq := model.GenerateImagesRequest{
+       Model:          "doubao-seedream-5-0-260128", // Replace with Model ID
+       Prompt:         "充满活力的特写编辑肖�，模特眼神犀利，头戴雕塑感帽�，色彩拼接丰富，眼部焦点�利，景深较浅，具有Vogue�志��的美学风格，采用中画幅�摄，工作室�光效果强烈。",
+       Size:           volcengine.String("2K"),
+       ResponseFormat: volcengine.String(model.GenerateImagesResponseFormatURL),
+       Watermark:      volcengine.Bool(false),
+    }
+
+    imagesResponse, err := client.GenerateImages(ctx, generateReq)
+    if err != nil {
+       fmt.Printf("generate images error: %v\\n", err)
+       return
+    }
+
+    fmt.Printf("%s\\n", *imagesResponse.Data[0].Url)
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="OpenAI" key="dLFbQinSMF"><RenderMd content={`\`\`\`Python
+import os
+from openai import OpenAI
+
+client = OpenAI(     
+    base_url="https://ark.cn-beijing.volces.com/api/v3", # The base URL for model invocation    
+    api_key=os.getenv('ARK_API_KEY'),  # Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
+) 
+ 
+imagesResponse = client.images.generate( 
+    # Replace with Model ID
+    model="doubao-seedream-5-0-260128",
+    prompt="充满活力的特写编辑肖�，模特眼神犀利，头戴雕塑感帽�，色彩拼接丰富，眼部焦点�利，景深较浅，具有Vogue�志��的美学风格，采用中画幅�摄，工作室�光效果强烈。",
+    size="2K",
+    response_format="url",
+    extra_body={
+        "watermark": False,
+    },
+) 
+ 
+print(imagesResponse.data[0].url)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane></Tabs>);
+```
+
+
+* [Seedream 4.0-5.0 教程](/docs/82379/1824121)：主�生图模型能力以�如何通过 API 调用。
+* [Seedream 4.0-4.5 �示�指�](/docs/82379/1829186)：使用生图模型时，如何编写�示�。
+
+<span id="18692b80"></span>
+## 视频生�
+通过文本�述�图�素��视频素�，快速生�高质��风格多样的视频内容。
+
+<span aceTableMode="list" aceTableWidth="4,4"></span>
+|�示� |输出画�预览 |
+|---|---|
+|一�身穿绿色亮片礼�的女性站在粉红色背景�，周围飘��五彩斑斓的彩纸 |<span>![图片](https://p9-arcosite.byteimg.com/tos-cn-i-goo7wpa0wc/aae3d0c636954bdd9e66e7a23e98c480~tplv-goo7wpa0wc-image.image =275x) </span> |
+
+
+```mixin-react
+return (<Tabs>
+<Tabs.TabPane title="Python" key="HQcBpccTKp"><RenderMd content={`\`\`\`Python
+import os
+import time  
+# Install SDK:  pip install 'volcengine-python-sdk[ark]'
+from volcenginesdkarkruntime import Ark 
+
+client = Ark(    
+    base_url="https://ark.cn-beijing.volces.com/api/v3", # The base URL for model invocation    
+    api_key=os.environ.get("ARK_API_KEY"), # Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey
+)
+
+if __name__ == "__main__":
+    print("----- create request -----")
+    create_result = client.content_generation.tasks.create(
+        model="doubao-seedance-2-0-260128", # Replace with Model ID 
+        content=[
+            {
+                # Combination of text prompt and parameters
+                "type": "text",
+                "text": "一�身穿绿色亮片礼�的女性站在粉红色背景�，周围飘��五彩斑斓的彩纸 --wm true --dur 5"
+            }
+        ]
+    )
+    print(create_result)
+
+    # Polling query section
+    print("----- polling task status -----")
+    task_id = create_result.id
+    while True:
+        get_result = client.content_generation.tasks.get(task_id=task_id)
+        status = get_result.status
+        if status == "succeeded":
+            print("----- task succeeded -----")
+            print(get_result)
+            break
+        elif status == "failed":
+            print("----- task failed -----")
+            print(f"Error: {get_result.error}")
+            break
+        else:
+            print(f"Current status: {status}, Retrying after 3 seconds...")
+            time.sleep(3)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Java" key="yf4coHVoxJ"><RenderMd content={`\`\`\`Java
+package com.ark.sample;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.concurrent.TimeUnit;
+import com.volcengine.ark.runtime.model.content.generation.*;
+import com.volcengine.ark.runtime.model.content.generation.CreateContentGenerationTaskRequest.Content;
+import com.volcengine.ark.runtime.service.ArkService;
+
+public class ContentGenerationTaskExample {
+  public static void main(String[] args) {
+    String apiKey = System.getenv("ARK_API_KEY");
+    ArkService service = ArkService.builder()
+        .baseUrl("https://ark.cn-beijing.volces.com/api/v3") // The base URL for model invocation
+        .apiKey(apiKey)
+        .build();
+
+    System.out.println("----- create request -----");
+    List<Content> contents = new ArrayList<>();
+    contents.add(Content.builder()
+        .type("text")
+        .text("一�身穿绿色亮片礼�的女性站在粉红色背景�，周围飘��五彩斑斓的彩纸 --wm true --dur 5")
+        .build());
+
+    // Create a video generation task
+    CreateContentGenerationTaskRequest createRequest = CreateContentGenerationTaskRequest.builder()
+        .model("doubao-seedance-2-0-260128") // Replace with Model ID
+        .content(contents)
+        .build();
+
+    CreateContentGenerationTaskResult createResult = service.createContentGenerationTask(createRequest);
+    System.out.println(createResult);
+
+    // Get the details of the task
+    String taskId = createResult.getId();
+    GetContentGenerationTaskRequest getRequest = GetContentGenerationTaskRequest.builder()
+        .taskId(taskId)
+        .build();
+
+    System.out.println("----- polling task status -----");
+    while (true) {
+      try {
+        GetContentGenerationTaskResponse getResponse = service.getContentGenerationTask(getRequest);
+        String status = getResponse.getStatus();
+        if ("succeeded".equalsIgnoreCase(status)) {
+          System.out.println("----- task succeeded -----");
+          System.out.println(getResponse);
+          service.shutdownExecutor();
+          break;
+        } else if ("failed".equalsIgnoreCase(status)) {
+          System.out.println("----- task failed -----");
+          System.out.println("Error: " + getResponse.getStatus());
+          service.shutdownExecutor();
+          break;
+        } else {
+          System.out.printf("Current status: %s, Retrying in 3 seconds...\\n", status);
+          TimeUnit.SECONDS.sleep(3);
+        }
+      } catch (InterruptedException ie) {
+        Thread.currentThread().interrupt();
+        System.err.println("Polling interrupted");
+        service.shutdownExecutor();
+        break;
+      }
+    }
+  }
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Go" key="DHfLFju6pA"><RenderMd content={`\`\`\`Go
+package main
+
+import (
+    "context"
+    "fmt"
+    "os"
+    "time"
+    "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
+    "github.com/volcengine/volcengine-go-sdk/service/arkruntime/model"
+    "github.com/volcengine/volcengine-go-sdk/volcengine"
+)
+
+func main() {
+    client := arkruntime.NewClientWithApiKey(        
+        os.Getenv("ARK_API_KEY"), // Get API Key：https://console.volcengine.com/ark/region:ark+cn-beijing/apikey        
+        arkruntime.WithBaseUrl("https://ark.cn-beijing.volces.com/api/v3"), // The base URL for model invocation
+    )
+    ctx := context.Background()
+    // Replace with Model ID
+    modelEp := "doubao-seedance-2-0-260128"
+
+    fmt.Println("----- create request -----")
+    createReq := model.CreateContentGenerationTaskRequest{
+        Model: modelEp,
+        Content: []*model.CreateContentGenerationContentItem{
+            {
+                Type: model.ContentGenerationContentItemTypeText,
+                Text: volcengine.String("一�身穿绿色亮片礼�的女性站在粉红色背景�，周围飘��五彩斑斓的彩纸 --wm true --dur 5"),
+            },
+        },
+    }
+    createResp, err := client.CreateContentGenerationTask(ctx, createReq)
+    if err != nil {
+        fmt.Printf("create content generation error: %v", err)
+        return
+    }
+    taskID := createResp.ID
+    fmt.Printf("Task Created with ID: %s", taskID)
+
+    // Polling query section
+    fmt.Println("----- polling task status -----")
+    for {
+        getReq := model.GetContentGenerationTaskRequest{ID: taskID}
+        getResp, err := client.GetContentGenerationTask(ctx, getReq)
+        if err != nil {
+            fmt.Printf("get content generation task error: %v", err)
+            return
+        }
+
+        status := getResp.Status
+        if status == "succeeded" {
+            fmt.Println("----- task succeeded -----")
+            fmt.Printf("Task ID: %s \\n", getResp.ID)
+            fmt.Printf("Model: %s \\n", getResp.Model)
+            fmt.Printf("Video URL: %s \\n", getResp.Content.VideoURL)
+            fmt.Printf("Completion Tokens: %d \\n", getResp.Usage.CompletionTokens)
+            fmt.Printf("Created At: %d, Updated At: %d", getResp.CreatedAt, getResp.UpdatedAt)
+            return
+        } else if status == "failed" {
+            fmt.Println("----- task failed -----")
+            if getResp.Error != nil {
+                fmt.Printf("Error Code: %s, Message: %s", getResp.Error.Code, getResp.Error.Message)
+            }
+            return
+        } else {
+            fmt.Printf("Current status: %s, Retrying in 3 seconds... \\n", status)
+            time.Sleep(3 * time.Second)
+        }
+    }
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane></Tabs>);
+```
+
+
+* [视频生�](/docs/82379/1366799)：学习如何使用模型的视频生�能力，包括文本生�视频�首尾帧生视频�首帧生�视频等。
+* [Seedance-1.0-pro&pro-fast �示�指�](/docs/82379/1631633)：使用生视频模型时，如何编写�示�。
+
+<span id="086a3233"></span>
+## 工具使用
+通过工具/�件让模型具体读�外部数��函数的能力，包括
+
+* 内置工具：�网�索�图片处��知识库检索等已集�至方舟平�的工具。
+* 三方工具：兼容MCP 的三方工具。
+* 自定义工具：您自行定义�开�的工具。
+
+
+<span aceTableMode="list" aceTableWidth="4,4"></span>
+|输入 |输出预览 |
+|---|---|
+|What's the weather like in Beijing? |According to the latest weather data as of March 10, 2026, the current weather in Beijing is sunny with a gentle wind (less than level 3). The temperature around 11:30 AM is approximately 9°C, and it is expected to reach a high of 12°C during the day. The weather will remain clear at night with a low temperature of 1°C.|\
+| |**Source**: Weather forecasts updated on March 10, 2026, from the Central Meteorological Observatory.|\
+| |**Note: Data is accurate as of the latest available update at 05:30 AM on March 10.**  |
+
+
+```mixin-react
+return (<Tabs>
+<Tabs.TabPane title="Python" key="Cldhum2k2M"><RenderMd content={`\`\`\`Python
+import os
+from volcenginesdkarkruntime import Ark
+
+client = Ark(
+    base_url="https://ark.cn-beijing.volces.com/api/v3",
+    api_key=os.getenv("ARK_API_KEY"),
+)
+
+response = client.responses.create(
+    model="doubao-seed-2-0-lite-260215",
+    input=[{"role": "user", "content": "What's the weather like in Beijing?"}],
+    tools=[
+        {
+            "type": "web_search",
+            "max_keyword": 2,
+        }
+    ],
+)
+
+print(response)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Curl" key="vyy2pmEicQ"><RenderMd content={`\`\`\`Bash
+curl https://ark.cn-beijing.volces.com/api/v3/responses \\
+-H "Authorization: Bearer $ARK_API_KEY" \\
+-H 'Content-Type: application/json' \\
+-d '{
+    "model": "doubao-seed-2-0-lite-260215",
+    "stream": true,
+    "tools": [
+        {
+            "type": "web_search",
+            "max_keyword": 3
+        }
+    ],
+    "input": [
+        {
+            "role": "user",
+            "content": [
+                {
+                    "type": "input_text",
+                    "text": "What is the weather like in Beijing?"
+                }
+            ]
+        }
+    ]
+}'
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Java" key="lvTZqbVrgZ"><RenderMd content={`\`\`\`Java
+package com.ark.sample;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.volcengine.ark.runtime.model.responses.item.*;
+import com.volcengine.ark.runtime.model.responses.request.*;
+import com.volcengine.ark.runtime.model.responses.response.ResponseObject;
+import com.volcengine.ark.runtime.model.responses.constant.ResponsesConstants;
+import com.volcengine.ark.runtime.model.responses.content.InputContentItemText;
+import com.volcengine.ark.runtime.model.responses.tool.*;
+import com.volcengine.ark.runtime.service.ArkService;
+import java.util.Arrays;
+import java.util.List;
+
+public class demo {
+    public static ObjectMapper om = new ObjectMapper();
+
+    public demo() throws JsonProcessingException {
+    }
+
+    public static List<ResponsesTool> buildTools() {
+        ToolWebSearch t = ToolWebSearch.builder().build();
+        System.out.println(Arrays.asList(t));
+        return Arrays.asList(t);
+    }
+
+    public static void main(String[] args) throws JsonProcessingException {
+        String apiKey = System.getenv("ARK_API_KEY");
+
+        ArkService arkService = ArkService.builder().apiKey(apiKey).baseUrl("https://ark.cn-beijing.volces.com/api/v3").build();
+        CreateResponsesRequest req = CreateResponsesRequest.builder()
+                .model("doubao-seed-2-0-lite-260215")
+                .input(ResponsesInput.builder().addListItem(
+                        ItemEasyMessage.builder().role(ResponsesConstants.MESSAGE_ROLE_USER).content(
+                                MessageContent.builder()
+                                        .addListItem(InputContentItemText.builder().text("What's the weather like in Beijing?").build())
+                                        .build()
+                        ).build()
+                ).build())
+                .tools(buildTools())
+                .build();
+        ResponseObject resp = arkService.createResponse(req);
+        System.out.println(resp);
+
+        arkService.shutdownExecutor();
+    }
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="Go" key="T7CzYwfQQI"><RenderMd content={`\`\`\`Go
+package main
+import (
+  "context"
+  "fmt"
+  "os"
+  "github.com/volcengine/volcengine-go-sdk/service/arkruntime"
+  "github.com/volcengine/volcengine-go-sdk/service/arkruntime/model/responses"
+)
+
+func main() {
+  client := arkruntime.NewClientWithApiKey(
+    os.Getenv("ARK_API_KEY"),
+    arkruntime.WithBaseUrl("https://ark.cn-beijing.volces.com/api/v3"), // The base URL for model invocation
+  )
+  ctx := context.Background()
+  maxToolCalls := int64(1) // Limit the number of tool calls, adjust it according to your needs.
+  
+  inputMessage := &responses.ItemInputMessage{
+    Role: responses.MessageRole_user,
+    Content: []*responses.ContentItem{
+      {
+        Union: &responses.ContentItem_Text{
+          Text: &responses.ContentItemText{
+            Type: responses.ContentItemType_input_text,
+            Text: "What's the weather like in Beijing?",
+          },
+        },
+      },
+    },
+  }
+
+  req := &responses.ResponsesRequest{
+    Model: "doubao-seed-2-0-lite-260215",
+    Input: &responses.ResponsesInput{
+      Union: &responses.ResponsesInput_ListValue{
+        ListValue: &responses.InputItemList{ListValue: []*responses.InputItem{{
+          Union: &responses.InputItem_InputMessage{
+            InputMessage: inputMessage,
+          },
+        }}}},
+    },
+    Tools: []*responses.ResponsesTool{
+      {
+        Union: &responses.ResponsesTool_ToolWebSearch{
+          ToolWebSearch: &responses.ToolWebSearch{
+            Type: responses.ToolType_web_search,
+          },
+        },
+      },
+    },
+    MaxToolCalls: &maxToolCalls,
+  }
+
+  resp, err := client.CreateResponses(ctx, req)
+  if err != nil {
+    fmt.Printf("Error: %v\\n", err)
+    os.Exit(1)
+  }
+
+  fmt.Printf("Response: %v\\n", resp)
+}
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane>
+<Tabs.TabPane title="OpenAI SDK" key="pKzLz4If7g"><RenderMd content={`\`\`\`Python
+import os
+from openai import OpenAI
+
+client = OpenAI(
+    base_url="https://ark.cn-beijing.volces.com/api/v3",
+    api_key=os.getenv("ARK_API_KEY"),
+)
+
+response = client.responses.create(
+    model="doubao-seed-2-0-lite-260215",
+    input=[{"role": "user", "content": "What's the weather like in Beijing?"}],
+    tools=[
+        {
+            "type": "web_search",
+            "max_keyword": 2,
+        }
+    ],
+)
+
+print(response)
+\`\`\`
+
+`}></RenderMd></Tabs.TabPane></Tabs>);
+```
+
+
+* [工具调用](/docs/82379/1958524)：学习如何让模型使用内置工具，如网页�索�知识库检索�豆包助手等能力。
+* [函数调用 Function Calling](/docs/82379/1262342)：学习如何让模型调用自定义的工具。
+* [云部署 MCP / Remote MCP](/docs/82379/1827534)：学习如何让模型使用 MCP �务。
+
+<span id="ffac0939"></span>
+# 5 下一步
+现在你已�完�了首次方舟模型�务的 API 调用，你�以探索模型的更多能力，包括：
+
+* [平�能力速览](/docs/82379/1108216)：探索方舟平��供的�示�优化���管��模型管�等高阶能力。
+* [模型列表](/docs/82379/1330310)：快速�览方舟�供的模型全集以��个模型所具备的能力，快速根�你的实际场景匹�到�适的模型。
+
+
+