AGTCloud API Docs
文档指南API Reference集成与资源更新与帮助
视频生成Seedance

使用 CreateAsset 配置 Seedance 素材预过滤

通过 CreateAsset 请求中的 Moderation.Strategy 配置 Seedance 素材入库预过滤策略。

调用 CreateAsset 上传供 Seedance 2.0 或 Seedance 2.5 使用的素材时,可以通过 Moderation.Strategy 配置本次素材入库的内容预过滤策略。

适用范围

此配置仅适用于支持相应设置的海外服务。版权 IP、公众人物等限制仍然生效。

配置前准备

  • 已创建素材组并取得 GroupId。
  • 素材 URL 可以由服务端直接访问。
  • 已根据素材内容选择 Image、Video 或 Audio 类型。

通过 CreateAsset 配置

curl -X POST \
  'https://api.agtcloud.cn/v1/assets/doubao/?Action=CreateAsset&Version=2024-01-01' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "GroupId": "group-xxxxxxxx",
    "URL": "https://example.com/portrait.png",
    "AssetType": "Image",
    "Moderation": {
      "Strategy": "Skip"
    }
  }'
字段说明
GroupId接收素材的素材组 ID
URL服务端可以访问的素材 URL
AssetType素材类型,例如 Image、Video 或 Audio
Moderation.Strategy本次素材上传使用的内容预过滤策略,配置值为 Skip

Strategy 设置为 Skip 时,只调整本次素材上传的内容预过滤策略,不代表取消所有审核或安全限制。

处理上传结果

  1. 请求成功受理后,保存响应中的 Result.Id,该值为素材 ID。
  2. 调用查询素材检查处理状态。
  3. 状态变为 Active 后,在视频生成请求中使用 asset://ASSET_ID 引用素材;状态为 Failed 时,根据错误信息修正素材后重新上传。

注意事项

  • Moderation.Strategy 只影响当前 CreateAsset 请求。
  • 素材 URL 必须能够由服务端直接访问,且素材类型应与 AssetType 一致。
  • 素材组、素材和调用凭证应属于对应的账户、项目及服务区域。
  • 版权 IP、公众人物及其他安全限制仍然生效。

BytePlus 官方参考资料

进一步了解

本页目录