> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# API ऑथेंटिकेशन

## API कुंजियां

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

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

1. **स्कोप पाबंदी:** कुंजी किन API एंडपॉइंट को एक्सेस कर सकती है, इसे सीमित करके एक्सेस पाबंदियां सेट करें।
2. **क्रेडिट कोटा:** उपयोग नियंत्रित करने के लिए कस्टम क्रेडिट सीमाएं तय करें।
3. **IP अलाउलिस्टिंग:** कुंजी को खास IP पते या CIDR रेंज तक सीमित करें। अलाउलिस्ट में शामिल न होने वाले IP से आने वाले अनुरोध `403` एरर के साथ अस्वीकार कर दिए जाते हैं। [और जानें](/docs/hi/overview/administration/workspaces/api-keys#ip-allowlisting)।

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

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

```bash
xi-api-key: ELEVENLABS_API_KEY
```

### अनुरोध करना

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

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

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

```python
from elevenlabs.client import ElevenLabs

elevenlabs = ElevenLabs(
  api_key='YOUR_API_KEY',
)
```

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

```javascript
import { ElevenLabsClient } from "@elevenlabs/elevenlabs-js";

const elevenlabs = new ElevenLabsClient({
  apiKey: "YOUR_API_KEY",
});
```

### सिंगल-यूज़ टोकन

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

ज़्यादा जानकारी के लिए [सिंगल-यूज़ टोकन](/docs/hi/api-reference/tokens/create) दस्तावेज़ देखें।