आशयाचेर वचचें
निम्बॉटा कडेन परत वच.

गिन्यानाचो आदार विकसक

ए. पी. आय. नदरावणी

तुमी ऍप्लिकेशनांत वापरपी मॉडेल्स, जनरेटर आनी बॅलन्स तुमच्या स्वताच्या कोडांतल्यान. एपीआय ओपनएआय आनी एंथ्रोपिक फॉरमॅट उलयता, देखून चडशीं साधनां आनी एसडीके मुळावी यूआरएल आनी किल्ली बदलून काम करतात.

एपीआय कितें?

एक 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 म्हणून, देखून ताचो अर्थ विनंती खर्च करता तितलीच शिल्लक आसता. विनंती चलोवचे पयलीं, ताचो चडांत चड खर्च (पुराय क्रेडीट मेरेन गोल) कॅप उरल्या ताचे आड सेट करतात. ती बसना जाल्यार, विनंती न्हयकारतात 403 key_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 सॅट सुरू करपाची गरज आसता. फकत प्रत्यक्ष खर्च आकारतात; बाकीचो तो सोंपता तेन्ना सोडटात. एक लांब विनंती तो चलता तो मेरेन धरून दवरता; धरून दवरिल्ले क्रेडीट उपलब्ध जावप बंद जाल्यार प्रवाह थांबता. 402 insufficient_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_errorNymbot च्या वटेन कांयतरी चुकल्यांत (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 सारख्या कोडिंग एजेंटाखातीर, पळयात कोडिंग टूल्स.