コンテンツにスキップ

動画のクリッピング

動画のクリッピングは、「トリミング」とも呼ばれ、動画の長さを変更することを指します。これにより、視聴者は動画の特定の「クリップ」だけを見ることができるように、動画の開始点と終了点を変更できます。たとえば、20分の動画があり、その中の5分間のクリップだけを共有したい場合、5分間のクリップの前後のコンテンツを削除して動画をクリップできます。

詳細については、動画クリッピングAPIドキュメントを参照してください。

前提条件

動画をクリップする前に、APIトークンが必要です。APIトークンの作成に関する詳細は、APIトークンの作成を参照してください。

必要なパラメータ

動画をクリップするには、既存の動画から新しい動画を作成するために使用する開始時間と終了時間を決定します。videoUIDと開始終了時間を使用してリクエストを行います。

必要なパラメータ
{
    "clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
    "startTimeSeconds": 20,
    "endTimeSeconds": 40
}
  • clippedFromVideoUID: 新しいクリップ動画を作成するために使用される動画の一意の識別子。
  • startTimeSeconds: 新しい動画が始まる既存の動画のタイムスタンプ。
  • endTimeSeconds: 新しい動画が終了する既存の動画のタイムスタンプ。

例: 動画をクリップする
curl --location --request POST 'https://api.cloudflare.com/client/v4/accounts/<YOUR_ACCOUND_ID_HERE>/stream/clip' \
--header 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
    "startTimeSeconds": 10,
    "endTimeSeconds": 15
    }'

アカウントをCloudflareダッシュボード ↗から選択した後、動画が再生可能かどうかを確認できます。クリップされた動画が処理中の間、動画のステータス応答はQueuedと表示されます。クリッピングプロセスが完了すると、動画のステータスはReadyに変わり、クリップされた動画の新しい名前と新しい長さが表示されます。

動画の処理が完了し、再生可能になったときに通知を受け取るには、Webhook通知を購読することができます。

動画名の設定

動画をクリップする際に、クリップされた動画の新しい名前を指定することもできます。以下の例では、nameフィールドがクリップされた動画に使用する新しい名前を示しています。

例: カスタム名を指定する
{
    "clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
    "startTimeSeconds": 10,
    "endTimeSeconds": 15,
    "meta": {
      "name": "overriding-filename-clip.mp4"
    }
}

動画がクリップされ、処理された後、あなたのCloudflareダッシュボードの動画リストに新しい名前の動画が表示されます。

ウォーターマークの追加

動画にカスタムウォーターマークを追加することもできます。ウォーターマークやウォーターマークプロファイルのアップロードに関する詳細は、ウォーターマークの適用を参照してください。

例: 動画をクリップし、新しい動画名を設定し、ウォーターマークを適用する
{
    "clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
    "startTimeSeconds": 10,
    "endTimeSeconds": 15,
    "watermark": {
        "uid": "4babd675387c3d927f58c41c761978fe"
    },
    "meta": {
      "name": "overriding-filename-clip.mp4"
    }
}

署名付きURLの要求

動画をクリップする際に、動画をプライベートにし、特定のユーザーのみがアクセスできるようにするには、署名付きURLを要求することができます。

例: 動画をクリップし、署名付きURLを要求する
{
    "clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
    "startTimeSeconds": 10,
    "endTimeSeconds": 15,
    "requireSignedURLs": true,
    "meta": {
      "name": "signed-urls-demo.mp4"
    }
}

動画のクリッピングが完了した後、Cloudflareダッシュボードと動画リストを開いて動画を見つけることができます。動画を選択すると、設定タブにRequire Signed URLsの横にチェックマークが表示されます。

サムネイル画像の指定

動画のサムネイル画像をパーセンテージ値を使用して指定することもできます。サムネイルのタイムスタンプを秒からパーセンテージに変換するには、使用したいタイムスタンプを動画の総再生時間で割ります。サムネイルに関する詳細は、サムネイルの表示を参照してください。

例: 50%の位置で生成されたサムネイルを持つ動画をクリップする
{
    "clippedFromVideoUID": "0ea62994907491cf9ebefb0a34c1e2c6",
    "startTimeSeconds": 10,
    "endTimeSeconds": 15,
    "thumbnailTimestampPct": 0.5,
    "meta": {
      "name": "thumbnail_percentage.mp4"
    }
}
Cloudflare DashboardDiscordCommunityLearning CenterSupport Portal
Cookie Settings