ライブカーテンコンテンツの作成
- 印刷する
- PDF
ライブカーテンコンテンツの作成
- 印刷する
- PDF
記事の要約
この要約は役に立ちましたか?
ご意見ありがとうございます
Live Stationのライブカーテンの作成のための APIです。作成したライブカーテンのコンテンツ情報の照会のために、ライブカーテンコンテンツリスト情報の照会 APIを提供します。
参考
- ライブカーテンのコンテンツ
- ライブカーテン機能を使用するための input contentで、NAVERクラウドプラットフォーム object storageに保存されたコンテンツをライブカーテンコンテンツとして作成できます。
- 作成したライブカーテンコンテンツは、ライブカーテン機能の活用に使用できます。
- 作成されたライブカーテンコンテンツはバケットに保存されず、ライブカーテン機能でのみ活用されます。
- 作成したライブカーテンコンテンツは、ライブカーテンコンテンツ削除 APIにて削除できます。
注意
- ライブカーテンコンテンツの作成時のご注意
- 特定の拡張子に対してのみライブカーテンコンテンツの作成をサポートし、その他の拡張子はサポートしません。
- img : *.png, *.jpg, *.jpeg
- video : *.mp4
- audio : *.aac, *.mp3, *.m4a
- 画像ファイルとオーディオファイルを同時に入力する場合、*.mp4に変換されたライブコンテンツの作成をサポートします。
- 5分分量の1080p解像度に変換された *.mp4を提供します。
- 単一イメージファイル入力時に *.mp4に変換されたライブコンテンツの作成をサポートします。
- 5分分量の *.mp4を提供します。
- オーディオ単一ファイルの入力はサポートしません。
- *.mp4ファイルは最大10個まで入力できます。
- 単一のファイルサイズは100MBを超えることはできません。
- ライブカーテンコンテンツは、アカウント当たり最大10個まで作成できます。
- 特定の拡張子に対してのみライブカーテンコンテンツの作成をサポートし、その他の拡張子はサポートしません。
リクエスト
POST https://livestation.apigw.ntruss.com/api/v2/curtainContents
リクエストヘッダ
| ヘッダ名 | 必須有無 | 説明 |
|---|---|---|
| x-ncp-apigw-timestamp | YES | - 1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表したもの - API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | YES | NAVERクラウドプラットフォームポータルから発行された Access Key ID値x-ncp-iam-access-key:{Sub Account Access Key} |
| x-ncp-apigw-signature-v2 | YES | Access Key ID値と Secret Keyで暗号化した署名x-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | YES | Request body content typeを application/jsonに指定Content-Type: application/json |
| x-ncp-region_code | YES | リージョンコード(KR) |
リクエストボディ
| フィールド名 | 必須有無 | タイプ | 制限事項 | 説明 |
|---|---|---|---|---|
| content | Yes | Array[Object] | ライブカーテンのコンテンツオブジェクト | |
| bucketName | Yes | String | ライブカーテンコンテンツとして作成するコンテンツ Object Storageのバケット名 | |
| fileName | Yes | String | ライブカーテンコンテンツとして作成するコンテンツ Object Storageの filePath filePathは斜線( / )から始めなければならない |
レスポンス
| フィールド名 | タイプ | 説明 | 備考 |
|---|---|---|---|
| content | Object | ライブカーテンのコンテンツオブジェクト | |
| content.id | Integer | ライブカーテンのコンテンツ ID | |
| content.registerTime | Timestamp | ライブカーテンコンテンツ作成リクエスト時間 | |
| content.updatedTime | Timestamp | ライブカーテンコンテンツアップデート時間 | |
| content.status | String | ライブカーテンのコンテンツ状態 | CREATING,READY,PROCESSING_FAIL,DELETED |
| content.input | Array | ライブカーテンコンテンツとして作成するコンテンツの Object Storageパス(bucketName/filePath) |
例
リクエスト例
# Request body
{
"content": [
{
"bucketName": "myTestBucket",
"filePath": "/image.jpg"
},
{
"bucketName": "myTestBucket",
"filePath": "/audio.aac"
}
]
}
レスポンス例
HTTP/1.1 200 OK
Server: nginx
Date: Fri, 19 Jul 2022 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4
{
"content": {
"id": 1128,
"registerTime": 1658194323266,
"updatedTime": 1658194323266,
"status": "CREATING",
"input": [
"myTestBucket/image.jpg",
"myTestBucket/audio.aac"
]
}
}
この記事は役に立ちましたか?