라이브 커튼 콘텐츠 생성

Prev Next

Classic/VPC 환경에서 이용 가능합니다.

라이브 커튼에 사용할 입력 콘텐츠를 생성합니다. Object Storage 버킷에 저장되어 있던 콘텐츠(원본)로 입력 콘텐츠를 생성하며, 생성한 입력 콘텐츠는 라이브 커튼에만 사용되고 버킷에 별도 저장되지 않습니다.

참고

라이브 커튼 콘텐츠 생성 시 다음 내용을 참고해 주십시오.

  • 라이브 커튼 콘텐츠는 계정당 최대 10개까지 생성할 수 있습니다.
  • Object Storage에 저장된 원본 콘텐츠를 수정하더라도 기존 등록된 커튼 콘텐츠는 업데이트되지 않습니다. 수정된 콘텐츠를 사용하려면 라이브 커튼 콘텐츠를 다시 생성해 주십시오.

요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

메서드 URI
POST /api/v2/curtainContents

요청 헤더

Live Station API에서 공통으로 사용하는 헤더에 대한 정보는 Live Station 요청 헤더를 참조해 주십시오.

요청 바디

요청 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
content Array Required 라이브 커튼 콘텐츠 정보: content

content

content에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
bucketName String Required 원본 콘텐츠 파일 저장 버킷 이름
filePath String Required 저장 상세 경로
  • /로 시작
  • 지원 가능 파일 확장자
    • 이미지: *.png, *.jpg, *.jpeg
    • 비디오: *.mp4
    • 오디오: *.aac, *.mp3, *.m4a
참고

원본 콘텐츠 파일 입력 시 다음 내용을 참고해 주십시오.

  • 파일당 최대 100MB까지 지원합니다.
  • 이미지 파일과 오디오 파일 동시 입력 시 1080p 해상도를 가진 5분 분량의 mp4 파일로 변환됩니다.
  • 이미지 파일만 입력 시 5분 분량의 mp4 파일로 변환됩니다.
  • 비디오 파일은 최대 10개까지 입력할 수 있습니다.
  • 오디오 파일만 입력하는 경우는 지원하지 않습니다.

요청 예시

요청 예시는 다음과 같습니다.

curl --location --request POST 'https://livestation.apigw.ntruss.com/api/v2/curtainContents' \
--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' \
--data '{
    "content": [
        {
            "bucketName": "mybucket",
            "filePath": "/data/abcd.png"
        },
        {
            "bucketName": "mybucket",
            "filePath": "/data/sound_nocopyright.mp3"
        }
    ]
}'

응답

응답 형식을 설명합니다.

응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
content Object - 응답 결과
content.id Integer - 콘텐츠 아이디
content.registerTime Integer - 콘텐츠 생성 일시(밀리초)
  • Unix Timestamp 형식
content.updatedTime Integer - 콘텐츠 업데이트 일시(밀리초)
  • Unix Timestamp 형식
content.status String - 콘텐츠 상태
  • CREATING | READY | PROCESSING_FAIL | DELETED
    • CREATING: 생성 중
    • READY: 준비
    • PROCESSING_FAIL: 생성 실패
    • DELETED: 삭제
content.input Array - 원본 콘텐츠 위치 목록
  • {버킷 이름}/{상세 경로} 형식

응답 상태 코드

Live Station API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Live Station 응답 상태 코드를 참조해 주십시오.

응답 예시

응답 예시는 다음과 같습니다.

{
    "content": {
        "id": 412,
        "registerTime": 1755579080117,
        "updatedTime": 1755579080117,
        "status": "CREATING",
        "input": [
            "mybucket/data/abcd.png",
            "mybucket/data/sound_nocopyright.mp3"
        ]
    }
}