通过 AionRouter 调用 BytePlus 素材管理能力。你可以创建 AIGC 素材组、完成真人认证、上传源文件并追踪素材状态。素材就绪后，可以在支持的 Seedance 视频生成请求中使用 asset://<asset_id> 引用它。

​
开始调用

使用 AionRouter 的 API 密钥。Base URL 为 https://router.aionclaw.ai。在每个请求中携带 Authorization: Bearer <API_KEY>。
响应中的 data.group_id 是后续创建素材时需要的 BytePlus 分组 ID。
素材管理接口使用与你调用模型相同的 AionRouter API 密钥。请勿在客户端代码中暴露 API 密钥。

​
素材类型和分组

group_id 是 BytePlus 的 group-... ID，不是本站自增 ID。查询、改名、删除分组和素材时，都必须使用与素材类型对应的 library。

​
典型调用流程

​
AIGC 素材

  1. 调用“获取或创建默认 AIGC 分组”，取得 data.group_id。
  2. 准备素材 URL：上传本地文件时，可选调用“上传素材源文件”取得 data.url；已有公网可访问的 HTTPS URL 时，直接使用该 URL。
  3. 使用 group_id、url、name、asset_type 和 request_key 创建素材。
  4. 查询单个素材状态，直到 data.asset.upstream_status 为 Active。

​
真人素材

  1. 创建真人活体认证会话，取得 data.session_id 和 data.h5_link。
  2. 将 h5_link 交给认证本人在手机端完成活体认证。
  3. 使用相同的 session_id 确认认证结果，并从成功响应中取得 data.group_id。
  4. 准备素材 URL：上传本地文件时，可选调用“上传素材源文件”取得 data.url；已有公网可访问的 HTTPS URL 时，直接使用该 URL。
  5. 创建素材。真人素材必须与已认证的本人一致。
认证尚未完成时，确认接口会返回 409 VERIFICATION_PENDING。请等待后使用同一个 session_id 重试。

​
上传、创建和状态

上传接口是可选的，只接收 file，不需要 asset_type。当前文件大小上限为 200,000,000 字节，仅适用于通过该接口上传的本地文件。上传成功只表示你获得了源文件 URL；仍需调用“创建素材”把它写入目标分组。 如果你已有公网可访问的 HTTPS URL，无需调用上传接口。直接在“创建素材”请求中传入该 URL。 创建素材被上游接受后不表示素材已经可用。使用“查询素材状态”刷新上游状态。只有 upstream_status=Active 的素材，才能在支持的 Seedance 请求中引用：
对素材列表可以按分组、状态和名称筛选。列表默认按创建时间倒序返回。服务端会定期同步处于 Processing 状态的素材；需要立即确认时，请查询单个素材状态。

​
重试和管理建议

  • 创建素材时为一次逻辑创建生成 request_key。网络超时或结果不确定时，重试必须复用相同的 request_key 和全部原始字段。
  • 看到 ASSET_CREATION_UNCERTAIN 时，不要更换 request_key 创建另一份素材。先按原参数重试或查询现有素材。
  • 删除 AIGC 分组后，其中的素材不再可用。需要新的分组时，重新调用默认 AIGC 分组接口。
  • 删除素材组和删除单个素材都会真实删除 BytePlus 上对应的素材数据，操作不可恢复。执行前请确认资源不再被视频生成请求使用。

​
接口目录

左侧目录按实际工作流排序：先创建 AIGC 分组或完成真人认证，再上传和创建素材，最后查询、改名或删除资源。每个接口页都列出了请求参数、响应 Schema 和错误响应。