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

​

リクエスト

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. プラットフォームが素材のコピーを保存し, 選択したチャネルに利用可能な審査記録があるか確認します. 必要な場合だけ審査を開始します. 同じユーザー, URL, チャネルへの並行リクエストは準備処理を共有します.
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 を使ってください.
• 独立したコピーを保存します. 既定では 30 日を超えて未使用のコピーが削除対象になりますが, 実際の保存期間は設定によります. 動画の送信が受け付けられた時点で使用とみなし, 完成を待ちません. 削除後のリクエストでは再準備するため, 元の URL を引き続きアクセス可能にしてください.
• 同じ業務リクエストの通信再試行には同じ client_business_id を使用します. 既存のタスクが返され, 新しい動画タスクは作られません. 別の動画や失敗後の新しい試行には新しい業務 ID を使用します. 審査待ちを理由にタスクを繰り返し作成しないでください.
• 動画が送信されたか未確認の場合は, 元のタスクを照会するかサポートへ連絡し, すぐに新しい業務 ID で再送しないでください.

​

既存の素材 API との併用