ライブカーテンコンテンツの作成

印刷する
共有
Twitter
Linkedin
Facebook
Email
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"
    ]
  }
}

この記事は役に立ちましたか?

リクエスト
- リクエストヘッダ
- リクエストボディ
レスポンス
例
- リクエスト例
- レスポンス例

タグ