Yandex Cloud
Search
Contact UsGet started
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • AI for business
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
  • Pricing
  • Customer Stories
  • Documentation
  • Blog
© 2025 Direct Cursus Technology L.L.C.
Yandex Cloud Video
    • Overview
    • Control
    • Troubleshooting
    • Browser autoplay policy
  • Access management
  • Pricing policy
    • API authentication
    • Getting started with the API
      • Overview
        • Overview
        • Get
        • List
        • Create
        • GenerateUploadURL
        • Delete
  • Audit Trails events
  • Release notes

In this article:

  • gRPC request
  • GetSubtitleRequest
  • Subtitle
  1. API reference
  2. gRPC
  3. Subtitle
  4. Get

Video API, gRPC: SubtitleService.Get

Written by
Yandex Cloud
Updated at November 25, 2025
  • gRPC request
  • GetSubtitleRequest
  • Subtitle

Retrieves detailed information about a specific subtitle by its ID.
Returns all subtitle metadata and related information.

gRPC requestgRPC request

rpc Get (GetSubtitleRequest) returns (Subtitle)

GetSubtitleRequestGetSubtitleRequest

{
  "subtitle_id": "string"
}

Field

Description

subtitle_id

string

Required field. ID of the subtitle to retrieve.

The maximum string length in characters is 50.

SubtitleSubtitle

{
  "id": "string",
  "language": "string",
  "label": "string",
  "status": "SubtitleStatus",
  "source_type": "SubtitleSourceType",
  "filename": "string",
  "created_at": "google.protobuf.Timestamp",
  "updated_at": "google.protobuf.Timestamp",
  // Includes only one of the fields `video_id`
  "video_id": "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.

  • SUBTITLE_STATUS_UNSPECIFIED: The subtitle status is not specified.
  • WAIT_UPLOADING: The subtitle file upload is in progress, waiting for all bytes to be received.
  • UPLOADED: The subtitle file has been fully uploaded and is ready for use.

source_type

enum SubtitleSourceType

Indicates how the subtitle was created or obtained.

  • SUBTITLE_SOURCE_TYPE_UNSPECIFIED: The subtitle source type is not specified.
  • MANUAL: The subtitle was manually created and uploaded by a user.
  • GENERATED: The subtitle was automatically generated through speech recognition.

filename

string

Original filename of the subtitle file.

created_at

google.protobuf.Timestamp

Timestamp when the subtitle was initially created in the system.

updated_at

google.protobuf.Timestamp

Timestamp of the last modification to the subtitle or its metadata.

video_id

string

Identifier of the video this subtitle belongs to.

Includes only one of the fields video_id.

Specifies the parent content this subtitle is associated with.

Was the article helpful?

Previous
Overview
Next
List
© 2025 Direct Cursus Technology L.L.C.