# Subtitle Translator — SRT & VTT (`dami_studio/subtitle-translator`) Actor Translate subtitles into many languages at once. Paste an SRT/VTT file (or give a video URL to auto-transcribe), pick target languages, and get clean translated SRT + VTT back — timings preserved. For localization, accessibility, and multi-language publishing. - **URL**: https://apify.com/dami\_studio/subtitle-translator.md - **Developed by:** [Dami's Studio](https://apify.com/dami_studio) (community) - **Categories:** Videos, For creators, AI - **Stats:** 2 total users, 1 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $50.00 / 1,000 subtitle languages This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Subtitle Translator (SRT & VTT) Translate a subtitle file into several languages in one run. Paste in an SRT or VTT, or hand it a video URL to transcribe first, choose your target languages, and get back clean translated SRT and VTT with the original timings untouched. Built for localization and accessibility work where you need the same captions in five languages without re-doing the timing by hand. ### How it works It parses your input into cues, sends the text (not the timestamps) to an AI model for translation, and re-emits each cue with its original start/end times. If you pass a `videoUrl` instead of subtitle text, it transcribes the audio first and then translates the result. ### Input | Field | Required | Notes | |---|---|---| | `targetLanguages` | yes | List of ISO 639-1 codes, e.g. `["es", "fr", "de"]`. One result per language. | | `subtitles` | one of these | Raw SRT or VTT text to translate. | | `videoUrl` | one of these | Video link to transcribe first, then translate. Use this when you don't already have a subtitle file. | | `outputFormat` | no | `srt`, `vtt`, or `both`. Defaults to both. | | `openaiApiKey` | no | Your own OpenAI key for the translation/transcription step. Without one, runs fall back to the default quota where available. | Provide either `subtitles` or `videoUrl`, not both. `targetLanguages` is the only field you always have to set. ### Output The dataset holds one item per target language, each with the translated subtitle file as text in the requested format(s). Key fields: `language` (the ISO code), `srt` and/or `vtt` (the translated content), and `format`. Original cue timings are preserved exactly, so the output drops straight back into your player or editor. ### Example ```json { "subtitles": "1\n00:00:01,000 --> 00:00:04,000\nHello, welcome to the show.\n", "targetLanguages": ["es", "fr", "de"], "outputFormat": "both" } ```` ### Pricing $0.05 per language, pay per result, no subscription. Bring your own OpenAI key for the AI translation and transcription steps. ### Notes Translation quality tracks the underlying model, so long idioms and very domain-specific terms may need a human pass. Transcribing from a `videoUrl` adds time and depends on the audio being clear; if you already have accurate captions, pasting the subtitle text directly is faster and more reliable. # Actor input Schema ## `subtitles` (type: `string`): Paste your SRT or VTT subtitle text. Leave empty to auto-transcribe a video instead. ## `videoUrl` (type: `string`): If no subtitles are provided, a public video/audio URL is transcribed first (needs OpenAI key). ## `targetLanguages` (type: `array`): One or more languages to translate into (ISO codes: es, fr, de, hi, ar, pt, ja, zh…). ## `sourceLanguage` (type: `string`): Language of the input, or 'auto'. ## `outputFormat` (type: `string`): Which subtitle files to produce. ## `openaiApiKey` (type: `string`): Your OpenAI key — for translation (and transcription if a video is given). Kept private. ## `translationModel` (type: `string`): Chat model. Default gpt-4o-mini. ## `baseUrl` (type: `string`): OpenAI-compatible base URL. Default https://api.openai.com/v1. ## Actor input object example ```json { "targetLanguages": [ "es", "fr", "de" ], "sourceLanguage": "auto", "outputFormat": "both", "translationModel": "gpt-4o-mini" } ``` # Actor output Schema ## `results` (type: `string`): Result rows / metadata are stored in the default dataset (one row per item). ## `files` (type: `string`): Generated media/files (video, audio, images, captions) are stored in the default key-value store. # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "targetLanguages": [ "es", "fr", "de" ] }; // Run the Actor and wait for it to finish const run = await client.actor("dami_studio/subtitle-translator").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "targetLanguages": [ "es", "fr", "de", ] } # Run the Actor and wait for it to finish run = client.actor("dami_studio/subtitle-translator").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "targetLanguages": [ "es", "fr", "de" ] }' | apify call dami_studio/subtitle-translator --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=dami_studio/subtitle-translator", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Subtitle Translator — SRT & VTT", "description": "Translate subtitles into many languages at once. Paste an SRT/VTT file (or give a video URL to auto-transcribe), pick target languages, and get clean translated SRT + VTT back — timings preserved. For localization, accessibility, and multi-language publishing.", "version": "0.1", "x-build-id": "k56JjyD8gMwFNW5De" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/dami_studio~subtitle-translator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-dami_studio-subtitle-translator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/dami_studio~subtitle-translator/runs": { "post": { "operationId": "runs-sync-dami_studio-subtitle-translator", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/dami_studio~subtitle-translator/run-sync": { "post": { "operationId": "run-sync-dami_studio-subtitle-translator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "targetLanguages" ], "properties": { "subtitles": { "title": "Subtitles (SRT or VTT)", "type": "string", "description": "Paste your SRT or VTT subtitle text. Leave empty to auto-transcribe a video instead." }, "videoUrl": { "title": "Video/audio URL (optional)", "type": "string", "description": "If no subtitles are provided, a public video/audio URL is transcribed first (needs OpenAI key)." }, "targetLanguages": { "title": "Target languages", "type": "array", "description": "One or more languages to translate into (ISO codes: es, fr, de, hi, ar, pt, ja, zh…).", "items": { "type": "string" } }, "sourceLanguage": { "title": "Source language", "type": "string", "description": "Language of the input, or 'auto'.", "default": "auto" }, "outputFormat": { "title": "Output format", "enum": [ "both", "srt", "vtt" ], "type": "string", "description": "Which subtitle files to produce.", "default": "both" }, "openaiApiKey": { "title": "OpenAI API key (BYO)", "type": "string", "description": "Your OpenAI key — for translation (and transcription if a video is given). Kept private." }, "translationModel": { "title": "Translation model (advanced)", "type": "string", "description": "Chat model. Default gpt-4o-mini.", "default": "gpt-4o-mini" }, "baseUrl": { "title": "API base URL (advanced)", "type": "string", "description": "OpenAI-compatible base URL. Default https://api.openai.com/v1." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```