使用 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 時，只會調整本次素材上傳的內容預先篩選策略，不代表取消所有審核或安全限制。

處理上傳結果

請求成功受理後，儲存回應中的 Result.Id，此值為素材 ID。
呼叫查詢素材檢查處理狀態。
狀態變為 Active 後，在影片生成請求中使用 asset://ASSET_ID 引用素材；狀態為 Failed 時，請依錯誤資訊修正素材後重新上傳。

注意事項

Moderation.Strategy 只影響目前的 CreateAsset 請求。
素材 URL 必須可由伺服器直接存取，且素材類型應與 AssetType 一致。
素材群組、素材和呼叫憑證應屬於對應的帳戶、專案及服務區域。
著作權 IP、公眾人物及其他安全限制仍然有效。

BytePlus 官方參考資料

CreateAsset API