クリエイティブ
Alpha

creative_video_filter

Creative フラグが有効な接続先ワークスペースで、保存済み動画に画素フィルターを適用します。

操作 書き込み。

パラメーター

パラメーター型必須説明
bodyobjectはい動画の処理設定。
body.video_urlstringはい同じワークスペースの保存済み動画 URL。最大 100 MB。
body.opsarrayいいえdim または crop を最大 8 件、適用順に指定します。
body.filtergraphstringいいえ許可された画素フィルターのグラフ。ops、filtergraph、または両方を指定します。
body.modestringいいえasync ならジョブ ID を即時に受け取れます。sync または subscribe は上限付き待機、webhook は終端通知です。
body.wait_timeout_secondsintegerいいえsync または subscribe の待機時間。0〜30 秒。
body.webhook_urlstringいいえ終端通知を受け取る公開 HTTPS URL。
body.project_idstringいいえ同じワークスペース内の保存先プロジェクト ID。
body.metadataobjectいいえジョブに保存する呼び出し元の補足情報。
idempotency_keystringはい同じリクエストの再試行時に同じキーを使います。

先に creative_video_filter_check で設定を検査してください。入力は最大 300 秒です。ops を順に適用してから filtergraph を適用し、新しい MP4 を保存します。

data.job.id を creative_jobs_wait に渡し、完了後に creative_jobs_result で出力を取得します。

プロンプト例

取り込んだ動画を 60% の明るさにし、処理後の MP4 を取得してください。