スナップショットの作成

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

配信中ライブチャンネルのショートクリップを作成するために、スナップショットを作成します。チャンネルが録画中の状態でのみスナップショットを作成できます。スナップショットの作成時、次の内容をご確認ください。

録画時間が100ms以上蓄積されてから作成できるようになります。
録画開始から終了まで、最大4時間分を作成できます。
- 録画時間が4時間を超える場合は、最後の4時間分をサポートします。
録画を再開すると、既存のスナップショット時点もリセットされます。
リクエスト時点に応じて複数のスナップショットを作成できます。

リクエスト

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

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

リクエストヘッダ

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

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

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

フィールド	タイプ	必須の有無	説明
`channelId`	String	Required	チャンネル ID チャンネルリストの照会を参照現在録画中のチャンネルに限る

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

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

フィールド	タイプ	必須の有無	説明
`limitedDuration`	Integer	Optional	スナップショット作成時間(分) 1~240 現時点から逆算して保存する再生時間入力しない場合、配信開始点から現在までの全時間を保存(最大4時間) <例> 配信開始から01:00:00の時点に `limitedDuration=1`とリクエストすると00:59:00~01:00:00区間のスナップショットを作成

リクエスト例

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

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/channels/ls-20250814******-zTwK2/snapshot?limitedDuration=8' \
--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'

レスポンス

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

レスポンスボディ

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

フィールド	タイプ	必須の有無	説明
`content`	Object	-	レスポンス結果
`content.channelId`	String	-	チャンネル ID
`content.channelStatus`	String	-	チャンネルの状態 `CREATING` \| `READY` \| `PUBLISHING` \| `DELETED` \| `BLOCK` \| `FORCE_BLOCK` \| `FORCE_DELETED` `CREATING`: 作成中 `READY`: 準備完了 `PUBLISHING`: 配信中 `DELETED`: 削除完了 `BLOCK`: 停止 `FORCE_BLOCK`: 強制停止 `FORCE_DELETED`: 使用不可
`content.snapshot`	Object	-	スナップショット情報
`content.snapshot.snapshotId`	Integer	-	スナップショット ID 今後スナップショット照会時に必要
`content.snapshot.snapshotUrl`	String	-	スナップショット再生 URL 作成時点から1時間有効 (期限切れ後は照会できない)
`content.snapshot.createdTime`	Integer	-	スナップショット作成日時(ミリ秒) Unix Timestamp形式
`content.snapshot.expireTime`	Integer	-	スナップショット期限日時(ミリ秒) Unix Timestamp形式
`content.snapshot.duration`	Integer	-	スナップショットリクエスト時間(分) `limitedDuration`が設定された場合、表示

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

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

レスポンス例

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

{
    "content": {
        "channelId": "ls-20250814******-zTwK2",
        "channelStatus": "PUBLISHING",
        "snapshot": {
            "snapshotId": 7526,
            "snapshotUrl": "https://*************.edge.naverncp.com/dvr/snapshot/1755508932161/als-nmssenc02/l6f07uzuaex2hriziguozw291avx4xqfrf6k/480p-16-9/7526-1755505332161.m3u8",
            "createdTime": 1755505332161,
            "expireTime": 1755508932161,
            "duration": 8
        }
    }
}