MENU
      Create Live Curtain content

        Create Live Curtain content


        Article summary

        An API to create Live Curtain content in Live Station. Provides the Live Curtain content information view API to view the created Live Curtain content information.

        Note
        • Live Curtain content
          • Content saved in NAVER Cloud Platform object storage can be used as input content for using the functions of the created Live Curtain content.
          • Created Live Curtain content can be used when using Live Curtain functions.
            • Created Live Curtain content are not stored in buckets and are used only for Live Curtain functions.
            • Created Live Curtain content can be deleted when using Live Curtain content deletion API.
        Caution
        • Cautions for creating Live Curtain content
          • Creation of Live Curtain content is supported only for certain extensions and other extensions are not supported.
            • img : *.png, *.jpg, *.jpeg
            • video : *.mp4
            • audio : *.aac, *.mp3, *.m4a
          • If image files and audio files are simultaneously entered, creation of live content converted to *.mp4 is supported.
            • Provides 5-minute long *.mp4 converted to 1080p resolution.
          • If single image files are entered, creation of live content converted to *.mp4 is supported.
            • Provides 5-minute long *.mp4.
          • Entering single audio files is not supported.
          • Up to 10 *.mp4 files can be entered.
          • The size of a single file cannot exceed 100 MB.
          • Up to 10 live curtain content can be created for each account.

        Requests

        POST https://livestation.apigw.ntruss.com/api/v2/curtainContents
        HTTP

        Request headers

        Header nameRequiredDescription
        x-ncp-apigw-timestampYES- Time elapsed since January 1, 1970 00:00:00 UTC in milliseconds
        - The request is considered invalid if the time difference compared to the API Gateway server is 5 minutes or longer
        x-ncp-apigw-timestamp:{Timestamp}
        x-ncp-iam-access-keyYESAccess key ID value issued from NAVER Cloud Platform portal
        x-ncp-iam-access-key:{Sub Account Access Key}
        x-ncp-apigw-signature-v2YESSignature encrypted with the access key ID value and secret key
        x-ncp-apigw-signature-v2:{API Gateway Signature}
        Content-TypeYESSpecifies the request body content type as application/json
        Content-Type: application/json
        x-ncp-region_codeYESRegion code (KR)

        Request bodies

        Field nameRequiredTypeService limitsDescription
        contentYesArray[Object]Live Curtain content object
        bucketNameYesStringBucket name of the content object storage to be created as Live Curtain content
        fileNameYesStringfilePath of the content object storage to be created as Live Curtain content
        filePath must start with a slash (/)

        Responses

        Field nameTypeDescriptionNote
        contentObjectLive Curtain content object
        content.idIntegerLive Curtain content ID
        content.registerTimeTimestampTime of request for Live Curtain content creation
        content.updatedTimeTimestampLive Curtain content update time
        content.statusStringStatus of Live Curtain contentCREATING,READY,PROCESSING_FAIL,DELETED
        content.inputArrayObject storage path (bucketName/filePath) of content to be created as Live Curtain content

        Examples

        Request examples

        # Request body
        {
          "content": [
            {
              "bucketName": "myTestBucket",
              "filePath": "/image.jpg"
            },
           {
              "bucketName": "myTestBucket",
              "filePath": "/audio.aac"
            }
          ]
        }
        Plain text

        Response examples

        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"
            ]
          }
        }
        HTTP

        Was this article helpful?

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.