गिन्यानाचो आदार विकसक
ए. पी. आय. नदरावणी
तुमी ऍप्लिकेशनांत वापरपी मॉडेल्स, जनरेटर आनी बॅलन्स तुमच्या स्वताच्या कोडांतल्यान. एपीआय ओपनएआय आनी एंथ्रोपिक फॉरमॅट उलयता, देखून चडशीं साधनां आनी एसडीके मुळावी यूआरएल आनी किल्ली बदलून काम करतात.
हें पान सोयी खातीर मशीनांतल्यान अणकारीत केलां. इंग्लीश मूळ ही आवृत्ती लागू जाता.
एपीआय कितें?
एक HTTP API आनी nymbot.ai तीं तेच राखाणों (requests) पळयता जशे एका OpenAI वा Anthropic
क्लायंट (client) लागून डेगता. तुमकां मेळटा:
- चॅट कॉम्प्लिशन्स, हें प्रतिसाद एपीआय आनी मानवशास्त्रीय संदेश, स्ट्रीमिंग, टूल्स, चित्र, तर्क आनी वेब सर्च संगे, प्रत्येक मॉडेल खातीर आनी कॅटलॉग आनी निमबोटाच्या स्वताच्या ऑटो-रुटींगा खातीर.
- चित्रां, व्हिडियो, भास, लिखाण आनी एम्बेडिंग्स.
- तुमचें समतोल, वीज पडपी टॉप-अप, तुमच्या वॉलेटांतल्यान ऑटोमॅटीक टॉप-अप आनी अ इतिहास प्रत्येक विनंतीची किंमत कितली?
हें त्याच दोगां कडल्यान फारीक करतात. समतोल अॅप प्रमाणेंच, तेच भाव. API वर कोणतीच सबस्क्रिप्शन वा फ्री अलोवन्स ना: तुमकां मेळिल्ल्या प्रत्येक विनंती खातीर तूंनी विकत घेतिल्ल्या क्रेडिट्स पसून पयस करावें लागता.
ए. पी. आय. जें करिना तें म्हणल्यार निम्बॉटाचें स्वताचें कितेंय जोडप. तुमी धाडिल्ले भशेन तुमचे संदेश मॉडेलाचेर वतातः निम्बॉट सिस्टिम प्रॉम्प्ट ना, मेमरी ना, तारीख वा भाशेचे संकेत नात. परत जें येता तें मॉडेलाचें उतर आनी ताचो खर्च कितलो आसा हाची नोंद.
मुळावी यू. आर. एल.
| वापरात | बेस URL |
|---|---|
| ओपनएआय एसडीके आनी ओपनएआय-सुसंगत साधनां | https://nymbot.ai/api/v1 |
| Anthropic SDKs आनी क्लॉड कोड | https://nymbot.ai/api (SDK सादता /v1/messages स्वता) |
प्रत्येक एंडपॉइंट (endpoint) ह्याच्या सकितल्या रावता /api/v1/एक अजाणेंवो रस्तो परत येता 404 आनी चुकीची पद्दत वापरून कॉल केल्लो एक ज्ञात मार्ग परत येता 405, दोनूय जे. एस. ओ. एन. म्हणून.
API कोनादरेन (cross-origin) requests केंनाचेंय साइटानसावन उपकार करता, देखूनें एका ब्राउझर पेजान तें कॉल करूंक शकता. पूण, तूं ब्राउझरान जे कांयय वठायता तें कोणय उद्घोटून पळोवंक शकता, देखून फकत तेंचें कोदना सावन कर, ज्याची मर्यादा कमी आसा टोपीतुमच्या nym (keys, account summary, NWC auto-top-up आनी refund redemption) घालून साक्षांकित केल्ल्या endpoints अपवाद आसात: ब्राउझरर तें फकत Nymbot च्याच साइट्सक उतरानां. पळयात खात्याच्या विनंतीनतींचे साक्षरता (signing account requests).
प्रत्येक JSON बॉडी सोदून }: Content-Type: application/jsonहेर खंयच्याय प्रकाराक न्हयकार दितात. 415, तर एक सादो HTML फॉर्म वा एक text/plain दुसर्या сайтаकडल्यान आयिल्लो
अनुरोध (request) API ला पावस ना. cURL वापरून, पाठवा
-H "Content-Type: application/json" सोदें उपरांत -d.
API कीज
ॲपान किल्ली मान्य करतात. उघडप. एपीआय वेब अॅपच्या साइडबारान्चे, वा अँड्रॉइड आनी iOS च्या मेनूचेर, आनी टॅप करा की (Key) तयार कराताका एक नांव दियात आनी, तुमकां जाय जाल्यार, एक कॅप आनी म्हयन्याची तारीख दियात.
ही किल्ली एक फावटीच दिसतली. शीट बंद करचे पयली ती खंय तरी सुरक्षित सुवाठाय मदीं कॉपी करा: Nymbot तिचो फकत फिंगरप्रिंट दवरता, देखून तें तुका परतून दाखोवंक शकना. गमायिल्ली किल्ली परत मेळोवंक येना; ती रद्द करा आनी दुसरी बटना.
एक किल्ली अशा दिसता sk-nymbot- ४३ अक्षरांनी, अंकांनी, डॅशानी आनी
अंडरस्कोर्सांनी मागील येता. ॲप प्रत्येक की (key) तिच्या नावान आनी एका ल्हान सूचनेन (hint) वराता, जशें की
sk-nymbot-Qm7x…c2Lw.
- एक किल्ली तुमच्या एन. आय. एम. ची आसता. तें तुजी शिल्लक खर्च करता, आनी फकत तुजो एन. आय. एम. तें करपाक, बदलपाक वा रद्द करपाक शकता. चावी धरपी कोणूय ताचे वांगडा खर्च करूंक शकता, देखून ताका पासवर्ड सारकें मानचें.
- कॅप्स सॅटांत आसतात. एका किल्लीचेर खर्चाची मर्यादा आसूं येता, आनी मर्यादा दर दिसा, दर सप्तकांत (सोमार) वा दर म्हयन्याक (पयली), 00:00 यूटीसीचेर परतून थारावंक शकता. तातूंत दोनूय शिल्लक मेजतात, 10 सॅट प्रमाण क्रेडीट आनी प्रो क्रेडीट 100 म्हणून, देखून ताचो अर्थ विनंती खर्च करता तितलीच शिल्लक आसता. विनंती चलोवचे पयलीं, ताचो चडांत चड खर्च (पुराय क्रेडीट मेरेन गोल) कॅप उरल्या ताचे आड सेट करतात. ती बसना जाल्यार, विनंती न्हयकारतात
403key_limit_reached, जाप कॅपा खाला आयिल्ली आसली तरी; कॅप कितली उरल्या आनी केन्ना रीसेट जाता तें त्रुटी सांगता. लोवरिंगmax_tokensती सगळ्यांत वायट स्थिती कमी करता. एका विनंत्याक प्रत्यक्षांत कितलो खर्च जाता तें शुल्क घेतात आनी तें कॅप आड मेजतात, देखून पुरवणदार वेगळे दवरिल्ले परस चड टोकन नोंद करता जाल्यार, निमाणें बसपी विनंती किल्ली ताच्या कॅपापसून मातशी फुडें व्हरूंक शकता; मागीर फुडली न्हयकारतात. - एक वतायिल्लो टोपी फकत वतायपाकच थांबयता. ताच्या कॅपाचेर आशिल्ली किल्ली अजूनय शिल्लक तपासूंक शकता, ताचो इतिहास वाचूंक शकता, मॉडेलांची वळेरी करूंक शकता, टोकन मेजूंक शकतात, टॉप अप करूंक शकतात आनी पयलींच सुरू केल्ल्या व्हिडियोचेर तपासूंक शकतात.
- कालबद्धता (Expiry) ऐच्छिक आसा. तुमी थारायिल्ली तारीख सोंपतकच किल्ली काम करप बंद करता.
- रद्द करप तात्काळ आनी अंतिम आसा. एका रद्द करिल्ल्या की (key) चूनें तिचें फुडेंचें रिक्वेस्ट फेल जाता. ती लिस्टांतच उरता, रद्द केली म्हणल्यान चिडायलल्यान, ताची खर्चाची इत्यिहास (spending history) अजूनय अर्थपूर्ण उरता.
- तुमचे २५ सकयल चालू की (keys) आसूंक शकतात, ताच्या मुखार ताचो म्हत्वाचो नांव आसूंक शकता. कीचो रिसेट काळांत बदलल्यार, नवो काळ शून्या सावन सुरू जाता.
तीच पत्रक दरेका किल्लीचो ह्या काळांतलो खर्च दाखयता आनी वट्ट, तो निमाणें वापरलो तेन्ना, तुजी शिल्लक आनी तुजी हालींची एपीआय विनंत्यो दोनूय दाखयता. ताचे फाटले निमाणें बिंदू सकयल नोंद केल्यात. किल्ल्यांचे व्यवस्थापन करप.
रिक्वेस्ट प्रमाणीकरण करप
हातूंतल्या खंयच्याय एका हेडरांत किल्ली धाडची. ती समकक्ष आसतात, देखून तुमचो गिरायक पूर्वनिर्धारीतपणान जें धाडटा तें वापरचेंः
| हेडर | धाडलां |
|---|---|
Authorization: Bearer sk-nymbot-… | OpenAI SDKs, चड करून टूल्स, Claude Code संगे ANTHROPIC_AUTH_TOKEN |
x-api-key: sk-nymbot-… | एंथ्रोपीक एस. डी. के. |
api-key: sk-nymbot-… | एझ्यूर-शैलीचे गिरायक |
एक गहाळ, अजाणें, रद्द केल्लें वा मुदत संपिल्लें की (key) वळटता. 401, कोडा वांगडा
missing_api_key, invalid_api_key, revoked_api_key अतवी
expired_api_keyमॉडेलांची वळेरी करप, ऑडियो मॉडेल आनी आवाज, आनी फारीकणी पद्दती खातीर किल्लीची गरज ना.
चित्रां, व्हिडियो, भाशण, प्रतिलेखन आनी एम्बेडिंग्स एकाच वेळार एका विनंत्या खातीर विजेचेर कसलीच किल्ली नासतना फारीक करूंक शकतातः एक नासतना विनंती धाडची आनी चलन फारीक करचें. 402 जाप दिवची. पळय. चावी नासतना दर विनंतीक फारीक कर.
किल्ली वेवस्थापन, खात्याचो सारांश आनी स्वयंचलित टॉप-अप हे अपवाद आसातः ते किल्ली बदला तुमच्या एन. आय. एम. कडल्यान स्वाक्षरी घेतात, देखून फुटिल्ली किल्ली चड किल्ली तयार करूंक शकना. खात्याच्या विनंतीनतींचे साक्षरता (signing account requests).
तुजी पयली विनंती
चावी एका एन्व्हायरनमेंट व्हेरिएबल मदीं दवरा, मग एका मॉडेलक कितें तरी विचार. ह्या पानांचेर आसपीं उदहरणां ताका सावन वाचतात. 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 सॅट्स क्रेडिट). दर हेर चॅट मॉडेल खर्च करता प्रो बैलन्स (100 sats क्रेडिट). स्टँडर्ड इमेज जनरेटर आनी स्टँडर्ड व्हॉइस स्टँडर्ड क्रेडिट्स वापरतात; बाकी सगळी जनरेटर्स Pro वापरतात. एम्बेडिंग्स स्टँडर्ड क्रेडिट्स वापरतात. ट्रान्सक्रिप्शन स्टँडर्ड क्रेडिट्स वापरता देखून, जेंय स्टँडर्ड बैलन्स ताका सकयल उरता, आनी न्हय तर Pro क्रेडिट्स वापरतात. मॉडेल्सच्या लिस्टान सांगाता की प्रत्येक मॉडेल खंयचो बॅलन्स वापरता. - कितलें. चॅट विनंती प्रदात्याच्या प्रकाशीत दरा प्रमाण मॉडेल प्रत्यक्षांत वाचपी आनी बरयल्ल्या टोकनांचेर मिटर करतात. त्या दरांत 5 टक्के शुल्क भरतात आनी मागीर 1.5 ने गुणाकार करतात, देखून तुमी प्रदात्याच्या वळेरेच्या मोलाचे 1.575 पटींनी फारीक करतात. ताका लायव्ह बिटक्वॉइन किंमतीचेर सॅटांत रुपांतरीत करतात आनी क्रेडिटाच्या हजाराव्या भागांत शुल्क घेतात. प्रो पिक्चर, व्हिडियो आनी स्पीच दर जनरेशन, दर सेकंद वा दर अक्षरांत, आनी ऑडियोच्या दर सेकंदांत प्रतिलेखन, समान शुल्क आनी मार्जिन आसता. मानक चित्र सपाट 5 मानक क्रेडिट्स आनी मानक आवाज सपाट 3 आसता.
- उण्यांत उणें. प्रत्येक मेटरड रिक्वेस्ट जी चालू जाता ती किमान 0.05 क्रेडिट खर्च करता: स्टँडर्ड बॅलन्सचेर अर्दो सॅट, प्रो (Pro) वरी 5 सॅट्स. क्रेडिटचे अंश फुडें सांबाळले जातात, दरवेळा वयर राउंड न्हय करता.
- धरात, मागीर स्थीर करात. विनंती चलोवचे पयलीं, तुमी कितें धाडलां आनी तो बरोवंक शकता त्या सगळ्यांत चड टोकनांचेर आदारून तुमच्या बॅलन्सांतल्यान सगळ्यांत चड खर्च जाता. सादो एएससीआयआय भायलो मजकूर ताच्या युटीएफ-8 बाईटांतल्यान आकाराचो आसता, आनी एएससीआयआय अंक आनी विरामचिन्हे दरेका टोकन म्हणून मेजतात, देखून खंयच्याय लिपींतलो मजकूर, कोड आनी संख्या पुरायपणान धरतात. धरून दवरप पुराय क्रेडीटांत आसता, उण्यांत उणें एक, देखून खंयच्याय विनंतीक प्रमाण बॅलन्सांत उण्यांत उणें 10 सॅट फुकट वा प्रोचेर 100 सॅट सुरू करपाची गरज आसता. फकत प्रत्यक्ष खर्च आकारतात; बाकीचो तो सोंपता तेन्ना सोडटात. एक लांब विनंती तो चलता तो मेरेन धरून दवरता; धरून दवरिल्ले क्रेडीट उपलब्ध जावप बंद जाल्यार प्रवाह थांबता.
402insufficient_balanceत्रुटी घडणूक, आनी जें तयार जालें तें शुल्क घेतात. प्रत्यक्ष खर्च शिल्लक फारीक करपाक शकता ताचे परस चड आसल्यार, पुराय शिल्लक घेतात, उरिल्लें उरता (owed_satsम्हजेरnymbotऑब्जेक्ट, आनी निगेटिव्ह बॅलन्स). जे उरिल्लें आसा तें त्या बॅलन्सांत पावपी फुडल्या क्रेडीटांतल्यान पयलीं फारीक करतात. तें फारीक करिनासतना त्या बॅलन्सावयलीं कांयच खर्च करूंक शकताः एपीआय वरवीं न्हय, ऍप्लिकेशनांत जाप दिवप, हस्तांतरण वा भेटवस्तू दिवप. - पुरेसा क्रेडिट ना. शिल्लक धरून दवरूंक शकना जाल्यार विनंती न्हयकारतात
402कितेंय चलचे पयलीं. खंयचें शिल्लक उणें आसा, विनंतीक कितले सॅट जाय आनी कितले फुकट आसात तें त्रुटी सांगता. एक ल्हानmax_tokensम्हणजेच चड उणें धरप. - नाकामी. एक विनंती जी फालट जाता ताका कांयच खर्च जात ना, जो मेरेन पुरवठादारान ताच्या फालट जावपाच्या पयलीं केल्ल्या कामाचो बिलना केलो ना, वा वेब सर्च वा तें
nymbot/autoटास्क चेक जाल्यार, तेंच तुमकां भरावे लागता, किमान ०.०५ क्रेडिट. जो स्ट्रीम तुम्ही कापतात, ताचेर प्रोव्हायडर जे टोकन्स सांगतात ताका लागून शुल्क लागता: तुम्ही वचून गेल्या उपरांतही, तो आकडो मेळोवपाक निम्बॉट (Nymbot) प्रोव्हायडरच्या स्ट्रीम वाचत रावता, जाणे २५ सेकंदां पयलीं. जर तो आकडो मेळना, तर तुम्ही काय धाडल्यार आनी काय बरपें जालें तें पळोवन शुल्क आकणीकरण करतात, आनी विचार करपी मॉडेल खातीर, तें पूर्ण आउटपुट अलाउन्स समाविष्ट करता. ज्या रिक्वेस्टचें कनेक्शन तुटता, ती तरी पूर्ण जाता आनी ताचें शुल्क लागता. - वॅब सोद एका सर्चान $0.008 खर्च जातात, जें सत्स (sats) मध्ये बदलून येता, जेन्नाय सर्च चालू जाता, मग मॉडेलान उत्तर दिली तरी वा नासतली. ती वाचपी पानांय मॉडेलक इनपुट सारखी आययत दिलां वता, देखून तांची टोकन्स वता.
दर एका प्रतिसादाक कितलो खर्च जाता तें सांगता. जे. एस. ओ. एन. प्रतिसादांत कितलो खर्च जाता तें सांगता. nymbot Object, jem tea balance-an pay kel'lem, credits ani sats-antlem charge, ani kitem baki asa:
खर्चाचो विशय
"nymbot": {
"balance": "pro",
"charged_credits": 0.162,
"charged_sats": 16.2,
"balance_credits": 412.425,
"balance_sats": 41242.5
}
फारीक केल्ल्या प्रतिसादांत हे हेडर लेगीत आसतात, जे. एस. ओ. एन. नाशिल्ल्या प्रतिसादाचो खर्च सोदपाक जाय, जशें भाशणः
| हेडर | अर्थ. |
|---|---|
X-Nymbot-Cost-Sats | ह्या विनंतीची किंमत कितली, sats इंत? |
X-Nymbot-Balance-Sats | बॅलेंसान कतले सात्स् (sats) उरले आसात? |
X-Request-Id | विनंती खातीर एक आयडी, दर एका प्रतिसादाचेर. तुमी समर्थनाकडेन संपर्क केल्यार तो उद्धृत करात. |
दर दशलक्ष टोकनांचे दर, पयलींच शुल्क आनी मार्जिन धरून, हातूंत आसात
मॉडेलांची वळेरी डॉलर आनी सॅटांत, आनी
दरपत्रक. Jednam Bitcoin-achem bhav vochpak zaina,
pay korya torana requests fuddem yetat 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 | बॉडी वैध जे. एस. ओ. एन. न्हय (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) च्या कॅप सावन न्हय (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) पळय. मर्यादावोन (Maryadavo). |
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), वा पुरवणदार दर मर्यादीत करता (upstream_rate_limited). कांय सेकंद वाट पळय. Retry-After. |
500 api_error | Nymbot च्या वटेन कांयतरी चुकल्यांत (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/messagesएंथ्रोपीकच्या एरर फॉरमॅटांत जाप दिता, कारण एंथ्रोपीक क्लायंट तेच विश्लेशण करतातः{"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).- पयले बाईट येवचे पयलीं अपेशी थारिल्ली स्ट्रीमींग विनंती वयर दिल्ल्या स्थितीक लागून एक सामान्य जे. एस. ओ. एन. त्रुटी मेळटा, इव्हेंट स्ट्रीम न्हय. स्ट्रीम सुरू जाले उपरांत अपेस आयल्यार स्ट्रीमाची निमाणो इव्हेंट म्हूण, त्या एन्डपॉईंटच्या स्वताच्या फॉरमॅटांत धाडटात.
त्रुटी संदेशांत केन्नाच दुसऱ्या सेवेचो आंतरीक तपशील आसना. प्रदात्याची स्वताची चूक तुजे कडेन पावचे पयलीं परतून उतरायतात.
मर्यादा
| मर्यादा | मोल |
|---|---|
| दरेका किल्ली खातीर विनंत्यो | 120 दर मिनटाक. ताचे वयर, 429 वांगडाच Retry-After. |
| चावी नासतना विनवणी | 120 प्रती मिनट दर पत्त्याचेर, मॉडेल, ऑडियो आनी फारीकणी पद्दतीची वळेरी, परताव्याची टोकन तपासणी, आनी फारीक केल्लें एन्डपॉईंट किल्ली वा फारीकणी नासतना फोन करतात. ताचे वयर, 429 वांगडाच Retry-After. |
| प्रमाणीकरण अपेशी थारलें | चावी, स्वाक्षरी, फारीकणी प्रमाणपत्रां आनी खात्री करूंक नाशिल्ल्या रिफंड टोकनां खातीर दर पत्त्याक 30 मिण्टां. ताचे वयर, प्रमाणपत्र आशिल्ल्या पत्त्या वयल्यान दर विनंतीक मेळटा 429 वांगडाच Retry-After मिनट सोंपता मेरेन. बॉडी वाचचे पयलीं प्रमाणपत्रां तपासतात. |
| नवी किल्ली | 60 दर वराक आनी 120 दर वराक दर पत्त्याचेर. |
| टॉप-अप पावत्या | 60 दर वराक आनी 120 दर वराक दर पत्त्याचेर. |
| एन. डब्ल्यू. सी. वॉलेट जोडणी | प्रत्येक nym खातीर तासाक १० आनी प्रत्येक पत्त्या खातीक तासाक ३०. वॉलेट रिले लागीं वापरपाचें पडटा. wss:// स्टँडर्ड पोर्टर फाटल्यान. |
| रिफंड टोकन्स | एक टोकन पर मिनिटाक 60 विनंती. |
| पत्ता (Pattā) | दर एका पत्त्याच्या मर्यादेत आय. पी. व्ही. 6 पत्तो ताचो पुराय/64 म्हणून मेजतात, आनी आय. पी. व्ही. 4-मॅप केल्लो आय. पी. व्ही. 6 पत्तो ताचो आय. पी. व्ही. 4 पत्तो म्हणून मेजतात. |
| जे. एस. ओ. एन. विनंती संस्था | 4 MB; तुमचे nym वापरून साइन केल्ल्याक लागपी requests खातीर 64 KB. |
| मल्टीपार्ट रिक्वेस्ट बॉडी (अपलोड) | 32 एम. बी. संपादन करपाचें एक चित्र 20 एम. बी. मेरेन, ऑडियो फाइल 25 एम. बी. मेरेन आसूं येता. चडांत चड 64 भाग, दर एका भागांत चडांत चड 8 के. बी. भाग हेडर, आनी 1 ते 70 अक्षरांची शीम; नाजाल्यार 400 invalid_multipart. |
| एका चॅट विनंतींत चित्रां | 20. दरेकाचें एक https:// अतवी http:// एका सार्वजनिक होस्टचो लिंक, वा एको data:image/… यू.आर.एल. |
| प्रति पिढी विनंती प्रतिमा | 1 ते 4 (n) |
| आउटपुट टोकन | मॉडेलाच्या स्वताच्या चडांत चड मर्यादेचेर बंद केला. एक व्हड max_tokens ताका उणो करतात, न्हयकारनात. |
| भास इनपुट | ८०० अक्षरांक स्टँडर्ड व्हॉइस खातीर, २,००० Aura 2 खातीर. |
| प्रतिलेखन | 30 मिनटांचो ऑडियो, 25 एमबी. चड लांब रेकॉर्डिंग न्हयकारतात 413 व्हिस्परान आयकल्या उपरांतच ताची लांबाय कळटा तेन्ना लेगीत चार्ज करचो ना. |
| एम्बेडिंग्स | दर विनंतीक 100 इनपुट. |
| व्हिडियो कार्यां | सादर केल्या उपरांत 24 वरां दवरतात; एका वरा उपरांत एक रेंडर सोडटात. चडांत चड 10 रेंडरिंग एकाच वेळार दर निमांत. |
| चवकशीचो इतिहास | 90 दीस दवरलें. |
| सक्रिय किज प्रती एन. आय. एम. | 25. फकत नवे 50 रद्द केल्ले किल्ली दवरतात. |
एका चित्राचो लिंक एक फावट पब्लिक होस्ट कडेन आसपाक जाय: खाजगी वा स्थानिक नेटवर्कचेर आसपील पत्तो, वा Nymbot च्या स्वतःच्या साइट्सचेर आसपील पत्तो, नाकारपाचो. ॲप मदल्यान उपेग जावपी प्रदाता पेसिंग (Provider pacing) हांगादेखील लागू जाता, देखून एका प्रदात्याक मेळपी भरपूर विनंती (burst of requests) नाकारपाच्या सोनुस्थानी धीमे केल्यार वचतले.
एपीआय कितें पळोवंक शकता?
ऍप्लिकेशनां जशें खाजगी आसा तशे एपीआय खाजगी ना, आनी कशें तें नेमकेपणान सांगप गरजेचें.
- तें एन्ड-टू-एन्ड एनक्रिप्टेड आसना. ऍप्लिकेशनांत, तुमच्या डिव्हायसाचेर फकत निम्बॉट धरून दवरपी आनी प्रवास करपी किल्लीचो संदेश बंद केला. गिफ्ट रॅपएक ए. पी. आय. विनंती म्हळ्यार सामान्य एच. टी. टी. पी. एस.: ती निम्बॉटाच्या वाटेर एन्क्रिप्ट केल्ली आसता, आनी निम्बॉटाचो सर्वर ती हाताळपा खातीर स्पश्टपणान वाचता.
- प्रॉम्प्ट आनी जाप सांठोवन दवरनात. ते मॉडेला कडेन वतात आनी जाप परत वता. जें दवरतात तें बिलः दर एका विनंत्या खातीर वेळ, मॉडेल, प्रकार, टोकन गणीत, खर्च, शिल्लक, चावी आनी तो यशस्वी जालो काय ना, 90 दिसां खातीर, जें कितें तें. क्वेरी इतिहास तुमकां दाखयता. त्याच विनंत्याचो वापर नोंद (वेळ, प्रकार, मॉडेल, टोकन गणीत, खर्च, काळ आनी ताणें वेब सर्च वापरलें वा येसस्वी जालें) एपच्या स्वताच्या वांगडा 90 दिसां खातीर दवरतात.
- Nym sathi dhorlelem baintlem soglem lhan asa ani hanga yevadlem asa. API कीज हॅश म्ह}$) साठोवपांत येतात, केंयचेंय की (key) न्हय, त्यांचें नांव, एक ल्हान सुगाद, खर्च करपाचो आदार, रिसेट करपाचो काळाव, उणीव (expiry) आनी ते केन्ना तयार केल्यात आनी शेवटकें केन्ना वापरले, तें साठोवपांत येतात; फकत नवी 50 रद्द केल्या कियो (revoked keys) साठोवपांत येतात. An स्वयंचालित टॉप-अप वॉलेट कनेक्शन एनक्रिप्टेड दवरला जात, ताच्या थ्रेशोल्ड, अमाऊंट आनी शेवटच्या टॉप-अपच्या रिझल्टानسبةत. व्हिडिओ जॉब्स २४ तासांसाती दवरले वतात. प्रत्येक कॉल खातीर दिलेलीं पेमेंट्स ७ दीस फकत लाइटनिंग पेमेंट हॅश आनी ३० दीस हॅश्ड रिफंड टोकन उरयतात, जी कोणा नांवा कडेन जोडल्या न्हय. बॅलन्स नासल्यार घेवन दवरिल्ले चार्जेस, जो मेरेन टॉप-अप जाता तो मेरेन बाकी (owed) म्हणून दवरले वतात.
- एप पुसल्यार तें काडून उडयता. A यंत्र पुसचें दरेक ए. पी. आय. किल्ली रद्द आनी काडून उडयता, आनी क्वेरी इतिहास, वापर नोंदी, वॉलेट जोडणी आनी व्हिडियो जॉब्स काडून उडयता. शिल्लक आनी खंयचेंय शुल्क अजूनय एन. आय. एम. चेर उरता.
- मॉडेलाचो पुरवणदार तुजी विनंती पळयता, जशें एपांतल्यान जाता. कॅटलॉग मॉडेल तांच्या निर्मात्यांचेर चलतात; मानक मार्ग आनी एम्बेडिंग क्लाऊडफ्लेयरचेर चलतात.
- निर्माण जाल्लें माध्यम भौशीक आसा. लिंक म्हुणून दिल्लीं चित्रां आनी व्हिडियो भौशीक ब्लॉसम फाइल होस्टांचेर अपलोड करतात, जंय फायलाचो पत्तो ताचो हॅश आसता. लिंक आशिल्लो कोणूय तो उगडूंक शकता, आनी निम्बॉट तो परतून काडून उडोवंक शकना. माग
b64_jsonआनी तयार केल्लें चित्र प्रतिसादांत परत येता आनी केन्नाच अपलोड जायना. - तुमी जनरेटर दिवपी चित्रां लेगीत अशींच आसात. तुमी अपलोड केल्लो एक फोटो
संपादीत कर, वा म्हुणून धाड
data:जनरेटरांतली यू. आर. एल.image_url, पयलीं भौशीक ब्लॉसम होस्टाचेर अपलोड करतात जाका लागून जनरेटराक तें हाडपाक मेळटा, आनी तेंच ताका लागू जाता.https://ती लिंक म्हणून लिंक धाडटात. चॅट विनंतींतलीं चित्रां मॉडेलाच्या प्रदात्या कडेन वतात, ब्लॉसम कडेन न्हय. - तुमच्या एन. आय. एम. कडेन एक किल्ली जोडिल्ली आसता. चावी खर्च करता तें सगळें तुमच्या एन. आय. एम. च्या शिल्लक मदल्यान येता, देखून ए. पी. आय. वापर करचो ना. अनामिक. जर तुमकां API वापर तुमचें दरदिसाचें nym सावन वेगळें दवरपाचें आसत, तर वेगळ्या nymसावन की तयार करा ज्याचो आपलो बॅलेन्स आसत.
तुमकां ऍप्लिकेशनांच्या संरक्षणाची गरज आसल्यार ऍप्लिकेशनांचो वापर करात. तुमच्या स्वताच्या साधनांत मॉडेलांची गरज पडल्यार एपीआय आसता.
दरेक निमाणें बिंदू
| निमाणें बिंदू | तें कितें करता | अथुअरिटी (Auth) |
|---|---|---|
GET /api/v1/models | मॉडेलांची वळेरी, दरांकडेन | कांयच ना |
POST /api/v1/chat/completions | चॅट कॉम्प्लिशन्स | चावी |
POST /api/v1/responses | प्रतिसाद एपीआय | चावी |
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 | खात्याचो सारांश | निम. |
/api/v1/keys | किल्ली तयार करता, बदलता आनी रद्द करता | निम. |
/api/v1/nwc-auto-topup | ऑटोमॅटीक टॉप-अप | निम. |
GET /api/v1/l402/refunds, POST /api/v1/l402/refunds/redeem | रिफंड टोकन तपासता वा रिडीम करता | रिफंड टोकन; रिडीम करपा खातीर एन. आय. एम. |
& ldquo; Nym & rdquo; म्हळ्यार तुमच्या नॉस्टर कि वरवीं स्वाक्षरी केल्ली विनंती, जातूंत वर्णन केलां. खात्याच्या विनंतीनतींचे साक्षरता (signing account requests)पयलींच हे स्वरूप उलोवपी साधनांखातीर, पळय साधना आनी SDKs, आनी Claude Code, Codex आनी Cline सारख्या कोडिंग एजेंटाखातीर, पळयात कोडिंग टूल्स.