# HBoom

## API Docs
- 豆包 > 视频生成 [创建视频生成任务(Seedance 2.0)](https://api-docs.hboom.ai/477147090e0.md): 提交视频生成任务。content 内通过 asset://hb-xxxx 引用平台素材(素材须为 Active);平台会自动还原为火山真实引用并强制路由到素材所属渠道。
- 豆包 > 视频生成 [查询视频生成任务列表](https://api-docs.hboom.ai/477147091e0.md): 
- 豆包 > 视频生成 [查询单个视频生成任务](https://api-docs.hboom.ai/477147092e0.md): 按任务 id 查询生成进度与结果(视频地址)。
- 豆包 > 视频生成 [删除视频生成任务](https://api-docs.hboom.ai/477147093e0.md): 
- 豆包 > 素材分组 [CreateAssetGroup 建素材分组(虚拟人像 AIGC)](https://api-docs.hboom.ai/477147094e0.md): 虚拟人像 AIGC 直接建组。真人人像(LivenessFace)不走这里,必须走 CreateVisualValidateSession H5 认证建组。
- 豆包 > 素材分组 [DeleteAssetGroup 删除素材分组](https://api-docs.hboom.ai/477147095e0.md): 
- 豆包 > 素材分组 [GetAssetGroup 查询单个分组信息](https://api-docs.hboom.ai/477147096e0.md): 按平台分组 id 查询分组信息。请求传 Id(hbg- 前缀);ProjectName 由平台按渠道注入,无需传。响应中 Id 为平台分组 id(hbg-)。
- 豆包 > 素材分组 [UpdateAssetGroup 更新分组(名称/描述)](https://api-docs.hboom.ai/477147097e0.md): 当前仅支持更新分组的 Name 和 Description。请求传 Id(hbg- 前缀);ProjectName 由平台按渠道注入,无需传。
- 豆包 > 素材 [CreateAsset 入库素材(传 URL,异步)](https://api-docs.hboom.ai/477147098e0.md): 平台不收二进制,只收公网可访问 URL,原样交火山入库。返回 Asset ID(平台翻译为 hb-),状态 Processing,需轮询 GetAsset 至 Active。
- 豆包 > 素材 [GetAsset 查询素材状态(轮询)](https://api-docs.hboom.ai/477147099e0.md): 轮询 asset_status:Processing → Active/Failed,仅 Active 可用于视频生成。
- 豆包 > 素材 [ListAssets 列出素材(Filter 过滤)](https://api-docs.hboom.ai/477147100e0.md): 按官方实测结构:过滤条件统一放进 Filter 对象,GroupIds 为字符串数组(平台 hbg- id),平台会逐元素翻译。顶层 GroupId 不被识别(会报 MissingParameter.Filter)。
- 豆包 > 素材 [UpdateAsset 更新素材(如备注名)](https://api-docs.hboom.ai/477147101e0.md): 
- 豆包 > 素材 [DeleteAsset 删除素材](https://api-docs.hboom.ai/477147102e0.md): 
- 豆包 > 真人认证 [CreateVisualValidateSession 发起真人 H5 认证](https://api-docs.hboom.ai/477147103e0.md): 真人人像建组入口。请求体留空即可。
- 豆包 > 真人认证 [GetVisualValidateResult 换取真人 GroupId(通常平台内部自动调用)](https://api-docs.hboom.ai/477147104e0.md): 正常闭环由平台在 liveness/callback 内部用后端持有的 BytedToken 自动调用,并强制带 ProjectName(IAM 按 project 维度鉴权)。客户端一般无需手动调,此处仅为文档完整性保留。