Create Live Curtain content
- Print
- PDF
Create Live Curtain content
- Print
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
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.
- Creation of Live Curtain content is supported only for certain extensions and other extensions are not supported.
Requests
POST https://livestation.apigw.ntruss.com/api/v2/curtainContents
Request headers
| Header name | Required | Description |
|---|---|---|
| x-ncp-apigw-timestamp | YES | - 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-key | YES | Access key ID value issued from NAVER Cloud Platform portalx-ncp-iam-access-key:{Sub Account Access Key} |
| x-ncp-apigw-signature-v2 | YES | Signature encrypted with the access key ID value and secret keyx-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | YES | Specifies the request body content type as application/jsonContent-Type: application/json |
| x-ncp-region_code | YES | Region code (KR) |
Request bodies
| Field name | Required | Type | Service limits | Description |
|---|---|---|---|---|
| content | Yes | Array[Object] | Live Curtain content object | |
| bucketName | Yes | String | Bucket name of the content object storage to be created as Live Curtain content | |
| fileName | Yes | String | filePath of the content object storage to be created as Live Curtain content filePath must start with a slash (/) |
Responses
| Field name | Type | Description | Note |
|---|---|---|---|
| content | Object | Live Curtain content object | |
| content.id | Integer | Live Curtain content ID | |
| content.registerTime | Timestamp | Time of request for Live Curtain content creation | |
| content.updatedTime | Timestamp | Live Curtain content update time | |
| content.status | String | Status of Live Curtain content | CREATING,READY,PROCESSING_FAIL,DELETED |
| content.input | Array | Object 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"
}
]
}
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"
]
}
}
Was this article helpful?