跳转到主要内容
POST

认证

Authorization
string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

group
object
素材组信息不传 group_id 时,服务端会根据此字段自动创建 AIGC 类型素材组示例:
group_id 二选一使用,不可同时传入
group_id
string
已有素材组 ID传入时跳过素材组创建,直接向该素材组提交素材
group 二选一使用,不可同时传入
project_name
string
默认值:"default"
项目名称默认值:default
asset_type
string
默认值:"Image"
素材类型可选值:
  • Image - 图片素材(默认)
  • Video - 视频素材
  • Audio - 音频素材
默认值:Image
assets
array
素材列表,支持一次提交多个素材
单次最多提交 20 个素材
示例:
url
string
单素材兼容写法:素材 URL
assets 数组二选一使用,适用于只提交一个素材的场景
name
string
单素材兼容写法:素材名称
assets 数组二选一使用,适用于只提交一个素材的场景

响应

code
integer
响应状态码,成功时为 200
data
object
任务信息

使用场景

场景 1:批量提交素材(自动创建素材组)

不传 group_id,服务端自动创建 AIGC 类型素材组后提交素材。

场景 2:向已有素材组追加素材

传入 group_id,跳过素材组创建直接提交。

场景 3:单素材兼容写法

只提交一个素材时,可直接使用顶层 urlname 字段。

查询审核结果

素材提交后为异步审核任务,使用 获取任务状态 接口查询:

全部通过

部分失败

批量提交时,只要有一个素材审核失败,任务状态为 failed。已通过的素材仍可用,出现在 result.usable_assets
  • result.usable_assets[].asset_url 可直接用于 Seedance 2.0 视频生成
  • result.failed_assets 中的素材需更换源文件或重新提交
  • 单素材任务也会兼容返回 result.asset_url

审核后使用素材

审核通过后,将 asset://... URL 直接传入 Seedance 2.0 视频生成 接口:
服务端识别到 asset:// 前缀后,会直接提交官方生成任务,不会再次触发素材审核。