नेविगेशन पर जाएँ

ElevenAPI क्विकस्टार्ट

जानें कि अपना पहला ElevenLabs API अनुरोध कैसे करें।

इस गाइड के अंत तक, आपके प्रोजेक्ट में ElevenLabs सेट अप हो जाएगा और आप अपना पहला टेक्स्ट टू स्पीच अनुरोध कर सकेंगे। इसके दो तरीके हैं: अपने कोडिंग एजेंट से सेटअप करवाएं या खुद करें।

स्ट्रीमिंग, वॉइस क्लोनिंग और स्पीच टू टेक्स्ट जैसी अन्य क्षमताओं की गाइड के लिए ट्यूटोरियल्स सेक्शन देखें।

अपने कोडिंग एजेंट से सेट अप करें

शुरू करने से पहले आपको अकाउंट या API कुंजी की ज़रूरत नहीं है। इसे अपने कोडिंग एजेंट में पेस्ट करें:

Add ElevenLabs to my project: run `npx -y @elevenlabs/cli@latest onboard init` and follow what it prints.

इसके बाद ElevenLabs CLI बाकी काम संभाल लेता है और आपके एजेंट को हर चरण बताता है। आपका ब्राउज़र एक बार खुलेगा, जहाँ आप साइन इन कर सकते हैं या अकाउंट बना सकते हैं और Authorize पर क्लिक कर सकते हैं। कुंजी आपके प्रोजेक्ट की env फ़ाइल (.env.local, या Python प्रोजेक्ट में .env) में सेव होती है और git से बाहर रखी जाती है; यह चैट में कभी नहीं दिखाई जाती। इसके बाद एजेंट पूछता है कि आप क्या बनाना चाहते हैं, SDK इंस्टॉल करता है, आपके ऐप में कोड जोड़ता है और पूछता है कि क्या टेस्ट अनुरोध भेजना है।

अगर आपका एजेंट ऐसी जगह चल रहा है जहाँ आपका ब्राउज़र पहुँच नहीं सकता, जैसे SSH के ज़रिए रिमोट मशीन या क्लाउड सैंडबॉक्स, तो CLI आपसे खुद कुंजी बनाने और उसे env फ़ाइल में पेस्ट करने के लिए कहता है, फिर आगे बढ़ता है। npx के लिए इस कमांड को Node.js चाहिए। इसके बिना, Homebrew (macOS और Linux) या Scoop (Windows) से ElevenLabs CLI इंस्टॉल करें, या अगर यह पहले से मौजूद है तो इसे अपडेट करें (brew upgrade elevenlabs, scoop update elevenlabs), और अपने एजेंट से इसके बजाय elevenlabs onboard init चलाने के लिए कहें।

खुद सेट अप करें

1

API कुंजी बनाएं

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

अपनी पसंद के अनुसार की को मैनेज्ड सीक्रेट के रूप में स्टोर करें और उसे 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

अपने स्पीकर से ऑडियो चलाने के लिए, आपको MPV और/या ffmpeg इंस्टॉल करने के लिए कहा जा सकता है।

3

अपना पहला अनुरोध करें

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

from dotenv import load_dotenv
from elevenlabs.client import ElevenLabs
from elevenlabs.play import play
import os
load_dotenv()
elevenlabs = ElevenLabs(
api_key=os.getenv("ELEVENLABS_API_KEY"),
)
audio = elevenlabs.text_to_speech.convert(
text="The first move is what sets everything in motion.",
voice_id="JBFqnCBsd6RMkjVDRZzb", # "George" - browse voices at elevenlabs.io/app/voice-library
model_id="eleven_v4",
output_format="mp3_44100_128",
)
play(audio)

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

python example.py

आपको अपने स्पीकर से ऑडियो सुनाई देना चाहिए।

आगे के चरण