ショートクリップの作成

Prev Next

Classic/VPC環境で利用できます。

配信中ライブチャンネルのショートクリップをスナップショットで作成します。チャンネルがREADYまたはPUBLISHINGの状態でのみショートクリップを作成できます。作成されたショートクリップを利用して素早く VODサービスを提供することができ、ショート動画コンテンツとしても活用できます。ショートクリップの作成時は、次の内容をご確認ください。

  • 最小100ms、最大4時間分を作成できます。
  • チャンネルに設定されたタイムシフトを使用すると目的の時点のショートクリップを作成できます。
  • 作成されたショートクリップは、NAVERクラウドプラットフォームの Object Storageバケットに mp4ファイルとして自動アップロードされます。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

メソッド URI
POST /api/v2/channels/{channelId}/{snapshotId}

リクエストヘッダ

Live Station APIで共通して使用されるヘッダの詳細は、Live Stationのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
channelId String Required チャンネル ID
snapshotId String Required スナップショット ID

リクエストボディ

リクエストボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
startTime Integer Required ショートクリップ開始点(ミリ秒)
  • スナップショット再生時間基準の開始点
  • 0から入力可能
endTime Integer Required ショートクリップ終了点(ミリ秒)
  • スナップショット再生時間基準の終了点
  • startTimeの100ms以降から入力可能
shortclip Object Required ショートクリップ保存設定
shortclip.output Object Required 保存情報
shortclip.output.accessControl String Required 公開範囲
  • PRIVATE (デフォルト) | PUBLIC_READ
    • PRIVATE: 非公開
    • PUBLIC_READ: 公開
shortclip.output.bucketName String Required Object Storageバケット名
shortclip.output.filePath String Required 保存場所の詳細パス
  • /で始まる
参考

リクエストボディの入力時、下記の内容をご確認ください。

  • startTime、endTimeは、スナップショットの相対的な再生時間を入力してください。
    <例> startTime=0、endTime=1500でリクエストするとスナップショットの0~1.5秒区間(00:00:000 ~ 00:00:015)でショートクリップを作成
  • endTime - startTime値は、スナップショット再生時間を超えることはできません。

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/7548' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'x-ncp-region_code: KR' \
--header 'Content-Type: application/json' \
--data '{
    "startTime": 0,
    "endTime": 60000,
    "shortclip": {
        "output": {
            "accessControl": "PRIVATE",
            "bucketName": "mybucket",
            "filePath": "/shortclip"
        }
    }
}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
content Object - レスポンス結果
content.channelId String - チャンネル ID
content.snapshotId String - スナップショット ID
content.shortclip Object - ショートクリップ保存設定
content.shortclip.id Integer - ショートクリップ ID
content.shortclip.status String - ショートクリップの状態
  • CREATING | COMPLETED | PROCESSING_FAIL | UPLOAD_FAIL
    • CREATING: 作成中
    • COMPLETED: 完了
    • PROCESSING_FAIL: 作成失敗
    • UPLOAD_FAIL: アップロード失敗
content.shortclip.createdTime Integer - ショートクリップ作成日時(ミリ秒)
  • Unix Timestamp形式
content.shortclip.updatedTime Integer - ショートクリップ更新日時(ミリ秒)
  • Unix Timestamp形式
content.shortclip.output Object - ショートクリップ保存情報
content.shortclip.output.accessControl String - ショートクリップファイル保存場所の公開範囲
  • PRIVATE | PUBLIC_READ
    • PRIVATE: 非公開
    • PUBLIC_READ: 公開
content.shortclip.output.bucketName String - ショートクリップファイル保存場所バケット名
content.shortclip.output.filePath String - 保存場所の詳細パス
content.shortclip.output.fileName String - ショートクリップファイル名

レスポンスステータスコード

Live Station APIで共通して使用されるレスポンスステータスコードの詳細は、Live Stationのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "content": {
        "channelId": "ls-20250814******-zTwK2",
        "snapshotId": 7548,
        "shortclip": {
            "id": 1403,
            "status": "CREATING",
            "createdTime": 1755566018278,
            "updatedTime": 1755566018277,
            "output": {
                "accessControl": "PRIVATE",
                "bucketName": "mybucket",
                "filePath": "/shortclip",
                "fileName": "1403-1755566018278.mp4"
            }
        }
    }
}