# GlobalRouter Seedance 2.0 素材资产接入指南 本文档说明如何通过 GlobalRouter 调用 Seedance 2.0 虚拟人像、真人人像素材资产相关接口。 ## 与直接调用火山方舟的差异 GlobalRouter 尽量保持请求体字段、Action 名称和响应结构与火山素材资产接口一致。接入方主要调整访问地址和鉴权方式。 | 项目 | 直接调用火山方舟 | 调用 GlobalRouter | | --- | --- | --- | | 接入地址 | `https://ark.cn-beijing.volcengineapi.com/?Action=...&Version=2024-01-01` | `https://api.globalrouter.com/doubao/?Action=...&Version=2024-01-01` | | 鉴权方式 | 火山 AK/SK 或火山 API Key | `Authorization: Bearer ` | | 请求体 | 按火山素材资产接口填写 | 按火山素材资产接口填写；不要传 provider api_key | | 资源归属 | 接入方自行管理 | GlobalRouter 根据 GR API Key 识别租户并记录素材归属 | | 归属校验 | 接入方自行管理 | 查询、更新、删除素材前自动校验当前租户是否拥有该资源 | ## 基础信息 ```text Base URL: https://api.globalrouter.com Authorization: Bearer sk-your-globalrouter-key Content-Type: application/json ``` 素材接口统一使用： ```http POST /doubao/?Action=&Version=2024-01-01 ``` 请求体中的 `api_key`、`ApiKey`、`authorization` 等 provider 鉴权字段会被忽略。GlobalRouter 会根据 GR API Key 识别当前租户，并选择对应的豆包素材接口密钥。 ## 注意事项 - 素材需要审核通过后（Active）才可以使用，需要轮询查询素材审核状态。 - 素材按照项目隔离，生成视频时必须使用“素材所在项目”中的推理接入点进行推理。 - 不要把其他租户的 `asset_id` 或 `group_id` 传入请求；GlobalRouter 会拒绝访问。 - 列表接口以 GlobalRouter 记录的素材归属为准，只返回当前租户通过 GlobalRouter 创建或绑定的资源。 ## 虚拟人像接口 | 接口 | 方法 | GlobalRouter 路径 | 火山 Action | 官方文档 | | --- | --- | --- | --- | --- | | 创建虚拟人像 Asset Group | POST | `/doubao/?Action=CreateAssetGroup&Version=2024-01-01` | `CreateAssetGroup` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 上传虚拟人像素材 | POST | `/doubao/?Action=CreateAsset&Version=2024-01-01` | `CreateAsset` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 查询虚拟人像 Asset Group 列表 | POST | `/doubao/?Action=ListAssetGroups&Version=2024-01-01` | `ListAssetGroups` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 查询虚拟人像素材列表 | POST | `/doubao/?Action=ListAssets&Version=2024-01-01` | `ListAssets` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 查询虚拟人像素材 | POST | `/doubao/?Action=GetAsset&Version=2024-01-01` | `GetAsset` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 更新虚拟人像素材 | POST | `/doubao/?Action=UpdateAsset&Version=2024-01-01` | `UpdateAsset` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 删除虚拟人像素材 | POST | `/doubao/?Action=DeleteAsset&Version=2024-01-01` | `DeleteAsset` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 查询虚拟人像 Asset Group | POST | `/doubao/?Action=GetAssetGroup&Version=2024-01-01` | `GetAssetGroup` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 更新虚拟人像 Asset Group | POST | `/doubao/?Action=UpdateAssetGroup&Version=2024-01-01` | `UpdateAssetGroup` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 删除虚拟人像 Asset Group | POST | `/doubao/?Action=DeleteAssetGroup&Version=2024-01-01` | `DeleteAssetGroup` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | ## 真人人像接口 | 接口 | 方法 | GlobalRouter 路径 | 火山 Action | 官方文档 | | --- | --- | --- | --- | --- | | 创建真人人像认证会话 | POST | `/doubao/?Action=CreateVisualValidateSession&Version=2024-01-01` | `CreateVisualValidateSession` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 查询认证结果并绑定 Asset Group | POST | `/doubao/?Action=GetVisualValidateResult&Version=2024-01-01` | `GetVisualValidateResult` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 创建真人人像素材 | POST | `/doubao/?Action=CreateAsset&Version=2024-01-01` | `CreateAsset` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 查询真人人像 Asset Group 列表 | POST | `/doubao/?Action=ListAssetGroups&Version=2024-01-01` | `ListAssetGroups` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 查询真人人像素材列表 | POST | `/doubao/?Action=ListAssets&Version=2024-01-01` | `ListAssets` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 查询真人人像素材 | POST | `/doubao/?Action=GetAsset&Version=2024-01-01` | `GetAsset` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 更新真人人像素材 | POST | `/doubao/?Action=UpdateAsset&Version=2024-01-01` | `UpdateAsset` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 删除真人人像素材 | POST | `/doubao/?Action=DeleteAsset&Version=2024-01-01` | `DeleteAsset` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 查询真人人像 Asset Group | POST | `/doubao/?Action=GetAssetGroup&Version=2024-01-01` | `GetAssetGroup` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 更新真人人像 Asset Group | POST | `/doubao/?Action=UpdateAssetGroup&Version=2024-01-01` | `UpdateAssetGroup` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | | 删除真人人像 Asset Group | POST | `/doubao/?Action=DeleteAssetGroup&Version=2024-01-01` | `DeleteAssetGroup` | [素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316) | ## 官方文档入口 - [火山方舟素材资产官方文档](https://www.volcengine.com/docs/82379/2333565?lang=zh&_vtm_=a106466.b106468.0_0.0_0.0.297_7628791561808217626#cd721316)