動画タスク内で素材を審査する

​

リクエスト

curl --request POST \
  --url https://toapis.com/v1/videos/generations \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "seedance-2",
    "client_business_id": "avatar-demo-001",
    "prompt": "Animate the character in image 1 using the movement in video 1.",
    "duration": 5,
    "aspect_ratio": "16:9",
    "image_with_roles": [
      {"url": "https://files.example.com/avatar.jpg", "role": "reference_image"}
    ],
    "video_with_roles": [
      {"url": "https://files.example.com/motion.mp4", "role": "reference_video"}
    ],
    "private_asset_review": true
  }'

​

結果の確認

1. 受理されたリクエストは動画タスクを返します. HTTP 接続で審査完了まで待つ方式ではありません. タスクの受理は審査通過や動画生成開始を意味しません.
2. 素材ライブラリに対応するチャネルでは, 再利用できる記録を確認します. 記録がなければ素材を保存し, チャネルごとの各素材に専用グループを自動作成して審査を申請します. 同じユーザー, 素材の取得元, チャネルへの並行リクエストは準備処理を共有し, グループ作成や審査を重複して行いません.
3. このラウンドで審査が必要な全素材の通過後に動画生成を送信します. 初回の準備には数分かかることがあり, 利用可能な記録があれば再審査を省略します. 素材ライブラリに非対応のチャネルは従来のメディア処理と生成を行い, この機能用の素材コピーやグループは作成しません. 動画生成は引き続き非同期です.

curl --request GET \
  --url https://toapis.com/v1/videos/generations/avatar-demo-001 \
  --header 'Authorization: Bearer YOUR_API_KEY'

​

再利用, 再試行, 保存期間

• 次回も素材と private_asset_review: true を送信します. 素材 ID の保存は不要です. 審査が必要なチャネルでは, 同じユーザーとチャネル内で URL は完全なアドレス, Base64 画像はデコード内容のハッシュで照合します. 内容が同じ純粋な Base64 と data URI は同じ記録を再利用します. ユーザーやチャネルをまたいだ共有は行いません.
• URL が変わると新しい素材として扱います. 同じ URL の内容変更をファイル内容から検出する仕組みではないため, 更新時は新しいバージョンの URL を使ってください.
• 審査が必要な場合はチャネルごとに独立したコピーを保存します. 現在の既定の削除基準は 60 日間未使用であることですが, 実際の保存期間は設定によります. 自動作成したグループも素材コピーとともに削除し, 旧 API の素材や共有グループはこの処理の対象にしません. 動画の送信が受け付けられた時点で使用とみなし, 完成を待ちません. 削除後は再準備するため, 元の URL を引き続きアクセス可能にしてください.
• 同じ業務リクエストの通信再試行には同じ client_business_id を使用します. 既存のタスクが返され, 新しい動画タスクは作られません. 別の動画や失敗後の新しい試行には新しい業務 ID を使用します. 審査待ちを理由にタスクを繰り返し作成しないでください.
• 動画が送信されたか未確認の場合は, 元のタスクを照会するかサポートへ連絡し, すぐに新しい業務 ID で再送しないでください.

​

既存の素材 API との併用