डबिंग क्विकस्टार्ट

डबिंग API का इस्तेमाल करके ऑडियो और वीडियो फ़ाइलों को अलग-अलग भाषाओं में डब करना सीखें।

यह गाइड दिखाती है कि डबिंग API से किसी मीडिया फ़ाइल को दूसरी भाषा में कैसे डब करें। इस उदाहरण में आप एक अंग्रेज़ी ऑडियो फ़ाइल से डबिंग प्रोजेक्ट बनाते हैं और स्पैनिश डब जनरेट करते हैं।

डबिंग प्रोजेक्ट के दो हिस्से होते हैं: एक प्रोजेक्ट, जिसमें मीडिया का एक स्रोत और उसका ट्रांसक्रिप्ट होता है, और एक या अधिक लक्ष्य भाषाएं, जिनमें से हर एक किसी एक भाषा में डब आउटपुट बनाती है। आप प्रोजेक्ट बनाते हैं, उसके स्रोत के ट्रांसक्राइब होने का इंतज़ार करते हैं, एक भाषा जोड़ते हैं, फिर तैयार डब डाउनलोड करते हैं।

प्रोजेक्ट बनाने पर आपसे पहले ही एक भाषा का शुल्क लिया जाता है — यह डबिंग प्रोजेक्ट का न्यूनतम शुल्क है। इससे आपकी पहली लक्ष्य भाषा का अग्रिम भुगतान हो जाता है: आपकी जो पहली भाषा जोड़ते हैं, उसमें यह इस्तेमाल होता है, और हर अतिरिक्त भाषा का शुल्क अलग से लिया जाता है। जानकारी के लिए डबिंग की कीमत कितनी है? देखें।

भाषाएं BCP-47 टैग के रूप में दी जाती हैं, जैसे es या fr-CA। स्वीकार किए गए सभी मानों के लिए समर्थित भाषाएं और बोलियां देखें।

डबिंग API का इस्तेमाल

1

API कुंजी बनाएं

डैशबोर्ड में यहां API key बनाएं, जिसका इस्तेमाल आप API एक्सेस करने के लिए सुरक्षित रूप से करेंगे।

key को मैनेज्ड सीक्रेट के रूप में स्टोर करें और अपनी पसंद के अनुसार इसे SDKs को .env फ़ाइल के ज़रिए एनवायरनमेंट वेरिएबल के रूप में या सीधे अपने ऐप के कॉन्फ़िगरेशन में पास करें।

.env
ELEVENLABS_API_KEY=<your_api_key_here>
2

SDK इंस्टॉल करें

हम अपने API key को environment variable से लोड करने के लिए dotenv library का भी इस्तेमाल करेंगे।

pip install elevenlabs
pip install python-dotenv

डब किया हुआ ऑडियो डाउनलोड करने के लिए Python उदाहरण requests लाइब्रेरी का इस्तेमाल करता है। इसे pip install requests से इंस्टॉल करें।

3

API रिक्वेस्ट करें

अपनी चुनी हुई भाषा के अनुसार example.py या example.mts नाम की नई फ़ाइल बनाएं और उसमें यह कोड जोड़ें:

# example.py
import os
import time
import requests
from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
load_dotenv()
elevenlabs = ElevenLabs(
api_key=os.getenv("ELEVENLABS_API_KEY"),
)
# 1. Create a project from a source URL
project = elevenlabs.dubbing.project.create(
source_url="https://storage.googleapis.com/eleven-public-cdn/audio/marketing/nicole.mp3",
source_language="en",
reference="Quickstart dub",
)
# 2. Wait for the source media to be transcribed
while True:
project = elevenlabs.dubbing.project.get(project.project_id)
if project.status == "ready":
break
if project.status == "failed":
raise RuntimeError("Project preparation failed")
print("Preparing project...")
time.sleep(5)
# 3. Add a Spanish language target
language = elevenlabs.dubbing.project.language.create(
project.project_id,
target_language="es",
)
# 4. Wait for the dub to finish generating
while True:
language = elevenlabs.dubbing.project.language.get(
project.project_id, language.language_id
)
if language.status == "completed":
break
if language.status == "failed":
raise RuntimeError("Dub generation failed")
print("Generating dub...")
time.sleep(5)
# 5. Download the dubbed audio from the signed URL
audio = requests.get(language.outputs.lossless_audio)
with open("dubbed.wav", "wb") as f:
f.write(audio.content)
print("Saved dubbed audio to dubbed.wav")

outputs.lossless_audio में डाउनलोड URL साइन किया हुआ है और जारी होने के करीब एक घंटे बाद एक्सपायर हो जाता है। अगर यह एक्सपायर हो गया है, तो नया URL पाने के लिए भाषा को फिर से पाएं।

फिर इसे चलाएं:

python example.py

डब किया हुआ ऑडियो आपकी वर्किंग डायरेक्टरी में dubbed.wav के रूप में सेव हो जाता है।

विफलताओं को संभालना

अगर भाषा जोड़ना सफल नहीं होता है, तो नया प्रोजेक्ट बनाने के बजाय उसी मौजूदा प्रोजेक्ट में वही भाषा फिर से जोड़ें। प्रोजेक्ट और उसका ट्रांसक्राइब किया हुआ स्रोत दोबारा इस्तेमाल किए जा सकते हैं, इसलिए भाषा को फिर से आज़माना तेज़ है और दूसरी बार एक-भाषा न्यूनतम शुल्क देने से बचाता है।

नया प्रोजेक्ट केवल तभी बनाएं जब तैयारी के दौरान प्रोजेक्ट खुद failed पर पहुंच जाए, जिसका मतलब है कि उसके स्रोत को ट्रांसक्राइब नहीं किया जा सका। स्रोत फ़ाइल या URL जांचें, फिर नया प्रोजेक्ट बनाएं।

Enterprise वर्कस्पेस भाषा जोड़ने से पहले स्रोत ट्रांसक्रिप्ट की समीक्षा और सुधार कर सकते हैं, जिससे अनुवाद अधिक सटीक होते हैं। डब को सुधारें और फिर से जनरेट करें देखें।

अगले चरण