設定
動態攝取請求的設置是相同的,無論您是攝取視頻、圖像、腳本文件還是所有這些。有關請求正文字段的完整詳細信息,請參閱 API 參考。
- 請求網址
-
https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests
- 驗證
- 身份驗證需要一個訪問令牌作為
Bearer
令牌在Authorization
標頭:Authorization: Bearer {access_token}
關於 S3 的注意事項
如果您的成績單將從受保護的 S3 存儲桶中提取,您將需要設置存儲桶策略以允許 Video Cloud 訪問這些文件。如需詳細資訊,請參閱使用 S3 的動態內嵌。
攝取成績單文件
您還可以將腳本文件添加到您的視頻或使用動態攝取將它們上傳到現有視頻:
在視頻攝取期間添加成績單
請求網址
https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests
方法
POST
請求主體範例
{
"master": {
"url": "https://support.brightcove.com/test-assets/videos/Great_Blue_Heron.mp4"
},
"transcriptions": [
{
"url": "https://support.brightcove.com/test-assets/transcript/herons-transcript.txt",
"srclang": "en-US",
"kind": "transcripts",
"label": "English",
"default": true,
"status" : "published"
}
]
}
添加成績單現有視頻
向現有視頻添加轉錄本完全相同,只是您不需要請求正文中的任何視頻信息或個人資料。 除非您要求將封閉式成績單添加到 MP4 演繹版中 - 在這種情況下,您將需要替換視頻
請求網址
https://ingest.api.brightcove.com/v1/accounts/account_id/videos/video_id/ingest-requests
方法
POST
請求主體範例
{
"transcriptions": [
{
"url": "https://support.brightcove.com/test-assets/transcripts/herons.txt",
"srclang": "en-US",
"kind": "transcripts",
"label": "English",
"default": true,
"status" : "published"
}
]
}
攝取字段
下表詳細說明了用於獲取文字記錄或 請求自動字幕的字段。
欄位 | 類型 | 必填 | 描述 |
---|---|---|---|
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。必須包含的 種類 是 成績單 。必須不是被包括在內,如果種類 是字幕 .
|