# API कीज़

> API के लिए कीज़ बनाना, उनका दायरा तय करना और उन्हें सँभालना।

Source: https://reverie.im/hi/docs/integrations/api-keys
Language: hi

API की Reverie के [Open API](https://reverie.im/hi/docs/integrations/open-api) पर जाने वाले अनुरोधों को प्रमाणित करती है। कीज़ **सेटिंग्स → और देखें → API कीज़** में रहती हैं, और Labs का **Open API** टाइल भी वहीं ले जाता है। कोई भी खाता इन्हें बना सकता है — न कोई स्तर की शर्त है, न इस बात की सीमा कि आपके पास कितनी हों।

## की बनाना \[#create-a-key]

### «नई API की बनाएं» दबाएँ \[#press-create-new-api-key]

पेज ख़ाली हो तो बटन पर लिखा होता है **अपनी पहली API की बनाएं**।

### इसे नाम दें \[#name-it]

**नाम** ज़रूरी है, 1–100 अक्षर। सूची में और उपयोग आँकड़ों में यही की का लेबल बनता है — जैसे "लिविंग रूम स्पीकर", "staging worker"।

### ग्लोबल चुनें या कोई ख़ास किरदार \[#choose-global-or-a-specific-character]

**कैरेक्टर चयन** **ग्लोबल (सभी कैरेक्टर)** और **विशिष्ट कैरेक्टर** के बीच का चुनाव है, कोई वैकल्पिक अतिरिक्त चीज़ नहीं। चुना हुआ किरदार उस की से जुड़ा किरदार बन जाता है।

### चाहें तो डिवाइस प्रकार और समाप्ति भी तय करें \[#optionally-set-a-device-type-and-an-expiry]

**डिवाइस प्रकार** मुक्त पाठ है (`speaker`, `phone`, `iot`)। **समाप्ति** तारीख़ *और* समय दोनों लेती है; ठीक उसी क्षण की अपने आप काम करना बंद कर देती है।

की तुरंत दिख जाती है — `rk_` और उसके बाद 64 हेक्साडेसिमल अक्षर।

## कीज़ कभी भी दोबारा देखी जा सकती हैं \[#keys-stay-retrievable]

राज़ एक ही बार नहीं दिखता। जब तक की मौजूद है, उसके कार्ड पर हर समय **API कुंजी दिखाएँ**, **API कुंजी छिपाएँ** और **API कुंजी कॉपी करें** रहते हैं।

> चूँकि पूरा राज़ आपकी सेटिंग्स से पढ़ा जा सकता है, इसलिए खाते तक पहुँच को की तक पहुँच ही मानिए। की को किसी सर्वर पर या सीक्रेट मैनेजर में रखिए, सोर्स कंट्रोल या ब्राउज़र कोड में कभी नहीं।

## ग्लोबल कीज़ और जुड़ी हुई कीज़ \[#global-keys-and-pinned-keys]

|                              | **ग्लोबल (सभी कैरेक्टर)**           | **विशिष्ट कैरेक्टर**                                |
| ---------------------------- | ----------------------------------- | --------------------------------------------------- |
| `GET /models` क्या लौटाता है | आपके हालिया किरदार                  | उस किरदार के परिदृश्य, और एक भी न हो तो ख़ुद किरदार |
| `model` न दिया हो            | आपकी सबसे हाल की चैट पर गिर जाता है | जुड़े हुए किरदार को लेता है                         |
| छोटे परिदृश्य ID             | कभी हल नहीं होते                    | जुड़े हुए किरदार के भीतर हल होते हैं                |

## निष्क्रिय करना, हटाना, बदलना \[#disable-delete-rotate]

| क्रिया          | असर                                                               | पलटा जा सकता है |
| --------------- | ----------------------------------------------------------------- | --------------- |
| **सक्रिय** टॉगल | बंद रहने तक उस की वाले अनुरोध ठुकरा दिए जाते हैं                  | हाँ             |
| **हटाएं**       | की नष्ट हो जाती है और उसे इस्तेमाल करने वाले ऐप पहुँच खो देते हैं | नहीं            |

अलग से कोई रद्द करने की क्रिया नहीं है — निष्क्रिय करना और हटाना, यही दो विकल्प हैं।

> की हटाना पलटा नहीं जा सकता, और वह उस की का हिसाब भी अपने साथ ले जाती है: उसका पुराना ट्रैफ़िक उपयोग आँकड़ों में **हटाई गई कुंजियाँ** वाले खाने में चला जाता है, जहाँ आप बता ही नहीं सकते कि किस इंटीग्रेशन ने कितना ख़र्च किया। अगर इतिहास चाहिए हो सकता है, तो पहले की को निष्क्रिय कीजिए।

बदलने के लिए पहले नई की बनाइए, उसे तैनात कीजिए, फिर पुरानी को निष्क्रिय कीजिए या हटाइए। न कोई अपने आप बदलना है, न अवधि बीतने के बाद कोई रियायत — बीती हुई की अगले ही अनुरोध पर `api_key_expired` के साथ ठुकरा दी जाती है।

## दायरे \[#scopes]

कीज़ के साथ दायरे जुड़े होते हैं, और बनाने वाला डायलॉग उन्हें नहीं दिखाता। सेटिंग्स में बनाई की सिर्फ़ चैट वाले एंडपॉइंट बुला सकती है, और बस।

किरदार आयात वाले एंडपॉइंट को अलग दायरा चाहिए, और ऐसी की पाने का एक ही रास्ता है — **Labs → किरदार आयात करने की स्किल** खोलिए, जो आपके लिए **Reverie Character Importer (Skill)** नाम की एक की बना देती है। सेटिंग्स वाली आम की से आयात बुलाने पर 403 मिलता है। [किरदार आयात करना →](https://reverie.im/hi/docs/characters/import-characters)

## उपयोग आँकड़े \[#usage-statistics]

उसी पेज का **उपयोग आँकड़े** पैनल **अनुरोध**, **टोकन**, **क्रेडिट** और **सक्रिय कुंजियाँ** बताता है, UTC दिन के हिसाब से बाँटकर, और **कुंजी के अनुसार उपयोग** के नीचे हर की का ब्योरा देता है। किसी एक की से या **सभी कुंजियाँ** से छाँटिए, 7 से 90 दिन की खिड़की में — डिफ़ॉल्ट 30 दिन। गिनती में सिर्फ़ वही चैट आती हैं जो API से बनी हों।

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

## अनुरोध बनाएँ \[#build-a-request]

**अनुरोध बनाएँ** एक जनरेटर खोलता है: अपनी किसी सक्रिय की को चुनिए, उस की को दिखने वाली सूची से कोई किरदार या परिदृश्य चुनिए, एक संदेश लिखिए, स्ट्रीमिंग और temperature तय कीजिए, और फिर चलता-फिरता cURL, TypeScript या Python कॉपी कर लीजिए।

वह की आपके ब्राउज़र में सिर्फ़ किरदारों की सूची लाने के लिए इस्तेमाल होती है। बना हुआ कोड राज़ को अंदर गाड़ने की बजाय `REVERIE_API_KEY` को परिवेश से पढ़ता है।

## सीमाएँ \[#limits]

| सीमा                             | मान                                         |
| -------------------------------- | ------------------------------------------- |
| हर खाते में कीज़                 | कोई सीमा नहीं                               |
| हर की पर दर सीमा                 | कोई नहीं                                    |
| हर की पर समानांतर अनुरोधों की हद | कोई नहीं                                    |
| असल में उपयोग को क्या बाँधता है  | आपका क्रेडिट बैलेंस, और फ्री मॉडल की खिड़की |

## संबंधित \[#related]

* [Open API](https://reverie.im/hi/docs/integrations/open-api) — एंडपॉइंट, अनुरोध का ढाँचा और त्रुटियाँ
* [किरदार आयात करना](https://reverie.im/hi/docs/characters/import-characters) — आयात वाली की किस काम की है
* [Reverie Labs](https://reverie.im/hi/docs/integrations/labs) — Open API और आयात वाले टाइल
* [सुरक्षा](https://reverie.im/hi/docs/account/security) — आपके खाते की बाकी पहुँच सेटिंग्स