ज्ञान आधार डेवलपर्स
API दी समीक्षा
ओह मॉडल्स, जनरेटर्स ते बैलेंस जे तुस ऐप च प्रयोग करदे ओ, तुंदे अपने कोड तों। API, OpenAI ते Anthropic फॉर्मेट च गल्ल करदा ऐ, तांजी चको ज़्यादातर टूल्स ते SDKs इक बेस URL ते इक की (key) बदळ के काम करदे न।
इस पेज दा मशीन-अनुवाद सुविधा आस्तै कीता गेदा ऐ। अंग्रेजी मूल संस्करण ऐ जेह्ड़ा लागू होंदा ऐ।
API केह् ऐ
इक ऐच्च. टी. टी. पी. ए. पी. आई. चालू ऐ nymbot.ai जेह्ड़ा उʼनें अनुरोधें दा जवाब दिंदा ऐ जेह्ड़े इक ओपनएआई जां एंथ्रोपिक ग्राहक पैह्लें शा गै भेजदा ऐ। तुसें गी मिलदा ऐः
- चैट कम्प्लीशन, दा प्रतिक्रियाएं दा ए. पी. आई. ते एंथ्रोपिक संदेश, स्ट्रीमिंग, उपकरणें, चित्रें, तर्क ते वैब खोज दे कन्नै, हर इक माडल आस्तै सूची and for Nymbot's own auto-routing.
- तस्वीरें, वीडियो, भाशन, प्रतिलेखन ते एम्बेडिंग.
- थुआढ़ा संतुलन, लाइटनिंग टॉप-अप, तुंʼदे बटुए चा आटोमैटिक टॉप-अप ते अै इतिहास हर इक रिक्वेस्ट दा की लागत ऐ।
एह् उʼनें गै द'ऊं थमां भुगतान कीता जंदा ऐ। बैलेंस (बैलेंस) ऐप दे रूपै च, बराबर कीमतें पर। ए. पी. आई. पर कोई सदस्यता ते कोई मुफ्त भत्ता नेईं ऐः हर इक विनती दा भुगतान तुंʼदे आसेआ खरीदे गेदे क्रेडिट थमां कीता जंदा ऐ।
API जो नी करदा ऐ, ओ ऐ कि Nymbot दी अपनी कोई चीज़ ऐग्ज़िट नी करदा। तुआडे मैसेज मॉडल कोल उंदी ऐ जेड़े तुस भेजदे ओ: कोई Nymbot सिस्टम प्रॉम्प्ट नी, कोई मेमोरी नी, ते कोई तारीख या ज़बान दी हिंट्स नी। जो वापस आंदा ऐ, ओ ऐ मॉडल दा जवाब ते इक नोट कि इसकी कीमत की लगी।
अधार यू. आर. एल.
| इस्तेमाल करो | अधार यू. आर. एल. |
|---|---|
| OpenAI SDKs ते OpenAI-compatible औज़ार | https://nymbot.ai/api/v1 |
| एंथ्रोपिक ऐस्स. डी. के. ते क्लाउड कोड | https://nymbot.ai/api (एस. डी. के. जोड़दा ऐ /v1/messages अपने आप) |
हर इक अंत बिंदु खʼल्ल बस्से दा ऐ /api/v1/इक अनजान रस्ता बापस आई जंदा ऐ। 404 अते इक
जण्या होए राही जेह्ड़े गी गलत तरीके कन्नै पुछिया जांदा ऐ, ओ लौटांदा ऐ 405, दुनू JSON दे रूप च।
ए. पी. आई. कुसै बी साइट थमां अंतर-मूल अनुरोधें दा जवाब दिंदा ऐ, इस करियै इक ब्राउज़र पेज इसगी काल करी सकदा ऐ। जेह्ड़ा किश बी तुस ब्राउज़र गी भेजदे ओ, उसी ओह् पढ़ी सकदा ऐ जेह्ड़ा इसगी खोलदा ऐ, हालां-के, नेहा छड़ा इक चाबी कन्नै करो जेह्दे च इक लौह्का कोड होंदा ऐ। टोपी. The endpoints signed with your nym (keys, the account summary, NWC auto-top-up and refund redemption) are the exception: in a browser they answer only Nymbot's own sites. See अकाउंट रिक्वेस्टां गी साइन करना.
हर इक जे. ऐस्स. ओ. ऐन्न. बाडी गी कन्नै भेजो Content-Type: application/jsonकुसै बी होर किसम कन्नै इन्कार कीता जंदा ऐ 415, तां इक सादा HTML फॉर्म ऐ कि इक text/plain कुसै होर साइट थमां विनती ए. पी. आई. तक्कर नेईं पुज सकदी ऐ। सी. यू. आर. एल. दे कन्नै, पास करो
-H "Content-Type: application/json" कन्नै गै -d.
ए. पी. आई. कुंजी
ऐप च चाबी बनाई जंदी ऐ। खोल्हो ए. पी. आई. वेब ऐप दी साइडबार च, या एंड्रॉइड ते iOS दे मेनू च, ते टैप करो चाबी बनाओएकर नाम दियो ऐते, जे तुसें चाहो ता, एक सीमा ऐते इक समाप्ति दी तिथि।
चाबी इक वार दिखाई जांदी ऐ। शीट बंद करन तों पहले इक्क सुरक्षित जगह तेcopy कर लओ: Nymbot उसदी सिर्फ इक fingerprint रखदा ऐ, तां कि ओ तुसें कन्नै दोबारा नई दिखा सकदा। खोई हुई चाबी वापस नई मिल सकदी; ओनु रद्द करो ते दूसरी बनाओ।
एक चाबी ऐंयां लगदी ऐ sk-nymbot- 43 अक्षरां, डिजिट्स, डैशें ते
अंडरस्कोरें कन्नै suivo कीता जांदा ऐ। ऐप हर की (key) गी उसदे नाम ते इक छोटे हिंट कन्नै लिस्ट करदा ऐ जियां कि
sk-nymbot-Qm7x…c2Lw.
- इक चाबी थौड़े नाम दी ऐ। एह् तुआडे बैलेंस गी खर्च करदा ऐ, ते सिब तुआदा नयम् (nym) ही एह् बणा सकदा, बदलि सकदा या रद्द कर सकदा ऐ। जेह्ड़ा कोइ भी चाबी रखदा ऐ, ओ एह्दे कन्नै खर्च कर सकदा ऐ, इसली एह्नु इक पासवर्ड दी इक तरह सानो।
- कैप्स सैट्स च होंदे न। एक्क की (key) दा खर्च करन दी इक सीमा (spending cap) होई सकदी ऐ, ते ओह सीमा
हर रोज़, हर हफ्ते (सोमवार) या हर महीने (पहला दिन), 00:00 UTC ते रिसेट होई सकदी ऐ। एह् दोनों
बैलेंस गी गिनदी ऐ, इक सामान्य क्रेडिट 10 sats ते इक Pro क्रेडिट 100, तां इसदा मतलब ओह्गी ऐ
चाहे कोई रिक्वेस्ट किसे भी बैलेंस गी खर्च करे। इक रिक्वेस्ट चल्न तों पहले, ओह्दी अधिकतम लागत
(पूरे क्रेडिट च राउंड अप करी हुई) क्युची सीमा (cap) च बचिया होया हिस्सा कन्नै सेट कीती जांदी ऐ। जेकर ओह् फिट नी हुंदा,
तां रिक्वेस्ट गी रिफ्यूज कर दित्ता जांदा ऐ।
403key_limit_reached, भले गै जवाब कैप दे खʼल्ल आया होंदा; गलती दसदी ऐ जे किन्ना बची गेआ ऐ ते कैप कुसलै रीसैट होंदा ऐ। लोवरिंगmax_tokensएह् ओत्थे दा बुरा हाल कम करदा ऐ। इक रिक्वेस्ट दा ओत्थै ओत्थै ही चार्ज लग्गदा ऐ जेह्ड़ा ओह्दा असल खर्च ऐ आं, ते ओह् कैप (cap) दे कन्नें गिणिया जांदा ऐ, तां जेकर प्रोवाइडर ओत्थें दात्तो परे टोकन दी रिपोर्ट करदा ऐ जेह्ड़े संचय कीते गे ते, तां आखिरी रिक्वेस्ट जेह्ड़ी फिट आई ऐ, ओह् की (key) गी ओह्दी कैप दे थोड़े परे ले जा सकदी ऐ; ओत्थें अगली रिक्वेस्ट नूं मना कर दित्ता जांदा ऐ। - इक खर्च कीती दी सीमा छड़ा खर्च गी रोकदी ऐ। एह्दे कैप पर इक चाबी अजें बी बाकी रकम दी परख करी सकदी ऐ, एह्दे इतिहास गी पढ़ सकदी ऐ, माडलें गी सूचीबद्ध करी सकदी ऐ, टोकन दी गिनती करी सकदी ऐ, टॉप अप करी सकदी ऐ ते उस वीडियो दी परख करी सकदी ऐ जेह्ड़ा ओह् पैह्लें गै शुरू करी चुके दा ऐ।
- एक्स्पायरी ऐच्छिक ऐ। तुंʼदे आसेआ निश्चत तरीक दे परैंत्त, कुंजी कम्म करना बंद करी दिंदी ऐ।
- रद्द करना फौरन ते आखरी ऐ। इक रद्द कीती गेई चाबी अपनी अगली विनती च विफल होई जंदी ऐ। एह् सूची च बनी जंदी ऐ, जिस पर रद्द कीता गेआ ऐ, इस करियै एह्दे खर्च दा इतिहास अजें बी समझदारी आह्ला ऐ।
- तुंʼदे कोल 25 सक्रिय कुंजियां होई सकदियां न, जिंʼदे चा हर इक दा अपना नांऽ होंदा ऐ। इक कुंजी दी रीसैट अवधि गी बदलने कन्नै इक नमीं अवधि शून्य पर शुरू होंदी ऐ।
इक गै शीट इस अवधि च हर इक कुंजी दे खर्च गी दर्शांदी ऐ ते कुल मिला के, जिसलै इसगी खीरली बारी इस्तेमाल कीता गेआ हा, तुंʼदे बकाया ते तुंʼदे हाली दे ए. पी. आई. अनुरोध दौनें गी दर्शांदी ऐ। एह्दे परैंत्त दे अंत बिंदुएं गी खʼल्ल दर्ज कीता गेआ ऐ। चाबियां संभालना.
इक विनती गी प्रमाणीकृत करना
की (key) एह्नां चों कनैई इक हेडर च भेजो। एह् समान ऐं, ता ई उसदे इस्तेमाल करो जो थौडा क्लाइंट (client) डिफ़ॉल्ट रूपें च भेले:
| हेडर | आसेआ भेजेआ गेआ |
|---|---|
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 जवाब देओ। दस्सो की (key) दे बिना हर रिक्वेस्ट दा पैसा दित्ते करना.
की मैनेजमेंट, अकाउंट समरी ते ऑटोमैटिक टॉप-अप्स अपवाद ऐ हुन्: ओ तुआडे न्यम (nym) तों सिग्नेचर लैंदे ऐ न कि की (key) तों, इसै ले कर इक लीक होई की (key) कन्नै कन्नै अत्थ ऐ कीज़ (keys) नी बण सकदे। देखीऐ अकाउंट रिक्वेस्टां गी साइन करना.
थौड़ा पहला अनुरोध
कुंजी गी इक एनवायरनमेंट वेरिएबल च रक्खो, फिर इक मॉडल गी कुछ पूछो। एह्ें प़ैजां दे सारे उदाहरण ओथों पढ़दे न्हीं 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, प्रो बैलेंस थमां उस माडल दा इस्तेमाल करने आस्तै। मॉडल्स दी सूची हर इक आई. डी. दिंदा ऐ।
इक विनती पर किन्ना खर्च होंदा ऐ
ए. पी. आई. बिल ठीक उʼयां गै करदा ऐ जिʼयां ऐप करदा ऐ।
- केंगे बैलेंस।
nymbot/autoखर्च करदा ऐ मानक बैलेंस (10 sats क्रेडिट)। हर इक दस्सा चैट मॉडल खर्च करदा ऐ। प्रो बैलेंस (100 sats क्रेडिट)। स्टैंडर्ड इमेज जनरेटर ते स्टैंडर्ड वॉइस स्टैंडर्ड क्रेडिट खर्चे; हरें इकगे जनरेटर प्रो (Pro) खर्चे। एम्बेडिंग्स (Embeddings) स्टैंडर्ड क्रेडिट खर्चे। ट्रांसक्रिप्शन स्टैंडर्ड क्रेडिट खर्चे जद स्टैंडर्ड बैलेंस उंदी खर्चे, ते दस्से प्रो (Pro) क्रेडिट खर्चे। मॉडल्स दी लिस्ट दस्सेगी कि हर इक मॉडल कद्दै बैलेंस खर्चे। - किन्ना ऐ। इक चैट रिकुएस्ट गी प्रदाता दी प्रकासित दरें पर टोकन पर मीटर कीता जंदा ऐ, जेह्ड़ा माडल असल च पढ़दा ते लिखदा ऐ। उस कीमत च 5 फीसदी फीस जोड़ी जंदी ऐ ते फ्ही 1.5 कन्नै गुणा कीता जंदा ऐ, इस करियै तुस प्रदाता दी सूची कीमत दा गुना भुगतान करो। एह् लाइव बिटक्वाइन कीमत पर सैट्स च तब्दील होई जंदा ऐ ते इक क्रेडिट दे हज़ारवें हिस्से च चार्ज कीता जंदा ऐ। प्रो पिक्चर्स, वीडियो ते स्पीच दी कीमत प्रति पीढ़ी, प्रति सेकंड जां प्रति वर्ण, ते ऑडियो दे प्रति सेकंड ट्रांसक्रिप्शन दी कीमत, बराबर फीस ते मार्जिन दे कन्नै होंदी ऐ। मानक तस्वीर इक सपाट 5 मानक क्रेडिट ऐ ते मानक अवाज इक सपाट 3 ऐ।
- घट्ट कोला घट्ट। हर इक मीटर अनुरोध दी लागत घट्ट कोला घट्ट 0.05 क्रेडिट होंदी ऐः मानक शेष पर अद्धा सैट्ट, प्रो पर 5 सैट्ट। क्रेडिट दे अंश पूरे कीते जंदे न, हर बारी पूरे नेईं कीते जंदे।
- रुक, ऐपर ठह्र। कुसै विनती गी चलाने थमां पैह्लें, तुंʼदे आसेआ भेजे गेदे ते ओह्दे द्वारा लिखे जाई सकने आह्ले सभनें शा मते टोकन दे अधार पर तुंʼदी बाकी रकम थमां सभनें शा मता खर्च लाया जाई सकदा ऐ। सादे ए. ऐस्स. सी. आई. आई. दे बाह्रले पाठ गी ओह्दे यू. टी. ऐफ्फ.-8 बाइट्स कोला अकार दित्ता जंदा ऐ, ते ए. ऐस्स. सी. आई. आई. अंक ते विराम चिह्नें गी इक टोकन दे रूप च गिनाया जंदा ऐ, इस करियै कुसै बी लिपि, कोड ते गिनतरी च पाठ गी पूरे क्रेडिट च रक्खेआ जंदा ऐ, घट्ट कोला घट्ट इक, इस करियै कुसै बी विनती गी घट्ट कोला घट्ट 10 सैट्स मुक्त मानक शेष पर जां 100 सैट्स प्रो पर शुरू करने दी लोड़ होंदी ऐ। छड़ा असल लागत चार्ज कीती जंदी ऐ; बाकी जिसलै एह् खत्म होई जंदी ऐ तां जारी कीती जंदी ऐ। इक बड्डी विनती उसलै तक्कर अपनी पकड़ बनाई रखदी ऐ जिसलै तक्कर जे एह् चलदी ऐ; जेकर आयोजित क्रेडिट कुसै बी चाल्ली कन्नै उपलब्ध होना बंद होई जंदे न, तां इक स्ट्रीम इक बराबर दे क्रेडिट दे कन्नै रुकदी ऐ।
402insufficient_balanceगलती दी घटना, ते जेह्ड़ा पैदा कीता गेआ हा ओह्दे पर शुल्क लाया जंदा ऐ। जेकर असल लागत बकाया भुगतान करने कोला मती ऐ, तां पूरा बकाया लेई लैता जंदा ऐ, बाकी बकाया ऐ (owed_satsचnymbotवस्तु, ऐउं इक नेगेटिव बैलेंस)। जे उधार ऐ है, ओह्दा भुगतान उस बैलेंस च पौणिए जाने क्रेडिट्स तों सबसे पैली कीता जांदा ऐ। जित्ते तक ओह्दा भुगतान नी हुंदा, उस बैलेंस च कोई वी चीज़ खर्च नी कीती जा सकदी: ना API दे ज़रिए, ना ऐप दे रिप्लाय च, ना ट्रांसफर च ऐं ना ही गिफ्ट च। - क्रेडिट पर्याप्त नी ऐ। जे बकाया रोक गी पूरा नेईं करी सकदा ऐ, तां विनती गी मंजूर नेईं कीता जंदा ऐ।
402कुसै बी चीज दे चलने शा पैह्लें। गलती दसदी ऐ जे केह्ड़ी बाकी घट्ट ऐ, विनती गी किन्ने सैट्स दी लोड़ ऐ ते किन्ने मुफ्त न। इक लौह्काmax_tokensदा मतलब इक छोटी पकड़ ऐ। - नाकामी। ऐक ऐसी विनती जेह्ड़ी फेल हो जांदी ऐ, ओदे दा कोई खर्च नी हुंदा, जद तक कि सेवा देण आला ओही काम करा देओण दे पैसे न मांगै जेह्ड़ा ओइ फेल होण तों पहले करिया होवे, या फेर वेब सर्च करी होवे या...
nymbot/autoटास्क चेक कीत्थै ऐगे ऐ; फेर ओही तुसें देणा ऐ, कम से कम 0.05 क्रेडिट। इक स्ट्रीम जेह्ड़ी तुसें काट दित्ती ऐ, उसदे टोकन दा चार्ज ओही हुंदा ऐ जो प्रोवाइडर रिपोर्ट करदा ऐ: Nymbot थौड़े जाने दे बाद उप्पर तों 25 सेकंड तक प्रोवाइडर दी स्ट्रीम पढ़दा रहंदा ऐ ताकि ओह्दा काउंट मिल सके। जेकर ओह् नहीं मिलदा, तां चार्ज उस हिसाब तों अंदाज़े तों लगाया जांदा ऐ जो तुसें भेजा ऐ ते जो लिखिया गया ऐ, ते इक रीज़निंग मॉडल दे कन्नै ओह्दे होल्ड दी पूरी आउटपुट अलाउन्स शामिल हुंदी ऐ। इक रिक्वेस्ट जिसदा कनेक्शन कट जांदा ऐ, ओह् फिर भी पूरी हुंदी ऐ ते उसदा चार्ज लगदा ऐ। - वेब खोज हर इक सर्च दा खर्च $0.008 ऐ, जित्थे सत्स (sats) च बद्लिया जांदा ऐ, जद वी कोई सर्च चलदी ऐ, चाहे मॉडल जवाब दै ओह् या असफल हुंदा ऐ। ओह् पन्ने जित्थे पढ़दा ऐ, ओह् वी इनपुट दे तौर पर मॉडल गी भेजे जांदे न, तां ओह् अपने टोकन्स जोड़दे न।
हर इक प्रतिक्रिया दसदी ऐ जे एह्दे च केह् खर्च होंदा ऐ। जे. ऐस्स. ओ. ऐन्न. प्रतिक्रियाएं च इक ऐ nymbot उस वस्तु दे बैलेंस दी जानकारी जिस तों भुगतान कीता गया, क्रेडिट्स ते सैट्स च चार्ज, ते जो बचिया:
लागत दा उद्देश
"nymbot": {
"balance": "pro",
"charged_credits": 0.162,
"charged_sats": 16.2,
"balance_credits": 412.425,
"balance_sats": 41242.5
}
भुगतान प्रतिक्रियाएं च एह् हेडर बी होंदे न, जित्थै जे. ऐस्स. ओ. ऐन्न. नेईं होने आह्ली प्रतिक्रिया दी लागत तुप्पनी चाहिदी, जिʼयां के भाशनः
| हेडर | अर्थ |
|---|---|
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 | शरीर वैध जे. ऐस्स. ओ. ऐन्न. नेईं ऐ (invalid_json), इक लाजमी खेतर मिस्स ऐ (missing_required_parameter), इक मान गलत ऐ, जां विनती किश नेहा मंगदी ऐ जेह्ड़ा माडल जां एंडप्वाइंट नेईं करदा ऐ, जिʼयां के उपकरण nymbot/auto (unsupported_tool). param खेत दा नांऽ दस्सो। कन्नै गै upstream_rejected जिसलै प्रदाता ने विनती गी नांह् करी दित्ती। |
401 authentication_error | कुंजी मिस्स ऐ, अनजान ऐ, रद्द कीती गेई ऐ जां मियाद पूरी होई गेई ऐ, जां इक दस्तख़त कीती विनती अमान्य ऐ जां परतियै इस्तेमाल कीती गेई ऐ। |
402 insufficient_quota | बाकी रकम विनती गी पूरा नेईं करी सकदी ऐ। कोड 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 | इस की (key) पर, इस एड्रेस तों, या एदे क्रेडेंशियल्स कन्नै जेड़े वेरीफाई होन च फेल हो गए ऐ, बहुत ज्यादा रिक्वेस्ट्स ऐ (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).- एक स्ट्रीमिंग रिक्वेस्ट जो अपने पहले बाइट ते पहले फेल हो जांदी ऐ, ओनु ऊपर दित्ते गए स्टेटस कन्नै इक साधारण JSON एरर मिलदा ऐ, इवेंट स्ट्रीम नहीं। स्ट्रीम शुरू होन दे बाद जेकर कोई फेलियर हुंदा ऐ, तां ओ नु उस एंडपॉइंट दे अपने फॉर्मेट च, स्ट्रीम दे आखिरी इवेंट दे रूप च भेजा जांदा ऐ।
त्रुटि संदेशें च कदें बी कुसै होर सेवा दे अंदरूनी ब्यौरे नेईं होंदे न। इक प्रदाता दी अपनी गलती तुंʼदे तक्कर औने शा पैह्लें परतियै लिखी जंदी ऐ।
हद्दां
| सीमा | मूल्य |
|---|---|
| प्रति कुंजी अनुरोध | 120 प्रति मिंट। ओह्दे शा मता, 429 कन्नै-कन्नै Retry-After. |
| बगैर चाबी दे अनुरोध | 120 प्रति मिंट प्रति पता, माडल आस्तै, ऑडियो ते भुगतान विधि सूची, रिफंड टोकन चैक्क, ते भुगतान कीते दे अंत बिंदु बगैर चाबी जां भुगतान दे काल कीते जंदे न। एह्दे अलावा, 429 कन्नै-कन्नै Retry-After. |
| प्रमाणीकरण असफल रेहा | कुंजी, दस्तखत, भुगतान प्रमाण-पत्र ते रिफंड टोकन, जेह्ड़े तसदीक नेईं करदे, उंʼदे आस्तै हर पते पर 30 रुपये प्रति मिंट दा भुगतान कीता जंदा ऐ। एह्दे अलावा, पते थमां हर इक विनती, जेह्दे च प्रमाण-पत्र होंदा ऐ, हासल कीती जंदी ऐ। 429 कन्नै-कन्नै Retry-After मिनट खत्म होंन तक। बॉडी पढ़न तों पहले क्रेडेंशियल्स चेक कीते जांदे न। |
| नमियां चाबियां | ६० प्रति घंटा प्रति nym ऐउं १२० प्रति घंटा प्रति एड्रेस। |
| टॉप-अप इनवॉइसै गु़द | ६० प्रति घंटा प्रति nym ऐउं १२० प्रति घंटा प्रति एड्रेस। |
| ऐन्न. डब्ल्यू. सी. बटुआ कनेक्शन | प्रत्येक nym दे तां १० प्रति घंटा ऐं प्रत्येक एड्रेस दे तां ३० प्रति घंटा। वॉलेट रिले दा इस्तेमाल करना पौदा ऐ। wss:// मानक पोर्ट पर। |
| रिफंड टोकन | 60 प्रति मिंट प्रति टोकन विनती करदे न। |
| पते | हर इक प्रति-एड्रेस सीमा च इक IPv6 एड्रेस अपने पूरे /64 दे रूप च गिना जांदा ऐ, ते इक IPv4-mapped IPv6 एड्रेस अपने IPv4 एड्रेस दे रूप च। |
| JSON रिक्वेस्ट बॉडी | तुंʼदे एन. आई. एम. कन्नै दस्तखत कीते गेदे अनुरोधें आस्तै 4 एमबी; 64 के. बी। |
| बहु-भाग अनुरोध निकाय (अपलोड) | 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 ते चार्ज नेईं कीता जंदा ऐ, उसलै बी जिसलै व्हिस्पर ने इसगी इक बारी सुनेआ होंदा ऐ तां एह्दे लंबाई दा पता लगदा ऐ। |
| एम्बेडिंग्स | प्रति विनती 100 इनपुट। |
| वीडियो कम्म | उʼनें गी जमा करने दे परैंत्त 24 घैंटे आस्तै रक्खेआ जंदा ऐ; इक रेंडर गी इक घैंटे दे परैंत्त छोड़ी दित्ता जंदा ऐ। बद्धोबद्ध 10 रेंडरिंग इक बारी च प्रति निम्म। |
| पुछगिछ दा इतिहास | 90 दिनां लेई रखिया गया। |
| प्रत्येक nym पर सक्रिय कुंजियाँ | 25. ओंदी ऐ तां सिफ्त् नयिनें 50 रद्द कीतेKeys रखदे नें। |
एक् तस्वीर दा लिंक इक पब्लिक होस्ट गी इशारा करदा होना चईदी ऐ: इक प्राइवेट या लोकल नेटवर्क दा पता, या Nymbot दी अपनी साइट्स ते, रिजेक्ट कर दित्ता जांदा ऐ। प्रोवाइडर पेसिंग जो ऐप च लागू हुंदी ऐ ओथे वी लागू हुंदी ऐ, तांई इक प्रोवाइडर गी कीते जांदे रिक्वेस्ट दा झुंड फेल होण दे बदले धीमा कीता जा सकदा ऐ।
ए. पी. आई. केह् देखी सकदा ऐ
API एप्स दी तरियां प्राइवेट नी ऐ, ते एह् स्पष्ट करना जरूरी ऐ कि किअं।
- एह एंड-टू-एंड एन्क्रिप्टेड नी ऐ। ऐप्स् च, इक संदेश थौड़े डिवाइस च सील कीता जांदा ऐ जेहड़ा कीज़ Nymbot ही राखे ऐ ते इक... दे रूप च जांदा ऐ तोह्फे दी लपेट. इक API रिक्वेस्ट साधारण HTTPS ऐ: ए Nymbot तक जांदे नमूने एन्क्रिप्ट (encrypted) कीती जांदी ऐ, ते Nymbot दा सर्वर एह्नु हैंडल करने लेई साफ़ (in the clear) पढ़दा ऐ।
- संकेत ते जवाब संग्रहीत नेईं कीते जंदे न। ओह् माडल दे कोल जंदे न ते जवाब बापस चली जंदा ऐ। जेह्ड़ा किश रक्खेआ जंदा ऐ ओह् बिल ऐः हर इक विनती आस्तै समें, माडल, किसम, टोकन गिनती, लागत, शेष, चाबी ते केह् एह् कामयाब होआ, 90एं दिनें आस्तै, जेह्ड़ा केह् ऐ सवाल करने दा इतिहास तुहैं दस्सदा ऐ। ओदेई रिक्वेस्ट दा इक इस्तेमाल दा रिकॉर्ड (समय, प्रकार, मॉडल, टोकन गिनती, लागत, अवधि ते की उसने वेब सर्च इस्तेमाल कीआ ओर की ओ सफल होईआ) ऐप दे अपने रिकॉर्ड दे कन्नै 90 दिनां तक रख्या जांदा ऐ।
- इक एन. आई. ऐम्म. आस्तै आयोजत होर सब किश लौह्का ऐ ते इत्थै सूचीबद्ध ऐ। ए. पी. आई. कुंजी इक हैश दे रूपै च भंडारत कीते जंदे न, कदें बी चाबी नेईं, उंʼदे नांऽ दे कन्नै, इक लौह्का इशारा, खर्च सीमा, रीसैट अवधि, मियाद ते जिसलै उʼनें गी बनाया गेआ हा ते खीरली बारी इस्तेमाल कीता गेआ हा; छड़ा बिलकुल नमियां 50 रद्द किश्तियां रेहियां जंदियां न। आटोमैटिक टॉप-अप बटुआ कनेक्शन गी अपनी सीमा, रकम ते खीरी टॉप-अप दे नतीजे दे कन्नै कूट-कूटत कीता जंदा ऐ। वीडियो नौकरी गी 24 घैंटे आस्तै रक्खेआ जंदा ऐ। प्रति कॉल भुगतान कीते गेदे अनुरोध 7 दिनें आस्तै छड़ा इक बिजली भुगतान हैश ते 30 दिनें आस्तै इक हैश रिफंड टोकन छड्डदे न, जेह्ड़ा कोई एन. आई. एम. कन्नै जुड़े दा नेईं ऐ। बाकी किश बी भुगतान नेईं कीता जाई सकदा, जिसलै तक्कर जे कोई टॉप-अप भुगतान नेईं करदा।
- ऐप गीला करने कन्नै एह् डिलीट हो जांदा ऐ। A उपकरण गी पोंछो हर इक ए. पी. आई. कुंजी गी रद्द ते मिटाई दित्ता जंदा ऐ, ते क्वैरी इतिहास, उपयोग रिकार्ड, बटुआ कनेक्शन ते वीडियो कम्में गी मिटाई दित्ता जंदा ऐ। बाकी रकम ते कोई बी शुल्क अजें बी एन. आई. एम. पर बकाया ऐ।
- माडल दा प्रदाता तुंʼदी विनती गी देखता ऐ, जिʼयां के एह् ऐप थमां होंदा ऐ। कैटलॉग माडल अपने निर्माताएं पर चलदे न; मानक रस्ते ते एम्बेडिंग क्लाउडफ्लेयर पर चलदे न।
- जनरेटेड मीडिया सार्वजनक ऐ। लिंकें दे रूप च मिलदे फोटो ते वीडियो
पब्लिक Blossom फ़ाइल होस्ट्स पर अपलोड कीते जांदे न, जिथै फ़ाइल दा एड्रेस उसदा हैश हुंदा ऐ। जिस को भी
लिंक मिलदा ऐ, उ सु सु खोल सकदा ऐ, ते Nymbot ओहनूं दोबारा हटा नी सकदा। पुछो
b64_jsonते इक उत्पन्न तस्वीर प्रतिक्रिया च बापस आई जंदी ऐ ते कदें बी अपलोड नेईं कीती जंदी ऐ। - इʼयां गै तस्वीरां जिʼयां तुस जनरेटर दिंदे ओ। इक तस्वीर जेह्ड़ी तुस अपलोड करदे ओ
संपादन करो, जां इक दे रूप च भेजो
data:जेनेरेटर दी URLimage_url, इक पब्लिक Blossom होस्ट च उप्लोड कीती जांदी ऐ ताके जेनरेटर इकै गी फेच कर सकै, ते ओही चीज़ एदे लई ऐ। इक तस्वीर जो भेजी गई ऐhttps://लिंक गी उस लिंक दे रूप च पास कीता जंदा ऐ। चैट अनुरोध च तस्वीर माडल दे प्रदाता दे कोल जंदी ऐ, ब्लॉसम दे कोल नेईं। - इक चाबी तुंʼदे एन. आई. एम. कन्नै जुड़ी दी ऐ। जेह्ड़ा कुझ वी कुंजी खर्च करदी ऐ, ओ तुआडे नय़म (nym) दे बैलेंस तों कटदा ऐ, इसली API दा इस्तेमाल ऐ नहीं अनामजे तुस अपने रोजमर्रा दे एन. आई. ऐम्म. कोला बक्ख ए. पी. आई. उपयोग करना चाह्न्नां, तां अपने संतुलन दे कन्नै इक बक्ख एन. आई. ऐम्म. थमां चाबियां बनाओ।
जे तुसें गी ऐप्स दी सुरक्षा दी लोड़ ऐ, तां ऐप्स दा इस्तेमाल करो। ए. पी. आई. उसलै होंदा ऐ जिसलै तुसें गी अपने उपकरणें च माडलें दी लोड़ होंदी ऐ।
हर इक अंत बिंदु
| अंत बिंदु | क्या करदा ऐ | प्रमाणीकरण |
|---|---|---|
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 | रिफंड टोकन चैक्क जां रिडीम करो | रिफंड टोकन; रिडीम करने आस्तै एन. आई. एम. |
“Nym” दा मतलब ऐकि तुंदी Nostr key कन्नै साइन कीती होई इक गुज़ारिश, जो इसे च दस्सी गई ऐ अकाउंट रिक्वेस्टां गी साइन करनाउ'नें उपकरणें आस्तै जेह्ड़े पैह्लें शा गै इʼनें प्रारूपें गी बोलदे न, दस्सो औज़ार ते SDKs, ते कोडिंग एजैन्ट्स जियां Claude Code, Codex ते Cline, देखो कोडिंग टूल्स.