ज्ञान के आधार बा डेवलपर्स
API के सारांश
एह ऐप में रउआ जवन मॉडल, जनरेटर अउरी बैलेंस के इस्तेमाल करऽतानी, ऊ रउआ आपन कोड से बा। API, OpenAI अउरी Anthropic के फॉर्मेट में बात करेला, एह से बेसीतर टूल्स अउरी SDKs, खाली एगो बेस URL अउरी की (key) बदलला से काम करे लग जाला।
ई पन्ना सुविधा खातिर मशीन से अनुवाद कइल गइल बा। अंग्रेजी मूल ऊ संस्करण ह जवन लागू होला.
ए. पि. आइ. की है?
एगो HTTP API पर nymbot.ai जे उहे रिक्वेस्ट के जवाब देला जवन एगो OpenAI चाहे Anthropic
क्लाइंट पहिले से भेजेला। राउर मिली:
- चैट कॉम्प्लीशन्सछिछोरे, रिस्पॉन्स API औरी मानवशास्त्रीय सन्देश, स्ट्रीमिंग, टूल्स, तस्वीर, तर्क अउरी वेब सर्च के साथ, हर मॉडल खातिर के ए. आर. ए. सूचीपत्रक अउर Nymbot के अपना ऑटो-रूटिंग खातिर।
- प्रतिमाएँ, ए. आर. वी. डी. ओ., भाषण, लिपिविध (transcription) औरी एम्बेडिंग्स.
- तोहार तुलनशीलता, लाइटनिंग टॉप-अप्स, अपने बटुए से स्वचालित टॉप-अप कीजिए ए. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. आ. इतिहास हर एगो रिक्वेस्ट के कतना लागत आवेला।
एकेही दू गो से पइसा देल गइल बा बैलेंस ऐप के रूप में, समान कीमतों पर। एपीआई पर कोई सदस्यता नहीं है और कोई मुफ्त भत्ता नहीं हैः प्रत्येक अनुरोध के लिए भुगतान आपके द्वारा खरीदे गए क्रेडिट से किया जाता है।
API जे ना करेला उ बा Nymbot के आपन कवनो चीज जोड़ल। राउर संदेश ओहिना मॉडल के लगे जाला जइसे राउर भेजले बानी: नइखे कवनो Nymbot सिस्टम प्रॉम्प्ट, नइखे कवनो मेमोरी, नइखे कवनो तारीख चाहे भाषा के संकेत। जे वापस आवेला उ बा मॉडल के उत्तर अउर कतना लागत लागल ओकर जानकारी।
आधार URL
| उपयो ग करो | मूल URL |
|---|---|
| ओपनएआई एसडीके और ओपनएआई-संगत उपकरण | https://nymbot.ai/api/v1 |
| एन्थ्रोपिक एस. डी. के. और क्लाउडे कोड | https://nymbot.ai/api (SDK जोड़ता 😊 /v1/messages आप खुद) |
प्रत्येक एन्डप्वाइन्ट नीचे रहता है /api/v1/एस. आर..................................................................................................................................................................................................... 404 अउर एगो जानल रास्ता के अगर गलत तरीका से कॉल कइल जाव, त ऊ वापस कर देला। 405, दुनो JSON के रूप में।
API कवनो भी साइट से क्रॉस-ओरिजिन रिक्वेस्ट के जवाब देला, एहसे ब्राउज़र पेज एकरा के कॉल कऽ सकेला। बाकिर, राउर ब्राउज़र में जवन कुछुओ भेजेनी, ओकरा के उहे पढ़ सकेला जे ओकरा के खोलत बा, एहसे खाली ओही की (key) के साथ अइसन करीं जेकर एक्सेस बहुत कम होखे टोपी. राउर nym (keys, के अकाउंट summary, NWC auto-top-up अउर refund redemption) से साइन कइल गइल एंडपॉइंट्स अपवाद बाड़े: ब्राउज़र में ई खाली Nymbot के आपन साइट्स के जवाब देवेला। देखीं खाता के अनुरोधन पर हस्ताक्षर कइल.
हर एक JSON बॉडी के साथ भेजीं Content-Type: application/jsonरे....................................................................................................................................................................................................... 415सो, तो एक सादा एच. टी. एम. एल. रूप या एक text/plain कवनो दूसर साइट से कवनो रिक्वेस्ट API तक ना पहुँच पावत बा। cURL के साथ, पास करा
-H "Content-Type: application/json" के साथ -d.
API चाबी (API keys)
चाभी ऐप में बनल जाला। खोलऽ API वेब ऐप के साइडबार में, चाहे Android अउर iOS के मेनू में, ओकरा के दबाईं चाबी बनाएँरे.......................................................................................................................................................................................................
चाभी खाली एक बेर देखवल जाला। शीट बंद करे से पहिले एकरा के कवनो सुरक्षित जगह पर कॉपी कऽ लीं: Nymbot एकर खाली एक गो फिंगरप्रिंट राखले बा, एही से ई रउआ के एकरा के फेर से ना दिखा सकेला। खो गइल चाभी के वापस ना पावल जा सकेला; एकरा के रद्द करीं अउरी दूसर बना लीं।
एगो चाभी अइसन देखात बा sk-nymbot- आ.......................................................................................................................................................................................................
sk-nymbot-Qm7x…c2Lw.
- ए. आर. ई. आर. चाबीआ नोंथांनि एन. आई. एम. नि। आरएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएए
- क्याप्स सैट्स में हैं। "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "" "
403key_limit_reachedरे, भले ही जवाब कैप के तहत आया हो; त्रुटि बताती है कि कैप कितनी बची है और कब रीसेट होती है। लोवरिंगmax_tokensसबसे खराब स्थिति को कम करता है। एक अनुरोध पर वास्तव में लागत के अनुसार शुल्क लिया जाता है और जो कैप के खिलाफ गिना जाता है, इसलिए यदि प्रदाता अलग रखे गए टोकन से अधिक टोकन की रिपोर्ट करता है, तो आखिरी अनुरोध जो फिट बैठता है वह कुंजी को उसकी कैप से थोड़ा आगे ले जा सकता है; फिर अगले अनुरोध को अस्वीकार कर दिया जाता है। - एक खर्च की गई सीमा केवल खर्च करना बंद कर देती है। इसदे कैप पर एक की अभी भी शेष राशि की जाँच कर सकती है, इसके इतिहास को पढ़ सकती है, मॉडल को सूचीबद्ध कर सकती है, टोकन की गिनती कर सकती है, टॉप अप कर सकती है और उस वीडियो को देख सकती है जो उसने पहले ही शुरू कर दिया है।
- एक्सपायरी वैकल्पिक बा। रउआ जे तारीख तय कइले बानी, ओकरा बाद चाबी काम कइल बंद कर देले।
- रद्द कइल तुरंत अउर अंतिम बा। एक ठो रद्द कइल गइल चाबी अपना अगला अनुरोध में फेल हो जाला। एहके लिस्ट में रहल जाला, रद्द के निशान के साथ, ताकि एकर खर्चा के इतिहास अभी भी समझ में आ सके।
- रउआ अधिकतम 25 एक्टिव की (keys) रख सकेनी, जेकर अपना अलग नाम होई। कवनो की के रीसेट अवधि बदलला पर एगो नया अवधि शून्य से शुरू हो जाई।
उहे शीट में हर एगो की के एह अवधि के अउर कुल खर्च, ओकर आखिरी बार इस्तेमाल कइला के समय, राउर दुनो बैलेंस, अउर राउर हाल के API रिक्वेस्ट देखावल जाला। एकरा के पीछे वाला एंडपॉइंट्स के बारे में इहाँ के नीचे लिखल बा चाभी के प्रबंधन कइल.
एगो रिक्वेस्ट के प्रमाणीकरण कइल जा रहल बा
एह में से कवनो एक हेडर में की (key) भेज दीं। ई सब एकही नियर बाड़न, त ऊहे इस्तेमाल करीं जवन राउर क्लाइंट डिफॉल्ट रूप से भेजत बा:
| हेडरName | के द्वारा भेजल गइल |
|---|---|
Authorization: Bearer sk-nymbot-… | ओपनएआई एसडीके, अधिकांश उपकरण, क्लाउड कोड ANTHROPIC_AUTH_TOKEN |
x-api-key: sk-nymbot-… | Anthropic SDKs |
api-key: sk-nymbot-… | Azure-शैली के क्लाइंट्स |
एक लापता, अज्ञात, निरस्त या कालबाह्य कुंजी विवरणी 401, कोड के साथ
missing_api_key, invalid_api_key, revoked_api_key ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर.
expired_api_key. मॉडल, ऑडियो मॉडल आ आवाज, अउर भुगतान के तरीका के सूचीबद्ध कइला खातिर
कवनो की के जरूरत नईखे।
चित्र, वीडियो, भाषण, प्रतिलेखन और एम्बेडिंग्स को बिना किसी चाबी के लाइटनिंग पर एक बार में एक अनुरोध के लिए भी भुगतान किया जा सकता हैः बिना किसी चाबी के अनुरोध भेजें और चालान का भुगतान करें। 402 शीघ्र उत्तर दीजिये। बिना चाबी के प्रति अनुरोध भुगतान करना.
की मैनेजमेंट, अकाउंट सारांश अउरी ऑटोमैटिक टॉप-अप्स अपवाद बाड़न: ई राउर की के जगह राउर nym से हस्ताक्षर लेवेला, एहसे लीक भइल की से अउरी की ना बन सकेला। देखीं खाता के अनुरोधन पर हस्ताक्षर कइल.
रउआ पहिला अनुरोध
चाबी के एगो एनवायरनमेंट वेरिएबल में रख दीं, ओकरा बाद एगो मॉडल से कुछु पूछल जाव। ई पन्ना सभ में दिहल गइल उदाहरण ओकरा के एहिजा से पढ़ले बा NYMBOT_API_KEY.
cURL
export NYMBOT_API_KEY="sk-nymbot-..."
curl https://nymbot.ai/api/v1/chat/completions \
-H "Authorization: Bearer $NYMBOT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "nymbot/auto",
"messages": [{"role": "user", "content": "What is a Lightning invoice?"}]
}'
Python
import os
from openai import OpenAI
client = OpenAI(
base_url="https://nymbot.ai/api/v1",
api_key=os.environ["NYMBOT_API_KEY"],
)
reply = client.chat.completions.create(
model="nymbot/auto",
messages=[{"role": "user", "content": "What is a Lightning invoice?"}],
)
print(reply.choices[0].message.content)
JavaScript
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://nymbot.ai/api/v1",
apiKey: process.env.NYMBOT_API_KEY,
});
const reply = await client.chat.completions.create({
model: "nymbot/auto",
messages: [{ role: "user", content: "What is a Lightning invoice?" }],
});
console.log(reply.choices[0].message.content);
nymbot/auto का ई Nymbot के अपना रूटिंग ह, जेकर भुगतान स्टैंडर्ड बैलेंस से कइल जाई। ओहिजा कवनो कैटलॉग
मॉडल के id रख दीं, जइसे कि anthropic/claude-sonnet-5अर्थात, प्रो बैलेंस से उस मॉडल का उपयोग करने के लिए। मॉडलन के सूचीबद्ध कइल हर एगो ID देवेला।
कवनो रिक्वेस्ट के कतना लागत आवेला
API ठीक ओतने बिल बनावेला जइसन ऐप बनावेला।
- कौन सा संतुलन।
nymbot/autoनर खर्च करदा है मानक बेलेन्स (10 सैट्स प्रति क्रेडिट)। हर दूसरा चैट मॉडल खर्च करता है प्रो बैलेंस (100 sats क क्रेडिट)। स्टैंडर्ड इमेज जनरेटर अउर स्टैंडर्ड वॉइस स्टैंडर्ड क्रेडिट खर्चेला; बाकी सब जनरेटर Pro खर्चेला। एम्बेडिंग्स (Embeddings) स्टैंडर्ड क्रेडिट खर्चेला। ट्रांसक्रिप्शन (Transcription) तब स्टैंडर्ड क्रेडिट खर्चेला जब स्टैंडर्ड बैलेंस ओकरा के कवर कर सके, अउर ना त Pro क्रेडिट खर्चेला। मॉडल लिस्ट में लिखल होला कि कउनो मॉडल कउन बैलेंस खर्चेला। - कितियो? एक चैट अनुरोध टोकन पर मीटर किया जाता है जिसे मॉडल वास्तव में पढ़ता है और लिखता है, प्रदाता के प्रकाशित दरों पर। उस कीमत में 5 प्रतिशत शुल्क जोड़ा जाता है और फिर 1.5 से गुणा किया जाता है, इसलिए आप प्रदाता की सूची कीमत के गुना 1.575 का भुगतान करते हैं। यह लाइव बिटक्वाइन कीमत पर सैट्स में परिवर्तित हो जाता है और क्रेडिट के हजारवें हिस्से में चार्ज किया जाता है। प्रो चित्र, वीडियो और भाषण की कीमत प्रति पीढ़ी, प्रति सेकंड या प्रति वर्ण, और ऑडियो के प्रति सेकंड प्रतिलेखन की कीमत, समान शुल्क और मार्जिन के साथ होती है। मानक चित्र एक सपाट 5 मानक क्रेडिट है और मानक आवाज एक सपाट 3 है।
- न्युनतम. हर एगो मापित अनुरोध जे चलेला ओकर कम से कम 0.05 क्रेडिट लागत बा: स्टैंडर्ड बैलेंस पर आधा सैट, प्रो पर 5 सैट। क्रेडिट के हिस्सा आगे बढ़ जाला, हर बार ऊपर ना बढ़ाइल जाला।
- पकड़ो, फिर समझौता करो। निवेदन चलाने से पहले, आपने जो भेजा है और वह जो टोकन लिख सकता है, उसके आधार पर आपकी जमा राशि में से इसकी अधिकतम लागत रखी जाती है। सादा ए. एस. सी. आई. आई. के बाहर का पाठ इसके यू. टी. एफ.-8 बाइट्स से आकार में होता है, और ए. एस. सी. आई. आई. अंक और विराम चिह्न प्रत्येक टोकन के रूप में गिने जाते हैं, इसलिए किसी भी स्क्रिप्ट, कोड और संख्याओं में पाठ पूरी तरह से रखा जाता है। होल्ड पूरे क्रेडिट में होता है, कम से कम एक, इसलिए किसी भी अनुरोध को शुरू करने के लिए मानक शेष राशि पर कम से कम 10 सैट्स मुफ्त या प्रो पर 100 सैट्स की आवश्यकता होती है। केवल वास्तविक लागत ली जाती है; बाकी तब तक जारी की जाती है जब तक यह समाप्त हो जाता है। एक लंबा अनुरोध तब तक अपनी पकड़ बनाए रखता है जब तक यह चलता है; यदि आयोजित क्रेडिट वैसे भी उपलब्ध होना बंद हो जाता है, तो एक स्ट्रीम
402insufficient_balanceगलती वाला घटना, अउर जवन बनल बा ओकर शुल्क लागी। अगर असली लागत बचत से बेसी बा, त पूरा बचत ले लिहल जाई, बाकी पइसा देवे के पड़ी (owed_satsमेंnymbotवस्तु, अउरी एगो नकारात्मक बैलेंस)। जवन बकाया बा, उ अगिला क्रेडिट जे ओह बैलेंस में पहुँची, ओकरा में से पहिले चुकावल जाला। जब ले ऊ चुका नइखे भइल, तब ले ओह बैलेंस के कुछुओ खर्च नइखे कइल जा सकत: न API द्वारा, ऐप में रिप्लाई द्वारा, ट्रांसफर चाहे गिफ्ट द्वारा। - कवनो पर्याप्त क्रेडिट नइखे। अगर बैलेंस होल्ड के पूरा नइखे कर सकत, त रिक्वेस्ट के
एह वजह से मना कर दिहल जाई
402कवनो चीज चले के पहिले। एरर बतावत बा कि कवन बैलेंस कम बा, रिक्वेस्ट के कतना सैट्स (sats) चाही अउर कतना खाली बा। एगो छोट...max_tokensमतलब एगो छोट घेरा। - असफलता। एगो अइसन अनुरोध जवन फेल हो जाला ओकर कौनों दाम ना लागेला, जबले कि सेवा देवे वाला फेल होखे से पहिले कइल गइल काम खातिर बिल ना मांग ले, चाहे कवनो वेब सर्च चाहे...
nymbot/autoटास्क चेक Âएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएएए - वेब खोज $0.008 लागत एक खोज, सैट्स में परिवर्तित, जब भी कोई खोज चलती है, तो मॉडल जवाब देता है या विफल होता है। यह पढ़ने वाले पृष्ठ भी इनपुट के रूप में मॉडल को भेजे जाते हैं, इसलिए वे अपने टोकन जोड़ते हैं।
प्रत्येक प्रतिक्रिया बताती है कि इसकी लागत क्या है। जे. एस. ओ. एन. प्रतिक्रियाओं में एक मूल्य होता है। nymbot इसे जिस शेष राशि से भुगतान किया गया था, क्रेडिट और सैट्स में शुल्क, और क्या बचा हैः
लागत के वस्तु
"nymbot": {
"balance": "pro",
"charged_credits": 0.162,
"charged_sats": 16.2,
"balance_credits": 412.425,
"balance_sats": 41242.5
}
ادا की गई प्रतिक्रियाओं में ये हेडर भी होते हैं, जहाँ जे. एस. ओ. एन. न होने वाली प्रतिक्रिया की लागत की तलाश की जानी चाहिए, जैसे भाषणः
| हेडरName | शब्दरचनात्मक अर्थ |
|---|---|
X-Nymbot-Cost-Sats | सैट्स में, इस अनुरोध की कीमत क्या है। |
X-Nymbot-Balance-Sats | बाकी बचेली रकम जिसमे से चुकाई गई है, वह सैट्स में है। |
X-Request-Id | अनुरोध के लिए एक आईडी, प्रत्येक प्रतिक्रिया पर। यदि आप समर्थन से संपर्क करते हैं तो इसे उद्धृत करें। |
पहले से ही शुल्क और मार्जिन सहित, प्रति मिलियन टोकन के दर, में हैं
स्थिरीकृत माडल्-सूची $and sats, and on
प्राइस शीट. अगर बिटकॉइन के कीमत ना पढ़ल जा सके,
पेड रिक्वेस्ट वापस आवेला 503 price_unavailable संगे
Retry-After: 60 अंदाजा लगावे के बजाय।
त्रुटयः
हर एगो गलती के रूप एगो नियर बा, जवन OpenAI के ग्राहक पहिले से जानत बाड़न। code एगो स्थिर नाम बा जवना पर तू मिलान क सकत बाड़ऽ; message ई लोगन खातिर बा आ बदल सकेला।
एरर बॉडी
{
"error": {
"message": "This request needs up to 200 sats (2 credits) on your Pro balance, and 40 sats are free. Catalog models spend the Pro balance. Top up in the Nymbot app or with POST /api/v1/topup/create/btc-lightning.",
"type": "insufficient_quota",
"code": "insufficient_balance",
"param": null,
"balance": "pro",
"required_sats": 200,
"balance_sats": 40
}
}
| स्थिति | माब्ला? |
|---|---|
400 invalid_request_error | बॉडी वैध JSON नइखे (invalid_json), एगो जरूरी जानकारी छूट गइल बा (missing_required_parameter), मान गलत है, या अनुरोध कुछ ऐसा पूछता है जो मॉडल या एंडप्वाइंट नहीं करता है, जैसे कि उपकरण nymbot/auto (unsupported_tool). param रे क्षेत्र का नाम भी देता है। upstream_rejected जब प्रदाता अनुरोध को अस्वीकार कर देता है। |
401 authentication_error | चाभी गायब बा, अनजान बा, रद्द कइल गइल बा या एक्सपायर हो गइल बा, या कवनो साइन कइल रि्वेस्ट अमान्य बा या दोबारा इस्तेमाल कइल गइल बा। |
402 insufficient_quota | बैलेंस अनुरोध के पूरा ना कइ सकेला। Code insufficient_balanceखैर, के साथ balance, required_sats औरी balance_sats. |
403 permission_error | अनुरोध चाबी के कैप में फिट नाहीं आवत बा (key_limit_reachedखैर, के साथ limit_sats, used_sats औरी reset_at), भा अकाउंट सेवा के इस्तेमाल नइखे कर पावत (account_denied). |
404 not_found_error | एगो अनजाना राह (unknown_endpoint), एगो मॉडल जवन अस्तित्व में नइखे (model_not_found), चाहे कवनो अनजानी चाभी, बिल चाहे वीडियो। |
405 | रास्ता बा, बाकिर उ तरीका से ना (method_not_allowedrr). Allow हेडर उ तरीका बतावेला जवन ऊ लेवेला। |
413 | बॉडी भा फाइल बहुत बड़ बा (payload_too_large, file_too_large), चाहे कवनो रिकॉर्डिंग बहुत लम्बा बा (audio_too_long). देखऽ सीमा अउर हद. |
415 invalid_request_error | शरीर के रूप में नइखे भेजल जा रहल application/json (अउर, अपलोड एंडपॉइंट्स खातिर, multipart/form-data): unsupported_media_type. |
422 | एगो आवाज अउर भाषा जवन टेक्स्ट टू स्पीच में साथे ना जाला (voice_language_mismatch, unsupported_language). |
429 rate_limit_error | एह की (key) पर ढेर सारा रिक्वेस्ट आइल बा, ए адреस (address) से, भा अइसन क्रेडेंशियल (credentials) से जेके सत्यापित (verify) करे में फेल भइल बा (rate_limit_exceeded), अथवा प्रदाता दर-सीमित (upstream_rate_limitedr). सेकंड के लिए प्रतीक्षा करें Retry-After. |
500 api_error | निम्बॉट की तरफ कुछ गड़बड़ हो गई (internal_error). |
502 api_error | प्रदाता कवनो जवाब ना देले (upstream_error), या बिजली का चालान नहीं बनाया जा सका (invoice_unavailable). |
503 api_error | प्रदाता पर बहुत बोझ बा (upstream_overloaded), बिटकॉइन के कीमत ना पढ़ल जा सकेला (price_unavailable), चाहे सेवा के कवनो हिस्सा बंद बा (service_unavailable, media_hosting_unavailable). Retry-After जब फेर से कोसिस करे के बा, कहल जाला, जहाँ ई जानल जाला। |
दुगो अपवाद:
/api/v1/messagesAnthropic के एरर फॉर्मेट में जवाब, काहे कि ओही के Anthropic क्लाइंट्स पढ़ले (parse) करेला:{"type": "error", "error": {"type": "authentication_error", "message": "…"}}. प्रकार स्थिति के बाद आवेला:invalid_request_error,authentication_error,billing_error(402),permission_error,not_found_error,request_too_large,rate_limit_error,api_errorए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर.overloaded_error(503).- एगो स्ट्रीमिंग रिक्वेस्ट जवन अपना पहिला बाइट से पहिले फेल हो जाला, ओकरा के ऊपर दिहल गइल स्टेटस के साथ एगो साधारण JSON एरर मिलेला, इवेंट स्ट्रीम ना। स्ट्रीम शुरू भइला के बाद जवन फेलियर होला, ऊ ओही एंडपॉइंट के अपना फॉर्मेट में स्ट्रीम के आखिरी इवेंट के रूप में भेजल जाला।
एरर मैसेज में कबहूँ कौनों दूसर सर्विस के अंदरूनी जानकारी ना होला। कौनों प्रोवाइडर के आपन एरर राउर तक पहुँचे से पहिले बदल दिहल जाला।
नियमित सीमाएँ
| सीमा | कीमत |
|---|---|
| <<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<<< | 120 प्रति मिनट। ओकरा से ऊपर, 429 संगे Retry-After. |
| कूँजी के बिना गोहार | 120 प्रति मिनट प्रति पता, मॉडल, ऑडियो और भुगतान विधि सूचीकरण, धनवापसी टोकन चेक, और बिना चाबी या भुगतान के कॉल किए गए भुगतान किए गए अंतिम बिंदुओं के लिए। 429 संगे Retry-After. |
| प्रमाणीकरण असफल | चाबी, हस्ताक्षर, भुगतान कcredential आ रिफंड टोकन खातिर प्रति पता 30 प्रति मिनट, जेकर सत्यापन ना हो सके। ओकरा ऊपर, पता से आवत हर अनुरोध जेमें कcredential होखेला, ओकरा मिलेला 429 संगे Retry-After मिनिट खतम न हो जाने तक। मुख्य भाग को पढ़ने से पहले प्रमाण पत्रों की जाँच की जाती है। |
| नवा चाभी | 60 प्रति घंटा प्रति एन. आई. एम. और 120 प्रति घंटा प्रति पता। |
| टॉप-अप इन्वॉइस्स | 60 प्रति घंटा प्रति एन. आई. एम. और 120 प्रति घंटा प्रति पता। |
| NWC वॉलेट कनेक्शनन | हर nym खातिर 10 एक घंटा के दर पर अउर हर पता खातिर 30 एक घंटा के दर पर। वॉलेट रिले के इस्तेमाल करे के पड़ी wss:// स्टैंडर्ड पोर्ट पर। |
| टोकन के रिफंड | हर टोकन खातिर एक मिनट में 60 रिक्वेस्ट। |
| पतावा | हर एगो IPv6 एड्रेस के हर एगो प्रति-एड्रेस लिमिट में ओकर पूरा /64 के रूप में गिनल जाला, अउर एगो IPv4-mapped IPv6 एड्रेस के ओकर IPv4 एड्रेस के रूप में गिनल जाला। |
| जे. एस. ओ. एन. अनुरोध निकाय | 4 MB; राउर nym से साइन कइल गइल रिक्वेस्ट खातिर 64 KB। |
| मल्टीपार्ट रिक्वेस्ट बॉडी (अपलोड्स) | 32 MB. एगो फोटो जेकरा के एडिट कइल जा सकेला उ 20 MB तक के हो सकेला, एगो ऑडियो फाइल 25 MB तक के। जादा से जादा 64 भाग, हर एगो के जादा से जादा 8 KB के पार्ट हेडर, अउर 1 से 70 अक्षर के एगो बाउंड्री; ना त 400 invalid_multipart. |
| एगो चैट रिक्वेस्ट में फोटो | 20. हर एगो हऽ एगो https:// ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. ए. आर. http:// पब्लिक होस्ट, या a data:image/… URL. |
| इमेज खातिर जनरेशन के अनुरोध | 1 से 4 (n) |
| आउटपुट टोकन | प्रतिकृति मॉडल के अपने अधिकतम पर कैप्ड। एक बड़ा max_tokens एके कम क दिहल गइल बा, ना कि मना कइल गइल बा। |
| भाषण इनपुट | स्टैंडर्ड आवाज खातिर 800 अक्षर, Aura 2 खातिर 2,000। |
| लिप्यंतरण | 30 मिनट के ऑडियो, 25 MB। एगो लंबा रिकॉर्डिंग के मना कइल जाला ❌ 413 चार्जयुक्त, भले ही व्हिस्पर द्वारा सुनने के बाद ही इसकी लंबाई ज्ञात हो। |
| एम्बेडिंग्स | हर रिक्वेस्ट में १०० इनपुट। |
| वीडियो के नौकरी | जवन सब सबमिट कइल जाला ओकरा के 24 घंटा तक राखल जाला; एक घंटा बाद रेंडर छोड़ दिहल जाला। एगो nym खातिर एक साथे ढेर से ढेर 10 रेंडरिंग। |
| खोज के इतिहास | 90 दिन के लिए रखा गया। |
| प्रत्येक nym पर सक्रिय चाभी (keys) | 25. खाली सबसे नया 50 रद्द कइल गइल चाभी के राखल जाला। |
एगो तस्वीर के लिंक के एगो सार्वजनिक होस्ट के ओर इशारा करे के चाहीं: एगो निजी चाहे स्थानीय नेटवर्क पर के पता, या Nymbot के अपना साइट पर, मना कइल जाला। प्रोवाइडर पेसिंग जवन ऐप में लागू होला उ इहाँ भी लागू होला, तऽ एगो प्रोवाइडर के ओर ढेर सारा रिक्वेस्ट भेजला पर उ फेल होखे के बजाय धीमा कइल जा सकेला।
ए. पि. आइ. की देख सकदा है
API ऐप के नियन प्राइवेट नइखे, अउर ई कइसे बा, ओकरा बारे में एकदम साफ़-साफ़ बतावल जरूरी बा।
- एकर एंड-टू-एंड एन्क्रिप्शन नइखे। एप्प्स में, एक संदेश आपके उपकरण पर केवल निम्बॉट द्वारा धारण कीज़ के लिए सील कर दिया जाता है और एक संदेश के रूप में यात्रा करता है। गिफ्ट रैप कइलुएगो API रिक्वेस्ट साधारण HTTPS नियर होला: ई Nymbot तक पहुँचत घरी एन्क्रिप्टेड रहेला, अउरी Nymbot के सर्वर एकरा के हैंडल करे खातिर साफ-साफ पढ़ लेला।
- प्रॉम्ट आ जवाब सहेज के ना राखल जाला। उहवाँ मॉडल में जाला आ जवाब वापस आवेला। जेके रखल जाला उ बा बिल: हर रिक्वेस्ट खातिर समय, मॉडल, प्रकार, टोकन के गिनती, लागत, बैलेंस, की आ उ सफल भइल कि ना, 90 दिन ले, जेकर मतलब बा खोज के इतिहास दिखावत बा। ओही रिक्वेस्ट के इस्तेमाल के एगो रिकॉर्ड (समय, प्रकार, मॉडल, टोकन के गिनती, लागत, अवधि अउर का ऊ वेब सर्च के इस्तेमाल कइलस भा सफल भइल) ऐप के अपना रिकॉर्ड के साथे ९० दिनन ले राखल जाला।
- nym के लिए रखी गई बाकी हर चीज छोटी है और यहाँ सूचीबद्ध है। API चाबी (API keys) एक हैश के रूप में संग्रहीत किए जाते हैं, कभी भी कुंजी नहीं, उनके नाम के साथ, एक छोटा संकेत, खर्च की सीमा, रीसेट अवधि, समाप्ति और जब वे बनाए गए थे और आखिरी बार उपयोग किए गए थे; केवल नवीनतम 50 रद्द की रखे जाते हैं। ऑटोमैटिक टॉप-अप वॉलेट कनेक्शन के सुरक्षित रखल जाला, एकर थ्रेशोल्ड, राशि अउर आखिरी टॉप-अप के नतीजा के साथ एनक्रिप्ट क के। वीडियो जॉब्स के 24 घंटा खातिर रखल जाला। प्रति कॉल भुगतावल गइल रिक्वेस्ट के खाली एगो लाइटनिंग पेमेंट हैश 7 दिन खातिर अउर एगो हैश्ड रिफंड टोकन 30 दिन खातिर छोड़ल जाला, जेकर कवनो नाम से संबंध ना होला। जे चार्ज बैलेंस से ना भर पाइल, ओकरा के तब ले उधार मानल जाला जब तक टॉप-अप से ओकर भुगतान ना हो जाई।
- ऐप को वाइप करने से इसे हटा दिया जाता है। A पी. ए. आर. उपकरण पोंछ सभे API key के रद्द आ डिलीट कर देला, आ क्वेरी हिस्ट्री, इस्तेमाल के रिकॉर्ड, वॉलेट कनेक्शन आ वीडियो जॉब के डिलीट कर देला। बैलेंस आ कवनो बाकी रहल शुल्क nym पर रह जाला।
- मॉडल के प्रदाता राउर अनुरोध देखत बाड़न, जइसे कि ई ऐप से होला। कैटलॉग मॉडल ओकरा बनावे वाला के पासे चलेला; मानक रूट आ एम्बेडिंग क्लाउडफ्लेयर पर चलेला।
- बनावल गइल मीडिया सार्वजनिक बा। लिंक के रूप में वितरित चित्र और वीडियो सार्वजनिक ब्लॉसम फाइल होस्ट पर अपलोड किए जाते हैं, जहां एक फाइल का पता उसका हैश होता है। लिंक वाला कोई भी व्यक्ति इसे खोल सकता है, और निम्बॉट इसे फिर से नीचे नहीं ले जा सकता है। के लिए पूछें
b64_jsonअउर एगो बनावल गइल फोटो रिस्पॉन्स में आ जाला अउर कबहूँ अपलोड ना होला। - तऽ का रउआ जवन फोटो देले बानी ऊ कवनो जनरेटर ह? एक तस्वीर जिस पर आप अपलोड करते हैं
सुधारल जाव, चाहे एगो के रूप में भेजीं
data:एगो जनरेटर के URL मेंimage_urlउदाहरण के लिए, पहले एक सार्वजनिक ब्लॉसम होस्ट पर अपलोड किया जाता है ताकि जनरेटर इसे ला सके, और वही उस पर लागू होता है।https://रैफर लिंक को उस लिंक के रूप में भेजा जाता है। चैट अनुरोध में चित्र मॉडल के प्रदाता के पास जाते हैं, न कि ब्लॉसम के पास। - एक गो चाबी राउर nym से जुड़ल बा। जे कुछुओ एगो की (key) खर्च करेला ऊ राउर nym के बैलेंस से कट जाला, एहसे API के इस्तेमाल ना हवे अनामित्वरे.......................................................................................................................................................................................................
अगर आपको ऐप की सुरक्षा की आवश्यकता है, तो ऐप का उपयोग करें। एपीआई तब होता है जब आपको अपने स्वयं के उपकरणों में मॉडल की आवश्यकता होती है।
प्रत्येक अन्तिम बिन्दु
| एन्डपॉइंट | ई का करेला | प्रमाणीकरण |
|---|---|---|
GET /api/v1/models | मॉडल के सूची बनावेला, दाम के साथ | कोई नहीं |
POST /api/v1/chat/completions | चैट कॉम्प्लीशन्स | चाबी |
POST /api/v1/responses | रिस्पॉन्स API | चाबी |
POST /api/v1/messages | मानवशास्त्रीय सन्देश | चाबी |
POST /api/v1/messages/count_tokens | इनपुट टोकन का अनुमान लगाता है | चाबी |
POST /api/v1/images/generations | तस्वीर बनावेला | चाभी चाहे आकाशीय बिजली |
POST /api/v1/images/edits | एगो फोटो के एडिट कइला | चाभी चाहे आकाशीय बिजली |
POST /api/v1/videos, GET /api/v1/videos, GET /api/v1/videos/{id} | वीडियो प्रारंभ, सूचीबध्द, और जाँच | चाभी, चाहे आकाशीय बिजली एकटा शुरू करे खातिर |
POST /api/v1/audio/speech | लिखल बात के बोलल | चाभी चाहे आकाशीय बिजली |
GET /api/v1/audio/models, GET /api/v1/audio/voices | ऑडियो मॉडल अउर आवाजु | कोई नहीं |
POST /api/v1/audio/transcriptions, POST /api/v1/audio/translations | पाठ पर भाषण, और अंग्रेजी पर भाषण | चाभी चाहे आकाशीय बिजली |
POST /api/v1/embeddings | एम्बेडिंग्स | चाभी चाहे आकाशीय बिजली |
GET /api/v1/credits/balance (अथवा POST) | दोनो तुलन | चाबी |
GET /api/v1/topup/payment-methods | पइसा देवे के तरीका | कोई नहीं |
POST /api/v1/topup/create/btc-lightning | एगो लाइटनिंग इनवॉइस | चाबी |
GET /api/v1/topup/status/{invoice_id} | जाँचला अउरी क्रेडिट कइल जाला | चाबी |
GET /api/v1/queries/history | हर एगो रिक्वेस्ट के कतना लागत बा | आरएआर की या एन. आई. एम. |
GET /api/v1/account | खाता के सारांश | Nym |
/api/v1/keys | चाबी बनावेला, बदलत रहेला आ रद्द कर देला | Nym |
/api/v1/nwc-auto-topup | अपने आप रिचार्ज | Nym |
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeem | रिफंड टोकन के जाँच करेला भा ओकरा के भुनावेला | रिफंड टोकन; रिडीम करने के लिए nym |
"Nym" के मतलब होला राउर Nostr key से साइन कइल एगो रिक्वेस्ट, जेके ... में बतावल गइल बा खाता के अनुरोधन पर हस्ताक्षर कइल। ऊ औज़ार सभ खातिर जे ई फॉर्मेट में पहिले से बात करेला, देखल जाव टूल्स अउर SDKsक्लॉड कोड, कोडेक्स और क्लाइन जैसे कोडिंग एजेंटों के लिए, देखें कोडिंग टूल्स.