라이브 커튼 콘텐츠 생성

Prev Next

Live Station의 라이브 커튼 콘텐츠 생성을 위한 API입니다. 생성한 라이브 커튼 콘텐츠 정보 조회를 위해 라이브 커튼 콘텐츠 정보 조회 API를 제공합니다.

참고
  • 라이브 커튼 콘텐츠
    • 라이브 커튼 기능 사용을 위한 input content로 네이버 클라우드 플랫폼 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/fin-v2/curtainContents
HTTP
헤더명 필수 여부 설명
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 네이버 클라우드 플랫폼 포털에서 발급받은 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 리전 코드 (FKR)
필드명 필수 여부 타입 제약 사항 설명
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"
    }
  ]
}
Plain text
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