---
title: "スナップショットの作成"
slug: "media-livestation-snapshot-snapshotcreate"
tags: ["Live Station"]
updated: 2026-09-17T09:58:13Z
published: 2026-09-17T09:58:13Z
canonical: "api.ncloud-docs.com/media-livestation-snapshot-snapshotcreate"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# スナップショットの作成

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

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

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

## リクエスト

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

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

### リクエストヘッダ

Live Station APIで共通して使用されるヘッダの詳細は、[Live Stationのリクエストヘッダ](/docs/ja/media-livestation#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `channelId` | String | Required | チャンネル ID - [チャンネルリストの照会](/docs/ja/media-livestation-channel-channellist)を参照 - 現在録画中のチャンネルに限る |

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

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

| フィールド | タイプ | 必須の有無 | 説明 |
| --- | --- | --- | --- |
| `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のレスポンスステータスコード](/docs/ja/media-livestation#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。

### レスポンス例

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

```
{
    "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
        }
    }
}
```