라이브 커튼 콘텐츠 생성
- 인쇄
- PDF
라이브 커튼 콘텐츠 생성
- 인쇄
- PDF
Article Summary
Share feedback
Thanks for sharing your feedback!
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/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 | 네이버 클라우드 플랫폼 포털에서 발급받은 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"
]
}
}
이 문서가 도움이 되었습니까?