クリエイティブ
Alpha

creative_video_trim

Creative フラグが有効な接続先ワークスペースで、保存済み動画を切り出します。

操作 書き込み。

パラメーター

パラメーター型必須説明
bodyobjectはい動画の処理設定。
body.video_urlstringはい同じワークスペースの保存済み動画 URL。最大 100 MB。
body.startnumberはい先頭から開始位置までの秒数。
body.endnumberいいえ終了位置の秒数。end と duration のどちらか一方を指定します。
body.durationnumberいいえ切り出す長さ。0.2〜900 秒。
body.precisionstringいいえ再エンコードは exact、ストリームコピーは keyframe。
body.audiostringいいえ音声を保持する keep、削除する drop。既定値は keep。
body.outputobjectいいえexact の場合に幅、高さ、フレームレートを指定できます。
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はい同じリクエストの再試行時に同じキーを使います。

入力は最大 1,800 秒、出力は最大 900 秒です。exact では切り出した区間を再エンコードします。keyframe では指定時刻より前のキーフレームから始まる場合があります。

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

プロンプト例

取り込んだ商品動画の 2 秒から 7 秒を音声付きで切り出し、新しい MP4 を取得してください。