ज्ञान के आधार डेवलपरस
एपीआई अवलोकन
अहाँ एपमे जे मॉडल, जनरेटर आ संतुलनक उपयोग करैत छी, ओ अहाँक अपन कोडसँ होइत अछि। एपीआई ओपनएआई आ एंथ्रोपिक प्रारूपक बात करैत अछि, तेँ बेसी उपकरण आ एसडीके बेस यूआरएल आ कीकेँ बदलि कऽ काज करैत अछि।
सुविधा के लेल ई पृष्ठ मशीन सं अनुवादित अछि. अंग्रेजी मूल संस्करण अछि जे लागू होइत अछि।
API की अछि?
एक HTTP API पर nymbot.ai जे ओहि अनुरोधक जवाब दैत अछि जे ओपनएआई या एंथ्रोपिक क्लाइंट पहिनेसँ पठा चुकल अछि। अहाँकेँ भेटैत अछिः
- गपशप समाप्ति, ओ रिस्पॉन्स API आओर एन्थ्रोपिक सन्देश (Anthropic Messages), स्ट्रीमिंग, उपकरण, चित्र, तर्क आ वेब खोजक संग, प्रत्येक मॉडलक लेल सूची आ निम्बॉटक अपन ऑटो-रूटिंगक लेल।
- छविसभ, वीडियो, भाषण, लिपिकरण आओर एम्बेडिंग्स.
- अहांक संतुलन, लाइटनिंग टॉप-अप्स, अहाँक बटुआसँ स्वचालित टॉप-अप त एवं इतिहास प्रत्येक अनुरोधक लागत कतेक अछि।
एकर भुगतान ओही दू सँ कयल जाइत अछि। संतुलन एपक रूपमे, समान दामपर। एपीआई पर कोनो सदस्यता नहि अछि आ कोनो निःशुल्क भत्ता नहि अछिः प्रत्येक अनुरोधक भुगतान अहाँ द्वारा किनल गेल क्रेडिटसँ कयल जाइत अछि।
API जे नहि करैत अछि, ओ अछि Nymbotक अपन कोनो चीज जोड़ब। अहाँक संदेश ओहिना मॉडल क पास जाइत अछि जहिना अहाँ भेजल छी: कोनो Nymbot सिस्टम प्रॉम्प्ट नहि, कोनो स्मृति नहि, कोनो तिथि वा भाषाक संकेत नहि। जे वापस आबैत अछि, ओ अछि मॉडलक उत्तर आ ओकर लागतक एकटा नोट।
आधार URLs
| प्रयोग | आधार URL |
|---|---|
| ओपनएआई एसडीके आ ओपनएआई-संगत उपकरण | https://nymbot.ai/api/v1 |
| एंथ्रोपिक एसडीके आ क्लाउड कोड | https://nymbot.ai/api (SDK जोड़ैत अछि /v1/messages स्वयं) |
हर एक एंडपॉइंट एहि के नीचाँ रहैत अछि /api/v1/एकटा अज्ञात मार्ग वापस आबि जाइत अछि। 404 आ एकटा जानल पथ जे गलत विधि सँ कॉल कयल गेल अछि, ओ वापस करैत अछि। 405, दुनू जे. एस. ओ. एन. क रूपमे।
API कोना साइट सँ क्रॉस-ओरिजिन रिक्वेस्टक उत्तर दैत अछि, तए ब्राउज़र पेज एकरा कॉल क' सकैत अछि। मुदा, अहाँ ब्राउज़र में जे कोनो चीज भेजैत छी ओकरा खोले वाला कोनो भी व्यक्ति पढ़ि सकैत अछि, तए केवल ओहि की (key) सँ ई क' एघि जेकर अधिकार सीमित हो। टोपीअहाँक एन. आई. एम. क सङ्ग हस्ताक्षरित अन्तिम बिन्दु (कुंजी, खाता सारांश, एन. डब्ल्यू. सी. ऑटो-टॉप-अप आ रिफंड रिडेम्पशन) अपवाद अछिः ब्राउज़रमे ओ मात्र निम्बॉटक अपन साइटक उत्तर दैत अछि। देखू। खाता अनुरोध पर हस्ताक्षर करू।.
प्रत्येक जे. एस. ओ. एन. बॉडीक संग पठाउ। Content-Type: application/jsonकोनो अन्य प्रकारसँ मना कऽ देल जाइत अछि। 415अतः एकटा सादा एच. टी. एम. एल. रूप या एकटा text/plain दोसर साइटसँ अनुरोध एपीआई धरि नहि पहुँच सकैत अछि। सीयूआरएलक सङ्ग, पास करू।
-H "Content-Type: application/json" के संग -d.
API कुञ्जी (API keys)
एपमे चाबी बनाओल जाइत अछि। खोलू। एपीआई वेब एपक साइडबार मेँ, वा Android आ iOS मेँ मेनू मेँ, आ टैप करू कुंजी बनाउएकरा एकटा नाम दियौ आ, जँ अहाँक इच्छा हो तँ, एकटा सीमा आ समाप्ति तिथि सेहो दियौ।
चाबीकेँ एक बेर देखाओल जाइत अछि। शीटकेँ बन्द करबासँ पहिने एकरा सुरक्षित ठाम प्रतिलिपि बनाउः निम्बॉट मात्र एकर एकटा फिंगरप्रिंट रखैत अछि, जाहिसँ ई अहाँकेँ फेरसँ नहि देखा सकय। एकटा गमाओल चाबीकेँ पुनः प्राप्त नहि कयल जा सकैत अछि; एकरा वापस लऽ कऽ दोसर बनाउ।
एकटा चाबी एहन देखाइत अछि। sk-nymbot- एकर बाद 43 अक्षर, अंक, डैश आ अंडरस्कोर होइत अछि। एप प्रत्येक कुंजीकेँ ओकर नाम आ छोट सङ्केतक सङ्ग सूचीबद्ध करैत अछि जेना -
sk-nymbot-Qm7x…c2Lw.
- एकटा चाबी अहाँक एन. आई. एम. क अछि। एहि सँ अहाँक बैलेंस खर्च भ जाएत अछि, आ केवल अहाँक nym ही एकर निर्माण, परिवर्तन वा निरस्तीकरण क' सकैत अछि। जे कोनो कियो की (key) क पास अछि, ओ एकर माध्यम सँ खर्च क' सकैत अछि, तहि लेल एकरा पासवर्ड जकाँ मानू।
- कैप्स सैट्स में अछि। एकटा कुंजीक खर्चक सीमा भऽ सकैत अछि, आ सीमा हर दिन, हर सप्ताह (सोम) या हर महीना (पहिल), 00:00 यूटीसी पर रीसेट भऽ सकैत अछि। ई दुनू शेष राशिकेँ गिनैत अछि, एकटा मानक क्रेडिट 10 सैटक रूपमे आ एकटा प्रो क्रेडिट 100क रूपमे, तेँ एकर अर्थ अछि जे कोनो अनुरोध जे किछु शेष राशि खर्च करैत अछि। कोनो अनुरोध चलबासँ पहिने, एकर सबसँ बेसी लागत (पूरा क्रेडिट धरि गोल कयल जा सकैत अछि) कैपक शेष भागक विरुद्ध निर्धारित कयल जाइत अछि। यदि ई फिट नहि होइत अछि, तखन अनुरोधकेँ मना कऽ देल जाइत अछि।
403key_limit_reached, भले ही जवाब कैप के तहत आया हो; त्रुटि बताती है कि कितना बचा है और कैप कब रीसेट होती है। लोवरिंगmax_tokensसबसँ खराब स्थितिकेँ कम करैत अछि। एकटा अनुरोधसँ ओ शुल्क लेल जाइत अछि जे एकर वास्तविक लागत अछि आ जे कैपक विरुद्ध गिनती करैत अछि, तेँ जँ प्रदाता अलग राखल गेल सँ बेसी टोकनक सूचना दैत अछि, तँ अन्तिम अनुरोध जे फिट होइत अछि, चाबीकेँ ओकर कैपसँ किछु दूर लऽ जा सकैत अछि; तकर बाद अगिला मना कऽ देल जाइत अछि। - एकटा खर्च भऽ गेल टोपी मात्र खर्च रोकि सकैत अछि। एकर टोपी पर एकटा चाबी तखन सेहो शेष राशि के जाँच कऽ सकैत अछि, एकर इतिहास पढ़ सकैत अछि, मॉडल के सूची बना सकैत अछि, टोकन गिन सकैत अछि, टॉप अप कऽ सकैत अछि आ ओहि वीडियो के जाँच कऽ सकैत अछि जे ओ पहिने सँ शुरू कऽ चुकल अछि।
- समाप्ति वैकल्पिक अछि। अहाँ जे तिथि निर्धारित कऽ देलहुँ, ओकरा बाद चाबी काम करब बंद कऽ दएत।
- रद्द करब तत्क्षत आ अन्तिम अछि। एकटा रद्द कएल की अपन अगला अनुरोध विफल करैत अछि। ई सूची मे रद्द कएल चिह्नित रहैत अछि, ताकि एकर खर्चक इतिहास आओर से अर्थपूर्ण रहैत अछि।
- अहाँ लग 25 धरि सक्रिय कुंजी भऽ सकैत अछि, जाहिमे सँ प्रत्येकक अपन नाम होयत अछि। कुंजीक रीसेट अवधि बदलबासँ शून्य पर एकटा नव अवधि शुरू होयत अछि।
एकहि शीट प्रत्येक कुंजीक एहि अवधिक खर्चकेँ देखबैत अछि आ कुल मिला कऽ, जखन एकर अन्तिम बेर उपयोग कयल गेल छल, अहाँक शेष राशि आ अहाँक हालक एपीआई अनुरोध दुनूकेँ देखबैत अछि। एकर बादक अंतिम बिन्दुकेँ नीचाँ प्रलेखित कयल गेल अछि। कunci व्यवस्थापन.
कोनो अनुरोधकेँ प्रमाणित कयल जा रहल अछि।
एहि मे सँ कोनो एकटा हेडर मे चाबी पठाउ। ओ बराबर छै, तेँ जे किछु अहाँक ग्राहक डिफ़ॉल्ट रूप सँ पठाए ओकर उपयोग करूः
| शीर्षक | पठाओल गेल। |
|---|---|
Authorization: Bearer sk-nymbot-… | ओपनएआई एसडीके, अधिकांश उपकरण, क्लाउड कोडक संग ANTHROPIC_AUTH_TOKEN |
x-api-key: sk-nymbot-… | Anthropic SDKs |
api-key: sk-nymbot-… | एज़्योर-शैलीक ग्राहकसभ |
लापता, अज्ञात, निरस्त या समाप्त कुंजी विवरणी 401, कोडक संग
missing_api_key, invalid_api_key, revoked_api_key अथवा
expired_api_key. मॉडल, ऑडियो मॉडल आ आवाज, आ भुगतानक तरीकाक सूची बनाबक लेल कोनो की (key)क आवश्यकता नहि अछि।
लाइटनिंग पर एक बेरमे एकटा अनुरोधक लेल चित्र, वीडियो, भाषण, प्रतिलेखन आ एम्बेडिंगक भुगतान सेहो कयल जा सकैत अछि जाहिमे कोनो चाबी नै अछिः बिना कोनो चाबीक अनुरोध पठाउ आ चालानमे भुगतान करू। 402 जवाब दियौक। देखू। बिना चाबीके प्रति अनुरोधक भुगतान करू।.
कुंजी प्रबंधन, खाता सारांश आ स्वचालित टॉप-अप अपवाद अछिः ओ चाबी के बजाय अहाँक एन. आई. एम. सँ हस्ताक्षर लैत अछि, तेँ एकटा लीक भेल चाबी बेसी चाबी नहि बना सकैत अछि। खाता अनुरोध पर हस्ताक्षर करू।.
अहाँक पहिल अनुरोध
की (key) केँ एकटा एनवायरनमेंट वेरिएबल (environment variable) में राखू, ओकर बाद मॉडल सँ किछु पुछू। एहि पानाँक सब उदाहरण ओहि सँ पढ़ैत अछि 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 नैम्बॉटक अपन रूटिंग अछि, जे मानक शेष राशिसँ भुगतान कयल जाइत अछि। एकर बदला एकटा कैटलॉग मॉडलक आईडी राखू, जेना कि anthropic/claude-sonnet-5, प्रो बैलेंससँ ओहि मॉडलक उपयोग करबाक लेल। प्रतिरूपक सूची बना रहल अछि। सभ आइ. डी. दैत अछि।
एकटा अनुरोधक लागत कतेक छै
API ठीक ओहिना बिलिंग करैत अछि जहिना ऐप करैत अछि।
- कोन संतुलन।
nymbot/autoखर्च करैत अछि। मानक शेष राशि (10 सैट्स प्रति क्रेडिट)। प्रत्येक अन्य चैट मॉडल खर्च करैत अछि प्रो बैलेंस (१०० sats क्रेडिट)। मानक इमेज जनरेटर आ मानक वॉयस मानक क्रेडिट खर्च करैत अछि; हुनकाँ इतर सभ जनरेटर प्रो (Pro) खर्च करैत अछि। एम्बेडिंग (Embeddings) मानक क्रेडिट खर्च करैत अछि। ट्रांसक्रिप्शन मानक क्रेडिट खर्च करैत अछि जखन मानक बैलेंस ओकरा ढोके सकैत होइ, आ अन्या क्रम में प्रो क्रेडिट। मॉडल सूची बताबैत अछि जे प्रत्येक मॉडल कन बैलेंस खर्च करैत अछि। - कतेक? एकटा चैट अनुरोध ओहि टोकन पर आधारित अछि जे मॉडल वास्तव में पढ़ल आ लिखल अछि, प्रदाताक प्रकाशित दर पर। ओहि दाम में ५% शुल्क जोड़ल जाइत अछि आ तख ओकरा १.५ सँ गुणा कएल जाइत अछि, तें अहाँ प्रदाताक सूची मूल्यक १.५७५ गुना भुगतान करैत छी। एकरा लाइव बिटकॉइन मूल्य पर sats में परिवर्तित कएल जाइत अछि आ एक क्रेडिटक हजार भाग में शुल्क लियो जाइत अछि। व्यावसायिक चित्र, वीडियो आ भाषणक मूल्य प्रत्येक जनरेशन, प्रत्येक सेकंड वा प्रत्येक अक्षर के अनुसार निर्धारण कएल जाइत अछि, आ प्रतिलिपिकरण (transcription) ऑडियोक प्रत्येक सेकंड के अनुसार, ओहि समान शुल्क आ मार्जिन कें सँ। मानक चित्र ५ मानक क्रेडिट आ मानक आवाज ३ मानक क्रेडिटक अछि।
- न्यूनतम। प्रत्येक मीटर अनुरोध जे चलैत छैक ओकर लागत कम सँ कम 0.05 क्रेडिट होइत छैकः मानक शेष राशि पर आधा सैट, प्रो पर 5 सैट। क्रेडिट के अंश केँ पूरा कैल जायत छैक, हर बेर पूरा नहि कैल जायत छैक।
- थमू, तखन ठाम जाउ। कोनो रिक्वेस्ट चलबा सँ पहिने, अहाँक बैलेंस सँ ओकर अधिकतम लागत रोक क' राखल जाइत अछि, जे अहाँक द्वारा भेजल गेल सामग्री आ अधिकतम संभव टोकनक आधार पर तय क' कएल जाइत अछि। साधारण ASCII सँ बाहरक टेक्स्ट केँ ओकर UTF-8 बाइट्स सँ मापल जाइत अछि, आ ASCII अंक आ विराम चिह्न केँ एक-एक टोकन मानल जाइत अछि, ताहि सँ कोनो सेहो लिपि, कोड आ अंक सभ केँ पूरा रूप सँ रोक क' राखल जाइत अछि। ई रोक पूर्ण क्रेडिट में होइत अछि, कम सँ कम एक, ताहि सँ कोनो रिक्वेस्ट शुरू करबा लेल स्टैंडर्ड बैलेंस में कम सँ कम 10 sats या प्रो (Pro) में 100 sats के आवश्यकता अछि। केवल वास्तविक लागत क' लेल चार्ज कएल जाइत अछि; बाकी के राशि काम पूरा भ' जाइत काल मुक्त क' द' देल जाइत अछि। एकटा लंबा रिक्वेस्ट जतेक बेर चलैत अछि, ओतेक बेर ओकर होल्ड कायम रहैत अछि; जँ रोकल गेल क्रेडिट उपलब्ध नहि रहैत अछि, तँ स्ट्रीम एकटा... सँ रुक जाइत अछि।
402insufficient_balanceत्रुटि भेल, आ जे उत्पन्न भेल ओकरा पर शुल्क लगाओल जाइत अछि। यदि वास्तविक लागत शेष राशिसँ बेसी अछि, तँ सम्पूर्ण शेष राशि लऽ लेल जाइत अछि, शेष बकाया अछि (owed_satsओहि मेnymbotवस्तु, आ एकटा नकारात्मक शेष। जे बकाया अछि ओहि ओ प्राप्त होइत सं अगिला क्रेडिट सं सबस पहिले चुकाओल जाइत अछि। जब तक ओ चुका क' नहि जाइत, ओ शेष राशि सं किछु सेहो खर्च नहि क' सकल जा सकैत अछि: API द्वारा, ऐप मे उत्तर, transfert या उपहार द्वारा नहि। - पर्याप्त ऋण नहि। यदि शेष राशि होल्डकेँ पूरा नहि कऽ सकैत अछि तखन अनुरोधकेँ अस्वीकार कऽ देल जाइत अछि।
402कोनो चीज दौड़ै सं पहिने। एरर कहैत अछि जे कोना बैलेंस कम अछि, रिक्वेस्ट कतेक sats चाही आ कतेक खाली अछि। एकटा छोटmax_tokensमतलब छोट पकड़। - असफलतासभ। एकटा अनुरोध जे विफल भऽ जाइत छैक ओकर कोनो दाम नहि पड़ैत छैक, जखन तक प्रदाता विफल होयबासँ पहिने कयल गेल काजक बिल नहि दैत छैक, या वेब खोज या भुगतान नहि करैत छैक।
nymbot/autoकार्य जाँच कएल गेल छल; तखन ओहिना अहाँक भुगतान केल जाइत अछि, कम से कम 0.05 क्रेडिट। अहाँ जे स्ट्रीम काटि दऽ दऽ रहल छी, ओहिमे प्रदाता जे टोकन के रिपोर्ट करैत अछि, ओकर शुल्क लागैत अछि: Nymbot अहाँक छोड़ि कऽ जालाक बाद २ तक २५ सेकंड धरि प्रदाताक स्ट्रीम के पढ़ैत रहैत अछि ताकि ओहि गणना क सकै। जँ ओ प्राप्त नहि होइत अछि, तँ शुल्क अहाँक द्वारा भेजिल आ लिखल सामग्री सँ अनुमानित कयल जाइत अछि, आ तर्क देबय वाला मॉडल लेल एहिमे होल्डक पूरा आउटपुट अलाउंस शामिल अछि। एहन अनुरोध जेकर कनेक्शन टूटि जाइत अछि, ओ सेहो पूर्ण होइत अछि आ ओकर शुल्क लागैत अछि। - वेब खोज्नु एकटा खोजक लागत $0.008 होइत अछि, जकरा सैट्समे परिवर्तित कयल जाइत अछि, जखन सेहो कोनो खोज चलैत अछि, चाहे मॉडल तखन जवाब दैत अछि वा विफल होइत अछि। जे पृष्ठ ओ पढ़ैत अछि ओकरा सेहो इनपुटक रूपमे मॉडल पर पठाओल जाइत अछि, तेँ ओ अपन टोकन जोड़ैत अछि।
प्रत्येक प्रतिक्रिया बतबैत अछि जे एकर लागत कतेक अछि। जे. एस. ओ. एन. प्रतिक्रियामे एकटा मूल्य होइत अछि। nymbot जे शेष राशिसँ एकर भुगतान कयल गेल छल, क्रेडिट आ सैट्समे शुल्क, आ की शेष रहि गेल अछि, ओहि पर आपत्ति उठाउः
लागत वस्तु
"nymbot": {
"balance": "pro",
"charged_credits": 0.162,
"charged_sats": 16.2,
"balance_credits": 412.425,
"balance_sats": 41242.5
}
सशुल्क उत्तर सँ एहि हेडर सभ सेहो मिलैत अछि, जतय अहाँ ओहि उत्तरक लागत देखि सकैत छी जे JSON नहि अछि, जँ जे स्पीच (speech) थिक:
| शीर्षक | अर्थ। |
|---|---|
X-Nymbot-Cost-Sats | एहि अनुरोधक लागत कतेक अछि, सैट्समे। |
X-Nymbot-Balance-Sats | शेष राशिमे जे किछु शेष रहि गेल अछि, ओकर भुगतान सतमे कयल गेल अछि। |
X-Request-Id | अनुरोधक लेल एकटा आईडी, प्रत्येक प्रतिक्रिया पर। यदि अहाँ समर्थनसँ सम्पर्क करैत छी तऽ एकरा उद्धृत करू। |
दर प्रति दस लाख टोकन, पहिनेसँ शुल्क आ मार्जिन सहित, मे अछि
मॉडलक सूची डॉलर आ सैट्स मे, आ पर
मूल्य पत्रकयदि बिटक्वाइनक दाम नहि पढ़ल जा सकैत अछि तखन भुगतान कयल गेल अनुरोध वापस आबि जायत अछि। 503 price_unavailable संग-संग
Retry-After: 60 अनुमान लगाबय के बजाय।
त्रुटि सभ
प्रत्येक त्रुटिक आकार एकहि होइत छैक, ओपनएआईक ग्राहक पहिनेसँ बुझैत छथि। 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_allowed) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द) द 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 | एहि कुंजी पर, एहि पता सँ, या परिचय पत्रक संग बहुत रास अनुरोध अछि जे सत्यापित करबामे विफल रहल (rate_limit_exceeded), वा प्रदाता दर-सीमित (rate-limiting) क रहल अछि (upstream_rate_limited)। सेकण्ड धरि प्रतीक्षा करू। 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 क्लाइंट द्वारा पार्स कएल जाइत अछि:{"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).- एकटा स्ट्रीमिंग अनुरोध जे अपन पहिल बाइटक पहिने विफल भऽ जाइत छैक ओकरा उपरोक्त स्थितिक संग एकटा साधारण जे. एस. ओ. एन. त्रुटि भेटैत छैक, इवेंट स्ट्रीम नहि। स्ट्रीम शुरू भेलाक बाद एकटा विफलता ओहि एंडप्वाइंटक अपन प्रारूपमे स्ट्रीमक अंतिम इवेंटक रूपमे पठायल जायत छैक।
त्रुटि संदेशमे कखनो सेहो दोसर सेवाक आंतरिक विवरण नै रहैत अछि। कोनो प्रदाताक अपन त्रुटि अहाँ तक पहुँचय सँ पहिने फेर सँ लिखल जाइत अछि।
सीमा।
| सीमा | मूल्य |
|---|---|
| प्रति कुंजी अनुरोध | १२० प्रति मिनट। ओकर सँ बेसी, 429 संग-संग Retry-After. |
| बिना चाबीक अनुरोध। | प्रत्येक पताक लेल प्रति मिनट १२०, मॉडल, ऑडियो आ भुगतान विधिक सूचीक लेल, रिफंड टोकन जाँचक लेल, आ बिना कोनो की (key) वा भुगतानक भुगतान कएल गेल एंडपॉइंट्सक लेल। ओकरा उपेर, 429 संग-संग Retry-After. |
| प्रमाणीकरण विफल भेल | कुंजी, हस्ताक्षर, भुगतान प्रमाण पत्र आ धनवापसी टोकनक लेल प्रति पता 30 प्रति मिनट जे सत्यापित नहि होइत अछि। एकर ऊपर, पता सँ प्रत्येक अनुरोध जाहि पर प्रमाण पत्र होइत अछि, प्राप्त होइत अछि। 429 संग-संग Retry-After जाबत धरि मिनट खतम नहि भऽ जाइत अछि। मुख्य भाग पढ़बा सँ पहिने परिचय पत्रक जाँच कयल जाइत अछि। |
| नय चाबियाँ | प्रत्येक nym कें घंटाक ६० आ प्रत्येक पता कें घंटाक १२०। |
| टॉप-अप चालानसभ | प्रत्येक nym कें घंटाक ६० आ प्रत्येक पता कें घंटाक १२०। |
| एन. डब्ल्यू. सी. बटुआ कनेक्शन | 10 प्रति घंटा प्रति एन. आई. एम. आ 30 प्रति घंटा प्रति पता। बटुआ रिलेक उपयोग करय पड़त। wss:// मानक पोर्ट पर। |
| रिफंड टोकन | 60 प्रति मिनट प्रति टोकन अनुरोध करैत अछि। |
| पता सभ | एकटा आईपीवी6 पता प्रत्येक प्रति पता सीमा मे एकर पूरा/64 के रूप मे गिनैत छै, आर एकटा आईपीवी4-मैप्ड आईपीवी6 पता एकर आईपीवी4 पता के रूप मे गिनैत छै। |
| जे. एस. ओ. एन. अनुरोध निकाय | 4 MB; 64 KB अहाँक nym सँ हस्ताक्षर कएल अनुरोधक लेल। |
| बहुभागीय अनुरोध निकाय (अपलोड) | 32 एमबी। सम्पादन लेल एकटा चित्र 20 एमबी धरि भऽ सकैत अछि, एकटा ऑडियो फाइल 25 एमबी धरि भऽ सकैत अछि। बेसीसँ बेसी 64 भाग, प्रत्येकमे बेसीसँ बेसी 8 केबी भाग शीर्षक, आ 1 सँ 70 वर्णक सीमा; अन्यथा 400 invalid_multipart. |
| एकटा चैट रिक्वेस्ट में चित्रसभ | 20. प्रत्येक एकटा अछि। https:// अथवा http:// कोनो सार्वजनिक होस्टसँ लिंक करू, या एकटा data:image/… यूआरएल। |
| छवि प्रति पीढ़ी अनुरोध | 1 सँ 4 (n) |
| आउटपुट टोकन | मॉडलक अपन अधिकतम सीमा पर सीमित। एकटा पैघ max_tokens एकरा नीचा देखाओल जाइत अछि, मना नहि कयल जाइत अछि। |
| भाषण इनपुट | मानक आवाज लेल 800 वर्ण, ऑरा 2 लेल 2,000। |
| लिप्यन्तरण | 30 मिनटक ऑडियो, 25 एमबी। एकटा पैघ रिकॉर्डिंगसँ मना कऽ देल जाइत अछि। 413 तथा कोनो शुल्क नीहि द' लागल, हुनकाक लंबाई तखनहिं पता चलैत अछि जखन Whisper ओकरा सुनि लेलहुँ। |
| एम्बेडिंग्स | प्रति अनुरोध १०० इनपुट। |
| वीडियो जॉब्स | जमा कयलाक बाद 24 घण्टाक लेल राखल जाइत अछि; एकटा रेंडर एक घंटाक बाद छोड़ि देल जाइत अछि। बेसीसँ बेसी प्रति निमे एक बेरमे 10 रेंडर कयल जाइत अछि। |
| पूछताछक इतिहास | ९० दिन लेल राखल गेल। |
| प्रत्येक nym प्रति सक्रिय की (keys) | 25. मात्र नवतम 50 रद्द कएल गेल की (keys) कें राखल जाइत अछि। |
एकटा चित्रक लिंककेँ सार्वजनिक होस्टकेँ इंगित करबाक चाहीः कोनो निजी या स्थानीय नेटवर्क पर, या निम्बॉटक अपन साइट पर एकटा पता, मना कऽ देल जाइत अछि। ऐपमे लागू होबयवला प्रदाता पेसिंग अहिँ सेहो लागू होइत अछि, तेँ एकटा प्रदाता केँ अनुरोधक विस्फोट विफल होयबाक बदला धीमा कैल जा सकैत अछि।
एपीआई की देखि सकैत अछि
एप जेना निजी छै, एपीआई ओना निजी नै छै, आ ई सटीक होय के लायक छै कि केना छै।
- एकर एंड-टू-एंड एन्क्रिप्शन नै छै। एपमे अहाँक उपकरण पर एकटा सन्देशकेँ सील कऽ देल जाइत अछि जे केवल निम्बॉट द्वारा धारण कैल गेल आ यात्रा कैल गेल चाबीक लेल अछि। उपहार कें लपेटबएकटा एपीआई अनुरोध साधारण एचटीटीपीएस होइत छैकः एकरा निम्बॉटक बाटमे कूटबद्ध कयल जाइत छैक, आ निम्बॉटक सर्वर एकरा संभालबाक लेल एकरा स्पष्ट रूपसँ पढ़ैत छैक।
- प्रॉम्प्ट आ उत्तर सँगाल क' क' राखल नै जाइत अछि। ओ मॉडल तक पहुँचैत अछि आ जवाब वापस चलि जाइत अछि। जे राखल जाइत अछि ओ बिल थिकः प्रत्येक अनुरोधक लेल समय, मॉडल, प्रकार, टोकन गिनती, लागत, शेष राशि, चाबी आ ई सफल भेल कि नहि, 90 दिनक लेल, जे अछि। पूछताछक इतिहास अहाँकेँ देखबैत अछि। ओही अनुरोधक उपयोग रिकॉर्ड (समय, प्रकार, मॉडल, टोकन गणना, लागत, अवधि आ कि ओ वेब खोजक उपयोग कयलक वा सफल भेल) सेहो एपक अपनक सङ्ग 90 दिनक लेल राखल जाइत अछि।
- nym क लेल बाकी सब किछु छोट अछि आ एतय सूचीबद्ध कएल गेल अछि। API कुञ्जी (API keys) हुनकर नाम, एकटा छोट संकेत, खर्चक सीमा, रिसेट अवधि, समाप्ति आ कखन बनाओल गेल आ कखन अंतिम बार उपयोग कयल गेल केंह कें साथ, एकरा हैश के रूप में सहेज क' राखल जाइत अछि, कखनो की (key) के रूप में नहि; मात्र नवतम ५० रद्द कयल गेल की (keys) के राखल जाइत अछि। एकटा स्वचालित टॉप-अप बटुआ कनेक्शनकेँ कूटबद्ध कयल जाइत छैक, एकर सीमा, राशि आ अन्तिम टॉप-अपक परिणामक सङ्ग। वीडियो कार्य 24 घण्टाक लेल राखल जाइत छैक। प्रति कॉल भुगतान कयल गेल अनुरोध मात्र 7 दिनक लेल एक लाइटनिंग भुगतान हैश आ 30 दिनक लेल एक हैश रिफंड टोकन छोड़ैत छैक, जे कोनो एन. आई. एम. सँ जुड़ल रहैत छैक। शेष राशि केँ कवर नहि कयल जा सकैत छैक जखन धरि टॉप-अप ओकरा भुगतान नहि करैत छैक।
- ऐप के वाइप करब सँ ओ डिलीट भ' जाइत अछि। A डिभाइस मिटाबना प्रत्येक एपीआई कीकेँ निरस्त आ हटा दैत अछि, आ क्वेरी हिस्ट्री, उपयोग रिकॉर्ड, वॉलेट कनेक्शन आ वीडियो जॉब्सकेँ हटा दैत अछि। शेष राशि आ कोनो शुल्क तखन सेहो एन. आई. एम. पर बनल रहैत अछि।
- मॉडलक प्रदाता अहाँक अनुरोध देखैत अछि।कैटलॉग मॉडल अपन निर्माता पर चलैत अछि; मानक मार्ग आ एम्बेडिंग क्लाउडफ्लेयर पर चलैत अछि।
- जनरेटेड मीडिया सार्वजनिक अछि। लिंक क रूप में भेजल गेल चित्र आ वीडियो सार्वजनिक ब्लॉसम फ़ाइल होस्ट पर अपलोड कएल जाइत अछि, जतय फ़ाइलक पता ओकर हैश अछि। लिंक वाला कोनो सेहो ओकरा खोलि सकैत अछि, आ निम्बोट ओकरा फेर सँ हटा नहि सकैत अछि। मांगू
b64_jsonआ उत्पन्न चित्र प्रतिक्रियामे वापस आबि जाइत अछि आ कखनहु अपलोड नहि कयल जाइत अछि। - तखनी अहाँ जे तस्वीर दइत छी, ओ कि कोनो जनरेटर अछि? एकटा चित्र जे अहाँ अपलोड कयलहुँ अछि।
सम्पादन करू।, या एकटा के रूप मे पठाउ
data:जनरेटरक यूआरएलimage_url, पहिने एकटा सार्वजनिक ब्लॉसम होस्ट पर अपलोड कयल जाइत अछि जाहि सँ जनरेटर एकरा लऽ जा सकय, आ ओही ओहि पर लागू होइत अछि।https://लिंक ओहि लिंकक रूपमे देल जाइत अछि। गपशप अनुरोधमे चित्र मॉडलक प्रदाता लग जाइत अछि, ब्लॉसम पर नहि। - एकटा चाबी अहाँक एन. आई. एम. सँ जुड़ल अछि। की (key) जे किछु खर्च करैत अछि सेहो अहाँक nym केँ बैलेंस सँ कटैत अछि, तइँ API केँ प्रयोग करब नै अछि बेनामीयदि अहाँ चाहैत छी जे अहाँक रोज़ानाक nym सँ अलग API प्रयोग भेल, त' अपन अलग balance वाला पृथक nym सँ keys बनाउ।
जँ अहाँकेँ ऐपक सुरक्षाक आवश्यकता अछि तँ ऐपक उपयोग करू। एपीआई तखन होयत अछि जखन अहाँकेँ अपन उपकरणमे मॉडलक आवश्यकता होयत अछि।
हर एक एंडपॉइंट
| अन्तिम बिन्दु | की करैत अछि | ओउथ |
|---|---|---|
GET /api/v1/models | मॉडलक सूची देखाइत अछिदामक संग | कोनो नै |
POST /api/v1/chat/completions | गपशप समाप्ति | चाबी |
POST /api/v1/responses | रिस्पॉन्स API | चाबी |
POST /api/v1/messages | एन्थ्रोपिक सन्देश (Anthropic 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 | लेखा सारांश | नहि। |
/api/v1/keys | कुंजी बनबैत अछि, बदलैत अछि आ निरस्त करैत अछि। | नहि। |
/api/v1/nwc-auto-topup | स्वचालित टॉप-अप्स | नहि। |
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeem | रिफंड टोकनकेँ चेक अथवा रिडीम करैत अछि। | धनवापसी टोकन; रिडीम करबाक लेल एन. आई. एम. |
& ldquo; Nym & rdquo; क अर्थ अछि अहाँक नोस्टर कुंजी द्वारा हस्ताक्षरित एकटा अनुरोध, जाहिमे वर्णित अछि खाता अनुरोध पर हस्ताक्षर करू।एहन उपकरणक लेल जे पहिनेसँ एहि प्रारूपक बात करैत अछि, देखू। उपकरण आ एसडीके, आ क्लाउड कोड, कोडेक्स आ क्लाइन सन कोडिंग एजेंटक लेल, देखू कोडिंग उपकरणसभ.