Download subtitle
download_subtitleDownload one subtitle file by file_id and return its text (or a temporary link), with optional format conversion, FPS conversion or time shift. Each call uses one download from the user's daily OpenSubtitles quota, so pick the file with search_subtitles first; the result reports the remaining quota.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_id": "<file_id>"
},
"name": "download_subtitle"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| in_fps | No | Frame rate the subtitle was timed for (use with out_fps) | |
| file_id | Yes | file_id from search_subtitles or get_subtitle_details | |
| out_fps | No | Frame rate of your video (use with in_fps) | |
| delivery | No | content = return the subtitle text; link = return only a temporary download URL (for large files or saving to disk) | content |
| timeshift | No | Shift all cues by this many seconds, e.g. 2.5 or -1 | |
| sub_format | No | Convert to this format. Omit to keep the original (usually srt). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| link | Yes | Temporary download URL (valid for a few hours) | |
| quota | Yes | ||
| format | Yes | ||
| content | Yes | Subtitle text (delivery=content) | |
| file_id | Yes | ||
| file_name | Yes | ||
| mime_type | Yes | ||
| truncated | Yes | ||
| size_bytes | Yes |