Skip to main content


The ContentTranslationEngine in ShortGPT is a powerful tool that automates the process of translating video content. This guide will provide you with an overview of how to use the ContentTranslationEngine.

Importing ContentTranslationEngine

from shortGPT.engine.content_translation_engine import ContentTranslationEngine

Initializing ContentTranslationEngine

The ContentTranslationEngine requires a VoiceModule, a source URL (either a local video file path or a YouTube link), a target language, and an optional flag indicating whether to use captions for translation.

content_engine = ContentTranslationEngine(voice_module, src_url, target_language, use_captions=False)


from shortGPT.config.api_db import ApiKeyManager, ApiProvider
from shortGPT.engine.content_translation_engine import ContentTranslationEngine
from shortGPT.config.languages import Language
from import EdgeTTSVoiceModule, EDGE_TTS_VOICENAME_MAPPING

# Set API Keys
ApiKeyManager.set_api_key(ApiProvider.OPENAI, "your_openai_key")
ApiKeyManager.set_api_key(ApiProvider.ELEVEN_LABS, "your_eleven_labs_key")

# Configure the Voice Module
voice_name = EDGE_TTS_VOICENAME_MAPPING[Language.SPANISH]['male']
voice_module = EdgeTTSVoiceModule(voice_name)

# Configure Content Engine
src_url = ""
target_language = Language.SPANISH
use_captions = False
content_engine = ContentTranslationEngine(voice_module, src_url, target_language, use_captions)

# Generate Content
for step_num, step_logs in content_engine.makeContent():
print(f" {step_logs}")

# Get Video Output Path

How ContentTranslationEngine Works

The ContentTranslationEngine works by executing a series of steps defined in the stepDict dictionary. Each step is a method that performs a specific task in the video translation process. Here's what each step does:

  1. _transcribe_audio: Transcribes the audio from the source video
  2. _translate_content: Translates the transcribed content from the source language to the target language.
  3. _generate_translated_audio: Generates translated audio using the translated content and the specified VoiceModule.
  4. _edit_and_render_video: Edits and renders the translated video.
  5. _add_metadata: Adds metadata to the translated video.

Providing a Source URL

The ContentTranslationEngine requires a source URL, which can be either a local video file path or a YouTube link for a youtube Video, or a Youtube Shorts. The engine uses this source URL to retrieve the audio and video content for translation.

Using Captions for Translation

Set the use_captions flag to True to see text captions on the video generated that are timed with the audio voice.