From 488c485858c1df25646658cc83d5eca58ac5eb35 Mon Sep 17 00:00:00 2001
From: Ankit raj <113342181+ankit-v2-3@users.noreply.github.com>
Date: Mon, 24 Mar 2025 09:16:42 +0530
Subject: [PATCH 1/9] feat: add genai tools

---
 videodb/collection.py | 46 ++++++++++++++++++++++++++++++++++++-------
 1 file changed, 39 insertions(+), 7 deletions(-)

diff --git a/videodb/collection.py b/videodb/collection.py
index 756ab5d..34e8956 100644
--- a/videodb/collection.py
+++ b/videodb/collection.py
@@ -1,12 +1,6 @@
 import logging
 
-from typing import (
-    Optional,
-    Union,
-    List,
-    Dict,
-    Any,
-)
+from typing import Optional, Union, List, Dict, Any, Literal
 from videodb._upload import (
     upload,
 )
@@ -170,6 +164,44 @@ def delete_image(self, image_id: str) -> None:
             path=f"{ApiPath.image}/{image_id}", params={"collection_id": self.id}
         )
 
+    def youtube_search(
+        self, query: str, result_threshold: Optional[int] = 10
+    ) -> List[dict]:
+        """Search for a query on YouTube.
+
+        :param str query: Query to search for
+        :param int result_threshold: Number of results to return (optional)
+        :return: List of YouTube search results
+        :rtype: List[dict]
+        """
+        search_data = self._connection.post(
+            path=f"{ApiPath.collection}/{self.id}/{ApiPath.search}/{ApiPath.web}",
+            data={
+                "query": query,
+                "result_threshold": result_threshold,
+                "platform": "youtube",
+            },
+        )
+        print(search_data)
+        return search_data.get("results")
+
+    def generate_image(
+        self,
+        prompt: str,
+        aspect_ratio: Optional[Literal["1:1", "9:16", "16:9", "4:3", "3:4"]] = "1:1",
+    ) -> Image:
+        """Generate an image from a prompt.
+
+        :param str prompt: Prompt for the image generation
+        :return: :class:`Image <Image>` object
+        :rtype: :class:`videodb.image.Image`
+        """
+        image_data = self._connection.post(
+            path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.image}",
+            data={"prompt": prompt, "aspect_ratio": aspect_ratio},
+        )
+        return Image(self._connection, **image_data)
+
     def search(
         self,
         query: str,

From 6de6eee5c87e439109ad1b3a4836114213b82669 Mon Sep 17 00:00:00 2001
From: Ankit raj <113342181+ankit-v2-3@users.noreply.github.com>
Date: Mon, 24 Mar 2025 10:28:18 +0530
Subject: [PATCH 2/9] feat: add audio gen

---
 videodb/_constants.py |  4 +++
 videodb/collection.py | 63 ++++++++++++++++++++++++++++++++++++++++++-
 2 files changed, 66 insertions(+), 1 deletion(-)

diff --git a/videodb/_constants.py b/videodb/_constants.py
index 173c825..b155752 100644
--- a/videodb/_constants.py
+++ b/videodb/_constants.py
@@ -72,6 +72,10 @@ class ApiPath:
     download = "download"
     title = "title"
     generate_url = "generate_url"
+    generate = "generate"
+    web = "web"
+    translate = "translate"
+    dub = "dub"
 
 
 class Status:
diff --git a/videodb/collection.py b/videodb/collection.py
index 34e8956..4a8b179 100644
--- a/videodb/collection.py
+++ b/videodb/collection.py
@@ -182,9 +182,22 @@ def youtube_search(
                 "platform": "youtube",
             },
         )
-        print(search_data)
         return search_data.get("results")
 
+    def translate_video(self, video_id: str, language_code: str) -> List[dict]:
+        """Translate subtitles of a video to a language.
+
+        :param str video_id: ID of the video
+        :param str language_code: Language code to translate the subtitles to
+        :return: List of translated subtitles
+        :rtype: List[dict]
+        """
+        translate_data = self._connection.post(
+            path=f"{ApiPath.collection}/{self.id}/{ApiPath.video}/{video_id}/{ApiPath.translate}",
+            data={"language_code": language_code},
+        )
+        return translate_data.get("translated_text")
+
     def generate_image(
         self,
         prompt: str,
@@ -202,6 +215,54 @@ def generate_image(
         )
         return Image(self._connection, **image_data)
 
+    def generate_music(self, prompt: str, duration: int = 5) -> Audio:
+        """Generate music from a prompt.
+
+        :param str prompt: Prompt for the music generation
+        :param int duration: Duration of the music in seconds
+        :return: :class:`Audio <Audio>` object
+        :rtype: :class:`videodb.audio.Audio`
+        """
+        audio_data = self._connection.post(
+            path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.audio}",
+            data={"prompt": prompt, "duration": duration, "audio_type": "music"},
+        )
+        return Audio(self._connection, **audio_data)
+
+    def generate_sound_effect(self, prompt: str, duration: int = 2) -> Audio:
+        """Generate sound effect from a prompt.
+
+        :param str prompt: Prompt for the sound effect generation
+        :param int duration: Duration of the sound effect in seconds
+        :return: :class:`Audio <Audio>` object
+        :rtype: :class:`videodb.audio.Audio`
+        """
+        audio_data = self._connection.post(
+            path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.audio}",
+            data={"prompt": prompt, "duration": duration, "audio_type": "sound_effect"},
+        )
+        return Audio(self._connection, **audio_data)
+
+    def generate_text_to_speech(self, text: str) -> Audio:
+        """Generate text to speech audio.
+
+        :param str text: Text to convert to speech
+        :return: :class:`Audio <Audio>` object
+        :rtype: :class:`videodb.audio.Audio`
+        """
+        audio_data = self._connection.post(
+            path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.audio}",
+            data={"text": text, "audio_type": "text_to_speech"},
+        )
+        return Audio(self._connection, **audio_data)
+
+    def dub_video(self, video_id: str, language_code: str) -> Video:
+        dub_data = self._connection.post(
+            path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.video}/{ApiPath.dub}",
+            data={"video_id": video_id, "language_code": language_code},
+        )
+        return Video(self._connection, **dub_data)
+
     def search(
         self,
         query: str,

From 867249add990adbfdb053cb8e5ecfb265b6a0ff3 Mon Sep 17 00:00:00 2001
From: Ankit raj <113342181+ankit-v2-3@users.noreply.github.com>
Date: Tue, 25 Mar 2025 13:33:42 +0530
Subject: [PATCH 3/9] feat: add callback url

---
 videodb/collection.py | 61 +++++++++++++++++++++++++++++++++++--------
 1 file changed, 50 insertions(+), 11 deletions(-)

diff --git a/videodb/collection.py b/videodb/collection.py
index 4a8b179..751aaea 100644
--- a/videodb/collection.py
+++ b/videodb/collection.py
@@ -184,17 +184,20 @@ def youtube_search(
         )
         return search_data.get("results")
 
-    def translate_video(self, video_id: str, language_code: str) -> List[dict]:
+    def translate_video(
+        self, video_id: str, language_code: str, callback_url: Optional[str] = None
+    ) -> List[dict]:
         """Translate subtitles of a video to a language.
 
         :param str video_id: ID of the video
         :param str language_code: Language code to translate the subtitles to
+        :param str callback_url: URL to receive the callback (optional)
         :return: List of translated subtitles
         :rtype: List[dict]
         """
         translate_data = self._connection.post(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.video}/{video_id}/{ApiPath.translate}",
-            data={"language_code": language_code},
+            data={"language_code": language_code, "callback_url": callback_url},
         )
         return translate_data.get("translated_text")
 
@@ -202,64 +205,100 @@ def generate_image(
         self,
         prompt: str,
         aspect_ratio: Optional[Literal["1:1", "9:16", "16:9", "4:3", "3:4"]] = "1:1",
+        callback_url: Optional[str] = None,
     ) -> Image:
         """Generate an image from a prompt.
 
         :param str prompt: Prompt for the image generation
+        :param str aspect_ratio: Aspect ratio of the image (optional)
+        :param str callback_url: URL to receive the callback (optional)
         :return: :class:`Image <Image>` object
         :rtype: :class:`videodb.image.Image`
         """
         image_data = self._connection.post(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.image}",
-            data={"prompt": prompt, "aspect_ratio": aspect_ratio},
+            data={
+                "prompt": prompt,
+                "aspect_ratio": aspect_ratio,
+                "callback_url": callback_url,
+            },
         )
         return Image(self._connection, **image_data)
 
-    def generate_music(self, prompt: str, duration: int = 5) -> Audio:
+    def generate_music(
+        self, prompt: str, duration: int = 5, callback_url: Optional[str] = None
+    ) -> Audio:
         """Generate music from a prompt.
 
         :param str prompt: Prompt for the music generation
         :param int duration: Duration of the music in seconds
+        :param str callback_url: URL to receive the callback (optional)
         :return: :class:`Audio <Audio>` object
         :rtype: :class:`videodb.audio.Audio`
         """
         audio_data = self._connection.post(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.audio}",
-            data={"prompt": prompt, "duration": duration, "audio_type": "music"},
+            data={
+                "prompt": prompt,
+                "duration": duration,
+                "audio_type": "music",
+                "callback_url": callback_url,
+            },
         )
         return Audio(self._connection, **audio_data)
 
-    def generate_sound_effect(self, prompt: str, duration: int = 2) -> Audio:
+    def generate_sound_effect(
+        self, prompt: str, duration: int = 2, callback_url: Optional[str] = None
+    ) -> Audio:
         """Generate sound effect from a prompt.
 
         :param str prompt: Prompt for the sound effect generation
         :param int duration: Duration of the sound effect in seconds
+        :param str callback_url: URL to receive the callback (optional)
         :return: :class:`Audio <Audio>` object
         :rtype: :class:`videodb.audio.Audio`
         """
         audio_data = self._connection.post(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.audio}",
-            data={"prompt": prompt, "duration": duration, "audio_type": "sound_effect"},
+            data={
+                "prompt": prompt,
+                "duration": duration,
+                "audio_type": "sound_effect",
+                "callback_url": callback_url,
+            },
         )
         return Audio(self._connection, **audio_data)
 
-    def generate_text_to_speech(self, text: str) -> Audio:
+    def generate_text_to_speech(
+        self, text: str, callback_url: Optional[str] = None
+    ) -> Audio:
         """Generate text to speech audio.
 
         :param str text: Text to convert to speech
+        :param str callback_url: URL to receive the callback (optional)
         :return: :class:`Audio <Audio>` object
         :rtype: :class:`videodb.audio.Audio`
         """
         audio_data = self._connection.post(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.audio}",
-            data={"text": text, "audio_type": "text_to_speech"},
+            data={
+                "text": text,
+                "audio_type": "text_to_speech",
+                "callback_url": callback_url,
+            },
         )
         return Audio(self._connection, **audio_data)
 
-    def dub_video(self, video_id: str, language_code: str) -> Video:
+    def dub_video(
+        self, video_id: str, language_code: str, callback_url: Optional[str] = None
+    ) -> Video:
         dub_data = self._connection.post(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.video}/{ApiPath.dub}",
-            data={"video_id": video_id, "language_code": language_code},
+            data={
+                "video_id": video_id,
+                "language_code": language_code,
+                "callback_url": callback_url,
+            },
         )
         return Video(self._connection, **dub_data)
 

From d0ed510331e137af89ad0d1199bfac1b724eb6f3 Mon Sep 17 00:00:00 2001
From: Ankit raj <113342181+ankit-v2-3@users.noreply.github.com>
Date: Tue, 25 Mar 2025 13:44:38 +0530
Subject: [PATCH 4/9] fix: callback data

---
 videodb/collection.py | 18 ++++++++++++------
 1 file changed, 12 insertions(+), 6 deletions(-)

diff --git a/videodb/collection.py b/videodb/collection.py
index 751aaea..7252eb0 100644
--- a/videodb/collection.py
+++ b/videodb/collection.py
@@ -199,7 +199,8 @@ def translate_video(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.video}/{video_id}/{ApiPath.translate}",
             data={"language_code": language_code, "callback_url": callback_url},
         )
-        return translate_data.get("translated_text")
+        if translate_data:
+            return translate_data.get("translated_text")
 
     def generate_image(
         self,
@@ -223,7 +224,8 @@ def generate_image(
                 "callback_url": callback_url,
             },
         )
-        return Image(self._connection, **image_data)
+        if image_data:
+            return Image(self._connection, **image_data)
 
     def generate_music(
         self, prompt: str, duration: int = 5, callback_url: Optional[str] = None
@@ -245,7 +247,8 @@ def generate_music(
                 "callback_url": callback_url,
             },
         )
-        return Audio(self._connection, **audio_data)
+        if audio_data:
+            return Audio(self._connection, **audio_data)
 
     def generate_sound_effect(
         self, prompt: str, duration: int = 2, callback_url: Optional[str] = None
@@ -267,7 +270,8 @@ def generate_sound_effect(
                 "callback_url": callback_url,
             },
         )
-        return Audio(self._connection, **audio_data)
+        if audio_data:
+            return Audio(self._connection, **audio_data)
 
     def generate_text_to_speech(
         self, text: str, callback_url: Optional[str] = None
@@ -287,7 +291,8 @@ def generate_text_to_speech(
                 "callback_url": callback_url,
             },
         )
-        return Audio(self._connection, **audio_data)
+        if audio_data:
+            return Audio(self._connection, **audio_data)
 
     def dub_video(
         self, video_id: str, language_code: str, callback_url: Optional[str] = None
@@ -300,7 +305,8 @@ def dub_video(
                 "callback_url": callback_url,
             },
         )
-        return Video(self._connection, **dub_data)
+        if dub_data:
+            return Video(self._connection, **dub_data)
 
     def search(
         self,

From 7d459ebadd13f1c6556cbbbec26624f6f39096da Mon Sep 17 00:00:00 2001
From: Ankit raj <113342181+ankit-v2-3@users.noreply.github.com>
Date: Tue, 25 Mar 2025 15:07:59 +0530
Subject: [PATCH 5/9] build: upgrade version

---
 videodb/__about__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/videodb/__about__.py b/videodb/__about__.py
index d152662..972eedd 100644
--- a/videodb/__about__.py
+++ b/videodb/__about__.py
@@ -1,7 +1,7 @@
 """ About information for videodb sdk"""
 
 
-__version__ = "0.2.11"
+__version__ = "0.2.13"
 __title__ = "videodb"
 __author__ = "videodb"
 __email__ = "contact@videodb.io"

From 5c3b3868d9fe812b9db8c817cf609d33d5407502 Mon Sep 17 00:00:00 2001
From: Ankit raj <113342181+ankit-v2-3@users.noreply.github.com>
Date: Fri, 28 Mar 2025 17:34:01 +0530
Subject: [PATCH 6/9] feat: add configs

---
 videodb/collection.py | 35 ++++++++++++++++++++++++++++++-----
 1 file changed, 30 insertions(+), 5 deletions(-)

diff --git a/videodb/collection.py b/videodb/collection.py
index 7252eb0..a2599c0 100644
--- a/videodb/collection.py
+++ b/videodb/collection.py
@@ -165,12 +165,16 @@ def delete_image(self, image_id: str) -> None:
         )
 
     def youtube_search(
-        self, query: str, result_threshold: Optional[int] = 10
+        self,
+        query: str,
+        result_threshold: Optional[int] = 10,
+        duration: str = "medium",
     ) -> List[dict]:
         """Search for a query on YouTube.
 
         :param str query: Query to search for
         :param int result_threshold: Number of results to return (optional)
+        :param str duration: Duration of the video (optional)
         :return: List of YouTube search results
         :rtype: List[dict]
         """
@@ -180,24 +184,34 @@ def youtube_search(
                 "query": query,
                 "result_threshold": result_threshold,
                 "platform": "youtube",
+                "duration": duration,
             },
         )
         return search_data.get("results")
 
     def translate_video(
-        self, video_id: str, language_code: str, callback_url: Optional[str] = None
+        self,
+        video_id: str,
+        language_code: str,
+        additional_notes: str = "",
+        callback_url: Optional[str] = None,
     ) -> List[dict]:
         """Translate subtitles of a video to a language.
 
         :param str video_id: ID of the video
         :param str language_code: Language code to translate the subtitles to
+        :param str additional_notes: Additional notes for the style of language
         :param str callback_url: URL to receive the callback (optional)
         :return: List of translated subtitles
         :rtype: List[dict]
         """
         translate_data = self._connection.post(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.video}/{video_id}/{ApiPath.translate}",
-            data={"language_code": language_code, "callback_url": callback_url},
+            data={
+                "language_code": language_code,
+                "additional_notes": additional_notes,
+                "callback_url": callback_url,
+            },
         )
         if translate_data:
             return translate_data.get("translated_text")
@@ -251,12 +265,17 @@ def generate_music(
             return Audio(self._connection, **audio_data)
 
     def generate_sound_effect(
-        self, prompt: str, duration: int = 2, callback_url: Optional[str] = None
+        self,
+        prompt: str,
+        duration: int = 2,
+        config: dict = {},
+        callback_url: Optional[str] = None,
     ) -> Audio:
         """Generate sound effect from a prompt.
 
         :param str prompt: Prompt for the sound effect generation
         :param int duration: Duration of the sound effect in seconds
+        :param dict config: Configuration for the sound effect generation
         :param str callback_url: URL to receive the callback (optional)
         :return: :class:`Audio <Audio>` object
         :rtype: :class:`videodb.audio.Audio`
@@ -267,6 +286,7 @@ def generate_sound_effect(
                 "prompt": prompt,
                 "duration": duration,
                 "audio_type": "sound_effect",
+                "config": config,
                 "callback_url": callback_url,
             },
         )
@@ -274,11 +294,15 @@ def generate_sound_effect(
             return Audio(self._connection, **audio_data)
 
     def generate_text_to_speech(
-        self, text: str, callback_url: Optional[str] = None
+        self,
+        text: str,
+        config: dict = {},
+        callback_url: Optional[str] = None,
     ) -> Audio:
         """Generate text to speech audio.
 
         :param str text: Text to convert to speech
+        :param dict config: Configuration for the text to speech generation
         :param str callback_url: URL to receive the callback (optional)
         :return: :class:`Audio <Audio>` object
         :rtype: :class:`videodb.audio.Audio`
@@ -288,6 +312,7 @@ def generate_text_to_speech(
             data={
                 "text": text,
                 "audio_type": "text_to_speech",
+                "config": config,
                 "callback_url": callback_url,
             },
         )

From 47bf3ab63f3d70b2b07bbb05ad42531581c5a42b Mon Sep 17 00:00:00 2001
From: Ankit raj <113342181+ankit-v2-3@users.noreply.github.com>
Date: Fri, 4 Apr 2025 16:41:03 +0530
Subject: [PATCH 7/9] refactor: method names and parameters

---
 videodb/client.py     | 27 +++++++++++++++++++-
 videodb/collection.py | 58 +++----------------------------------------
 videodb/video.py      | 25 +++++++++++++++++++
 3 files changed, 55 insertions(+), 55 deletions(-)

diff --git a/videodb/client.py b/videodb/client.py
index f47df97..7cbfbfd 100644
--- a/videodb/client.py
+++ b/videodb/client.py
@@ -110,7 +110,7 @@ def update_collection(self, id: str, name: str, description: str) -> Collection:
         """Update an existing collection.
 
         :param str id: ID of the collection
-        :param str name: Name of the collection 
+        :param str name: Name of the collection
         :param str description: Description of the collection
         :return: :class:`Collection <Collection>` object
         :rtype: :class:`videodb.collection.Collection`
@@ -163,6 +163,31 @@ def download(self, stream_link: str, name: str) -> dict:
             },
         )
 
+    def youtube_search(
+        self,
+        query: str,
+        result_threshold: Optional[int] = 10,
+        duration: str = "medium",
+    ) -> List[dict]:
+        """Search for a query on YouTube.
+
+        :param str query: Query to search for
+        :param int result_threshold: Number of results to return (optional)
+        :param str duration: Duration of the video (optional)
+        :return: List of YouTube search results
+        :rtype: List[dict]
+        """
+        search_data = self.post(
+            path=f"{ApiPath.collection}/{self.collection_id}/{ApiPath.search}/{ApiPath.web}",
+            data={
+                "query": query,
+                "result_threshold": result_threshold,
+                "platform": "youtube",
+                "duration": duration,
+            },
+        )
+        return search_data.get("results")
+
     def upload(
         self,
         file_path: str = None,
diff --git a/videodb/collection.py b/videodb/collection.py
index a2599c0..4ecec3a 100644
--- a/videodb/collection.py
+++ b/videodb/collection.py
@@ -164,58 +164,6 @@ def delete_image(self, image_id: str) -> None:
             path=f"{ApiPath.image}/{image_id}", params={"collection_id": self.id}
         )
 
-    def youtube_search(
-        self,
-        query: str,
-        result_threshold: Optional[int] = 10,
-        duration: str = "medium",
-    ) -> List[dict]:
-        """Search for a query on YouTube.
-
-        :param str query: Query to search for
-        :param int result_threshold: Number of results to return (optional)
-        :param str duration: Duration of the video (optional)
-        :return: List of YouTube search results
-        :rtype: List[dict]
-        """
-        search_data = self._connection.post(
-            path=f"{ApiPath.collection}/{self.id}/{ApiPath.search}/{ApiPath.web}",
-            data={
-                "query": query,
-                "result_threshold": result_threshold,
-                "platform": "youtube",
-                "duration": duration,
-            },
-        )
-        return search_data.get("results")
-
-    def translate_video(
-        self,
-        video_id: str,
-        language_code: str,
-        additional_notes: str = "",
-        callback_url: Optional[str] = None,
-    ) -> List[dict]:
-        """Translate subtitles of a video to a language.
-
-        :param str video_id: ID of the video
-        :param str language_code: Language code to translate the subtitles to
-        :param str additional_notes: Additional notes for the style of language
-        :param str callback_url: URL to receive the callback (optional)
-        :return: List of translated subtitles
-        :rtype: List[dict]
-        """
-        translate_data = self._connection.post(
-            path=f"{ApiPath.collection}/{self.id}/{ApiPath.video}/{video_id}/{ApiPath.translate}",
-            data={
-                "language_code": language_code,
-                "additional_notes": additional_notes,
-                "callback_url": callback_url,
-            },
-        )
-        if translate_data:
-            return translate_data.get("translated_text")
-
     def generate_image(
         self,
         prompt: str,
@@ -293,9 +241,10 @@ def generate_sound_effect(
         if audio_data:
             return Audio(self._connection, **audio_data)
 
-    def generate_text_to_speech(
+    def generate_voice(
         self,
         text: str,
+        voice_name: str = "Default",
         config: dict = {},
         callback_url: Optional[str] = None,
     ) -> Audio:
@@ -311,7 +260,8 @@ def generate_text_to_speech(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.audio}",
             data={
                 "text": text,
-                "audio_type": "text_to_speech",
+                "audio_type": "voice",
+                "voice_name": voice_name,
                 "config": config,
                 "callback_url": callback_url,
             },
diff --git a/videodb/video.py b/videodb/video.py
index f72e1a1..1b3742f 100644
--- a/videodb/video.py
+++ b/videodb/video.py
@@ -249,6 +249,31 @@ def get_transcript_text(
         )
         return self.transcript_text
 
+    def translate_transcript(
+        self,
+        language: str,
+        additional_notes: str = "",
+        callback_url: Optional[str] = None,
+    ) -> List[dict]:
+        """Translate transcript of a video to a language.
+
+        :param str language: Language to translate the subtitles to
+        :param str additional_notes: Additional notes for the style of language
+        :param str callback_url: URL to receive the callback (optional)
+        :return: List of translated subtitles
+        :rtype: List[dict]
+        """
+        translate_data = self._connection.post(
+            path=f"{ApiPath.collection}/{self.collection_id}/{ApiPath.video}/{self.id}/{ApiPath.translate}",
+            data={
+                "language": language,
+                "additional_notes": additional_notes,
+                "callback_url": callback_url,
+            },
+        )
+        if translate_data:
+            return translate_data.get("translated_transcript")
+
     def index_spoken_words(
         self,
         language_code: Optional[str] = None,

From 1c5a8e289ef5927c8c1ee6734b90212123848315 Mon Sep 17 00:00:00 2001
From: Ankit raj <113342181+ankit-v2-3@users.noreply.github.com>
Date: Fri, 4 Apr 2025 16:42:39 +0530
Subject: [PATCH 8/9] fix: sdk version

---
 videodb/__about__.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/videodb/__about__.py b/videodb/__about__.py
index 972eedd..7e93884 100644
--- a/videodb/__about__.py
+++ b/videodb/__about__.py
@@ -1,7 +1,7 @@
 """ About information for videodb sdk"""
 
 
-__version__ = "0.2.13"
+__version__ = "0.2.12"
 __title__ = "videodb"
 __author__ = "videodb"
 __email__ = "contact@videodb.io"

From 6ee30aff967e9d502b747e014f8a69d17c1b08ce Mon Sep 17 00:00:00 2001
From: Ankit raj <113342181+ankit-v2-3@users.noreply.github.com>
Date: Fri, 4 Apr 2025 16:54:28 +0530
Subject: [PATCH 9/9] docs: fix doc strings

---
 videodb/collection.py | 15 ++++++++++++---
 videodb/video.py      |  6 +++---
 2 files changed, 15 insertions(+), 6 deletions(-)

diff --git a/videodb/collection.py b/videodb/collection.py
index 4ecec3a..25a86ec 100644
--- a/videodb/collection.py
+++ b/videodb/collection.py
@@ -248,10 +248,11 @@ def generate_voice(
         config: dict = {},
         callback_url: Optional[str] = None,
     ) -> Audio:
-        """Generate text to speech audio.
+        """Generate voice from text.
 
-        :param str text: Text to convert to speech
-        :param dict config: Configuration for the text to speech generation
+        :param str text: Text to convert to voice
+        :param str voice_name: Name of the voice to use
+        :param dict config: Configuration for the voice generation
         :param str callback_url: URL to receive the callback (optional)
         :return: :class:`Audio <Audio>` object
         :rtype: :class:`videodb.audio.Audio`
@@ -272,6 +273,14 @@ def generate_voice(
     def dub_video(
         self, video_id: str, language_code: str, callback_url: Optional[str] = None
     ) -> Video:
+        """Dub a video.
+
+        :param str video_id: ID of the video to dub
+        :param str language_code: Language code to dub the video to
+        :param str callback_url: URL to receive the callback (optional)
+        :return: :class:`Video <Video>` object
+        :rtype: :class:`videodb.video.Video`
+        """
         dub_data = self._connection.post(
             path=f"{ApiPath.collection}/{self.id}/{ApiPath.generate}/{ApiPath.video}/{ApiPath.dub}",
             data={
diff --git a/videodb/video.py b/videodb/video.py
index 1b3742f..eb4da7b 100644
--- a/videodb/video.py
+++ b/videodb/video.py
@@ -255,12 +255,12 @@ def translate_transcript(
         additional_notes: str = "",
         callback_url: Optional[str] = None,
     ) -> List[dict]:
-        """Translate transcript of a video to a language.
+        """Translate transcript of a video to a given language.
 
-        :param str language: Language to translate the subtitles to
+        :param str language: Language to translate the transcript
         :param str additional_notes: Additional notes for the style of language
         :param str callback_url: URL to receive the callback (optional)
-        :return: List of translated subtitles
+        :return: List of translated transcript
         :rtype: List[dict]
         """
         translate_data = self._connection.post(