CreateAsset を使用して Seedance 素材の事前フィルターを設定

CreateAsset リクエストの Moderation.Strategy を使用して、Seedance 素材登録時の事前フィルター戦略を設定します。

Seedance 2.0 または Seedance 2.5 で使用する素材を CreateAsset でアップロードする際に、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