서문
Brightcove Auto Captioning은 31개 언어로 된 새 비디오 또는 기존 비디오의 캡션을 자동으로 생성할 수 있는 플랫폼 수준 서비스입니다(지정된 언어에 대한 오디오 트랙이 있는 경우). 모든 음성-텍스트 서비스와 마찬가지로 Auto Captioning은 100% 정확하지는 않지만 Video Cloud에서 바로 캡션을 생성하는 빠르고 쉬운 방법을 제공합니다.
Video Cloud는 캡션을 생성하는 데 사용할 소스를 결정하기 위해 다음 프로세스를 사용합니다.
- 비디오에 기본 오디오 트랙이 있는 경우 캡션 소스 파일로 사용됩니다(미디어 모듈에서 기본적으로 지원됨).
- 비디오에 기본 오디오 트랙이 없지만 마스터/메자닌 파일이 있는 경우 소스 파일로 사용됩니다(미디어 모듈에서 기본적으로 지원됨).
- 비디오에 기본 오디오 트랙이나 마스터/메자닌 파일이 없지만 Dynamic Ingest 호출에 오디오 트랙이 지정된 경우 지정된 오디오 트랙이 사용됩니다(미디어 모듈에서는 아직 지원되지 않음).
- 비디오에 기본 오디오 트랙이 없고 마스터/메자닌 파일이 없고 오디오 트랙이 지정되지 않은 경우 캡션을 생성할 수 없습니다.
설정
Dynamic Ingest요청 설정은 동영상, 이미지, 오디오 트랙, WebVTT파일을 인제스트하든, 자동 자막을 요청하든, 다음 모두를 요청하든 동일합니다.
- 요청 URL
-
https://ingest.api.brightcove.com/v1/accounts/{account_id}/videos/{video_id}/ingest-requests - 인증
- 인증에는 다음으로 전달된 액세스 토큰이 필요합니다.
Bearer토큰Authorization머리글:Authorization: Bearer {access_token}액세스 토큰을 얻으려면 다음이 필요합니다. 클라이언트 자격 증명 (아래 참조). 액세스 토큰을 얻는 과정은 액세스 토큰가져오기를 참조하십시오 .
S3에 대한 참고 사항
보호된 S3 버킷에서 소스 파일을 가져오는 경우 파일에 액세스할 수 있도록Video Cloud버킷 정책을 설정해야 합니다. 보다사용Dynamic Ingest S3와 함께자세한 내용은
자격 증명 가져오기
광고를 받으려면 OAuth UI로 이동하여 다음 앱을 등록해야 합니다. client_idclient_secret
다음은 필요한 권한입니다.
또는 온라인 앱을 통해CURL자격 증명을 받을 수도 있습니다. 다음을 참조하십시오. Postman
API에서 직접 자격 증명을 얻는 경우 필요한 권한은 다음과 같습니다.
[
"video-cloud/video/all",
"video-cloud/ingest-profiles/profile/read",
"video-cloud/ingest-profiles/account/read",
"video-cloud/upload-urls/read"
]사용 사례
다음은 몇 가지 일반적인 사용 사례입니다.
새로운 처리 또는 재트랜스코딩을 위한 자동 캡션 생성
요청 본문
{
"master": {
"use_archived_master": true
},
"profile": "multi-platform-standard-static-with-mp4",
"transcriptions": [
{
"srclang": "EN-us",
"kind": "captions",
"label": "English",
"status" : "published",
"default": true
}
],
"priority": "normal"
}오디오 트랙을 수집할 때 자동 캡션 생성
요청 본문
{
"audio_tracks": {
"merge_with_existing": true,
"masters": [
{
"language": "fr-FR",
"variant": "alternate",
"url": "https://support.brightcove.com/test-assets//audio/celtic_lullaby.m4a"
}
]
},
"transcriptions": [
{
"srclang": "fr-FR",
"kind": "captions",
"label": "french-FR",
"status" : "published",
"default": false,
"input_audio_track": {
"language": "fr-FR",
"variant": "alternate"
}
}
]
}디지털 마스터를 사용하여 기존 비디오에 대한 자동 캡션 생성
요청 본문
{
"transcriptions": [
{
"srclang": "fr-FR",
"kind": "captions",
"label": "french-FR",
"default": false
}
]
}오디오 트랙을 정의하는 기존 비디오에 대한 자동 캡션 생성
요청 본문
{
"transcriptions": [
{
"srclang": "en-US",
"kind": "captions",
"label": "english-EN",
"default": false,
"input_audio_track": {
"language": "en-US",
"variant": "main"
}
},
{
"srclang": "fr-FR",
"kind": "captions",
"label": "french-FR",
"default": false,
"input_audio_track": {
"language": "fr-FR",
"variant": "alternate"
}
}
]
}자동 캡션에 대한 본문 필드 요청
아래 표는 자동 캡션에 대한 요청 본문 필드를 보여줍니다.
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
autodetect |
부울 | 아니요 |
true오디오 소스에서 언어를 자동 감지합니다. false오디오 언어를srclang지정하는 데 사용할 수 있습니다.
|
default |
부울 | 아니요 |
true가srclang무시되고 기본 오디오 트랙이 사용되는 경우 언어가 자동 감지됩니다.
|
input_audio_track |
목적 | 아니요 | 여러 오디오 트랙의 경우 캡션을 추출할 오디오를 정의합니다. 언어와 변형으로 구성됩니다(둘 다 필수). |
kind |
끈 | 아니요 |
생성할 출력의 종류입니다. 허용되는 값:
|
label |
끈 | 아니요 | 사람이 읽을 수 있는 라벨. 기본값은 BCP-47 스타일 언어 코드입니다. |
srclang |
끈 | 아니요 | 텍스트 트랙용 BCP-47 스타일 언어 코드(en-US, fr-FR, es-ES 등) 지원되는 언어 보기 |
status |
끈 | 아니요 |
캡션의 실제 상황을 나타냅니다. published , draft .
|
url |
끈 | 아니요 |
성적표 파일이 있는 URL입니다. 종류 에 포함되어야 하는 것은 transcripts 입니다. 해야 하다 ~ 아니다경우 포함됩니다. 친절한 ~이다캡션 .
|
input_audio_track필드
| 필드 | 유형 | 필수 | 설명 |
|---|---|---|---|
language |
끈 | 예 | 텍스트 트랙용 BCP-47 스타일 언어 코드(en-US, fr-FR, es-ES 등) 지원되는 언어 보기 |
variant |
끈 | 예 |
사용할 변형을 지정합니다.
|
지원되는 언어
현재 자동 캡션은 다음 언어로 제한됩니다.
|
|