Video API, REST: Subtitle.Get
Retrieves detailed information about a specific subtitle by its ID.
Returns all subtitle metadata and related information.
HTTP request
GET https://video.api.cloud.yandex.net/video/v1/subtitles/{subtitleId}
Path parameters
|
Field |
Description |
|
subtitleId |
string Required field. ID of the subtitle to retrieve. The maximum string length in characters is 50. |
Response
HTTP Code: 200 - OK
{
"id": "string",
"language": "string",
"label": "string",
"status": "string",
"sourceType": "string",
"filename": "string",
"createdAt": "string",
"updatedAt": "string",
// Includes only one of the fields `videoId`
"videoId": "string"
// end of the list of possible fields
}
Entity representing a subtitle track that can be associated with a video.
Subtitles provide text versions of the audio content, enabling accessibility
and multilingual support for video content.
|
Field |
Description |
|
id |
string Unique identifier of the subtitle track. |
|
language |
string Language of the subtitle content according to ISO 639-2/T. |
|
label |
string Display label for the subtitle track shown in the video player's subtitle selection menu. |
|
status |
enum (SubtitleStatus) Current processing status of the subtitle.
|
|
sourceType |
enum (SubtitleSourceType) Indicates how the subtitle was created or obtained.
|
|
filename |
string Original filename of the subtitle file. |
|
createdAt |
string (date-time) Timestamp when the subtitle was initially created in the system. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the |
|
updatedAt |
string (date-time) Timestamp of the last modification to the subtitle or its metadata. String in RFC3339 text format. The range of possible values is from To work with values in this field, use the APIs described in the |
|
videoId |
string Identifier of the video this subtitle belongs to. Includes only one of the fields Specifies the parent content this subtitle is associated with. |