クリエイティブ
Alphacreative_video_trim
Creative フラグが有効な接続先ワークスペースで、保存済み動画を切り出します。
操作 書き込み。
パラメーター
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
body | object | はい | 動画の処理設定。 |
body.video_url | string | はい | 同じワークスペースの保存済み動画 URL。最大 100 MB。 |
body.start | number | はい | 先頭から開始位置までの秒数。 |
body.end | number | いいえ | 終了位置の秒数。end と duration のどちらか一方を指定します。 |
body.duration | number | いいえ | 切り出す長さ。0.2〜900 秒。 |
body.precision | string | いいえ | 再エンコードは exact、ストリームコピーは keyframe。 |
body.audio | string | いいえ | 音声を保持する keep、削除する drop。既定値は keep。 |
body.output | object | いいえ | exact の場合に幅、高さ、フレームレートを指定できます。 |
body.mode | string | いいえ | async ならジョブ ID を即時に受け取れます。sync または subscribe は上限付き待機、webhook は終端通知です。 |
body.wait_timeout_seconds | integer | いいえ | sync または subscribe の待機時間。0〜30 秒。 |
body.webhook_url | string | いいえ | 終端通知を受け取る公開 HTTPS URL。 |
body.project_id | string | いいえ | 同じワークスペース内の保存先プロジェクト ID。 |
body.metadata | object | いいえ | ジョブに保存する呼び出し元の補足情報。 |
idempotency_key | string | はい | 同じリクエストの再試行時に同じキーを使います。 |
入力は最大 1,800 秒、出力は最大 900 秒です。exact では切り出した区間を再エンコードします。keyframe では指定時刻より前のキーフレームから始まる場合があります。
data.job.id を creative_jobs_wait に渡し、完了後に creative_jobs_result で出力を取得します。
プロンプト例
取り込んだ商品動画の 2 秒から 7 秒を音声付きで切り出し、新しい MP4 を取得してください。