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

API प्रमाणीकरण

जानें कि अपने ElevenLabs API अनुरोधों को कैसे प्रमाणित करें

API कीज़

की छोड़ दें। अपने कोडिंग एजेंट को इसे सेट अप करने दें।

इसे Claude Code, Cursor या Codex में पेस्ट करें। यह आपको साइन इन करता है या अकाउंट बनाता है, एक की बनाता है और आपके प्रोजेक्ट में SDK जोड़ता है।

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

जानें कि यह कैसे काम करता है, या यह आपके एजेंट को क्या बताता है, यह ठीक-ठीक जानने के लिए onboard कमांड का सोर्स पढ़ें।

ElevenLabs API प्रमाणीकरण के लिए API कीज़ का इस्तेमाल करता है। API के हर अनुरोध में आपकी API की शामिल होनी चाहिए, जिसका इस्तेमाल आपके अनुरोधों को प्रमाणित करने और उपयोग कोटा ट्रैक करने के लिए किया जाता है।

हर API की को इन प्रतिबंधों के साथ कॉन्फ़िगर किया जा सकता है:

  1. स्कोप प्रतिबंध: की किन API एंडपॉइंट्स को ऐक्सेस कर सकती है, इसे सीमित करके ऐक्सेस प्रतिबंध सेट करें।
  2. क्रेडिट कोटा: उपयोग नियंत्रित करने के लिए कस्टम क्रेडिट सीमाएं तय करें।
  3. IP अलाउलिस्टिंग: की को खास IP पतों या CIDR रेंज तक सीमित करें। अलाउलिस्ट में शामिल नहीं होने वाले IP से आए अनुरोध 403 त्रुटि के साथ अस्वीकार कर दिए जाते हैं। और जानें।

याद रखें कि आपकी API की एक गुप्त जानकारी है। इसे दूसरों के साथ शेयर न करें और किसी भी क्लाइंट-साइड कोड (ब्राउज़र, ऐप्स) में एक्सपोज़ न करें।

सभी API अनुरोधों में आपकी API की को इस तरह xi-api-key HTTP हेडर में शामिल करना चाहिए:

xi-api-key: ELEVENLABS_API_KEY

अनुरोध करना

अपना पहला API अनुरोध चलाने के लिए आप नीचे दिया गया कमांड अपने टर्मिनल में पेस्ट कर सकते हैं। $ELEVENLABS_API_KEY को अपनी गुप्त API की से बदलना न भूलें।

curl 'https://api.elevenlabs.io/v1/models' \
  -H 'Content-Type: application/json' \
  -H 'xi-api-key: $ELEVENLABS_API_KEY'

elevenlabs Python पैकेज के साथ उदाहरण:

from elevenlabs.client import ElevenLabs
elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)

elevenlabs Node.js पैकेज के साथ उदाहरण:

import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";
const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});

एकल-उपयोग टोकन

कुछ एंडपॉइंट्स के लिए, आप अपने अनुरोधों को प्रमाणित करने के लिए एकल-उपयोग टोकन इस्तेमाल कर सकते हैं। ये टोकन सीमित समय के लिए मान्य होते हैं और इनका इस्तेमाल आपकी API की एक्सपोज़ किए बिना API से कनेक्ट करने के लिए किया जा सकता है, जैसे कि क्लाइंट साइड से।

ज़्यादा जानकारी के लिए एकल-उपयोग टोकन दस्तावेज़ देखें।