सामग्री पर जाओ
निम्बॉट पर बापस जाओ

ज्ञान आधार डेवलपर्स

API दी समीक्षा

ओह मॉडल्स, जनरेटर्स ते बैलेंस जे तुस ऐप च प्रयोग करदे ओ, तुंदे अपने कोड तों। API, OpenAI ते Anthropic फॉर्मेट च गल्ल करदा ऐ, तांजी चको ज़्यादातर टूल्स ते SDKs इक बेस URL ते इक की (key) बदळ के काम करदे न।

API केह् ऐ

इक ऐच्च. टी. टी. पी. ए. पी. आई. चालू ऐ nymbot.ai जेह्ड़ा उʼनें अनुरोधें दा जवाब दिंदा ऐ जेह्ड़े इक ओपनएआई जां एंथ्रोपिक ग्राहक पैह्लें शा गै भेजदा ऐ। तुसें गी मिलदा ऐः

एह् उʼनें गै द'ऊं थमां भुगतान कीता जंदा ऐ। बैलेंस (बैलेंस) ऐप दे रूपै च, बराबर कीमतें पर। ए. पी. आई. पर कोई सदस्यता ते कोई मुफ्त भत्ता नेईं ऐः हर इक विनती दा भुगतान तुंʼदे आसेआ खरीदे गेदे क्रेडिट थमां कीता जंदा ऐ।

API जो नी करदा ऐ, ओ ऐ कि Nymbot दी अपनी कोई चीज़ ऐग्ज़िट नी करदा। तुआडे मैसेज मॉडल कोल उंदी ऐ जेड़े तुस भेजदे ओ: कोई Nymbot सिस्टम प्रॉम्प्ट नी, कोई मेमोरी नी, ते कोई तारीख या ज़बान दी हिंट्स नी। जो वापस आंदा ऐ, ओ ऐ मॉडल दा जवाब ते इक नोट कि इसकी कीमत की लगी।

अधार यू. आर. एल.

इस्तेमाल करोअधार यू. आर. एल.
OpenAI SDKs ते OpenAI-compatible औज़ारhttps://nymbot.ai/api/v1
एंथ्रोपिक ऐस्स. डी. के. ते क्लाउड कोडhttps://nymbot.ai/api (एस. डी. के. जोड़दा ऐ /v1/messages अपने आप)

हर इक अंत बिंदु खʼल्ल बस्से दा ऐ /api/v1/इक अनजान रस्ता बापस आई जंदा ऐ। 404 अते इक जण्या होए राही जेह्ड़े गी गलत तरीके कन्नै पुछिया जांदा ऐ, ओ लौटांदा ऐ 405, दुनू JSON दे रूप च।

ए. पी. आई. कुसै बी साइट थमां अंतर-मूल अनुरोधें दा जवाब दिंदा ऐ, इस करियै इक ब्राउज़र पेज इसगी काल करी सकदा ऐ। जेह्ड़ा किश बी तुस ब्राउज़र गी भेजदे ओ, उसी ओह् पढ़ी सकदा ऐ जेह्ड़ा इसगी खोलदा ऐ, हालां-के, नेहा छड़ा इक चाबी कन्नै करो जेह्दे च इक लौह्का कोड होंदा ऐ। टोपीतुंʼदे निंब दे कन्नै दस्तखत कीते गेदे अंत बिंदु (कुंजी, खाते दा सारांश, एन. डब्ल्यू. सी. आटो-टॉप-अप ते रिफंड रिडेम्पशन) अपवाद नः इक ब्राउज़र च ओह् छड़ा निम्बॉट दी अपनी साइटें दा जवाब दिंदे न। दस्सो अकाउंट रिक्वेस्टां गी साइन करना.

हर इक जे. ऐस्स. ओ. ऐन्न. बाडी गी कन्नै भेजो 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) च बचिया होया हिस्सा कन्नै सेट कीती जांदी ऐ। जेकर ओह् फिट नी हुंदा, तां रिक्वेस्ट गी रिफ्यूज कर दित्ता जांदा ऐ। 403 key_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 क्या निम्बॉट दा अपना रूट ऐ, जेह्ड़ा मानक शेष थमां भुगतान कीता जंदा ऐ। एह्दे बजाए इक कैटलॉग माडल दी आई. डी. लाओ, जिʼयां जे anthropic/claude-sonnet-5, प्रो बैलेंस थमां उस माडल दा इस्तेमाल करने आस्तै। मॉडल्स दी सूची हर इक आई. डी. दिंदा ऐ।

इक विनती पर किन्ना खर्च होंदा ऐ

ए. पी. आई. बिल ठीक उʼयां गै करदा ऐ जिʼयां ऐप करदा ऐ।

  • केंगे बैलेंस। nymbot/auto खर्च करदा ऐ मानक बैलेंस (10 sats क्रेडिट)। हर इक दस्सा चैट मॉडल खर्च करदा ऐ। प्रो बैलेंस (100 sats क्रेडिट)। स्टैंडर्ड इमेज जनरेटर ते स्टैंडर्ड वॉइस स्टैंडर्ड क्रेडिट खर्चे; हरें इकगे जनरेटर प्रो (Pro) खर्चे। एम्बेडिंग्स (Embeddings) स्टैंडर्ड क्रेडिट खर्चे। ट्रांसक्रिप्शन स्टैंडर्ड क्रेडिट खर्चे जद स्टैंडर्ड बैलेंस उंदी खर्चे, ते दस्से प्रो (Pro) क्रेडिट खर्चे। मॉडल्स दी लिस्ट दस्सेगी कि हर इक मॉडल कद्दै बैलेंस खर्चे।
  • किन्ना ऐ। इक चैट रिकुएस्ट गी प्रदाता दी प्रकासित दरें पर टोकन पर मीटर कीता जंदा ऐ, जेह्ड़ा माडल असल च पढ़दा ते लिखदा ऐ। उस कीमत च 5 फीसदी फीस जोड़ी जंदी ऐ ते फ्ही 1.5 कन्नै गुणा कीता जंदा ऐ, इस करियै तुस प्रदाता दी सूची कीमत दा गुना भुगतान करो। एह् लाइव बिटक्वाइन कीमत पर सैट्स च तब्दील होई जंदा ऐ ते इक क्रेडिट दे हज़ारवें हिस्से च चार्ज कीता जंदा ऐ। प्रो पिक्चर्स, वीडियो ते स्पीच दी कीमत प्रति पीढ़ी, प्रति सेकंड जां प्रति वर्ण, ते ऑडियो दे प्रति सेकंड ट्रांसक्रिप्शन दी कीमत, बराबर फीस ते मार्जिन दे कन्नै होंदी ऐ। मानक तस्वीर इक सपाट 5 मानक क्रेडिट ऐ ते मानक अवाज इक सपाट 3 ऐ।
  • घट्ट कोला घट्ट। हर इक मीटर अनुरोध दी लागत घट्ट कोला घट्ट 0.05 क्रेडिट होंदी ऐः मानक शेष पर अद्धा सैट्ट, प्रो पर 5 सैट्ट। क्रेडिट दे अंश पूरे कीते जंदे न, हर बारी पूरे नेईं कीते जंदे।
  • रुक, ऐपर ठह्र। कुसै विनती गी चलाने थमां पैह्लें, तुंʼदे आसेआ भेजे गेदे ते ओह्दे द्वारा लिखे जाई सकने आह्ले सभनें शा मते टोकन दे अधार पर तुंʼदी बाकी रकम थमां सभनें शा मता खर्च लाया जाई सकदा ऐ। सादे ए. ऐस्स. सी. आई. आई. दे बाह्रले पाठ गी ओह्दे यू. टी. ऐफ्फ.-8 बाइट्स कोला अकार दित्ता जंदा ऐ, ते ए. ऐस्स. सी. आई. आई. अंक ते विराम चिह्नें गी इक टोकन दे रूप च गिनाया जंदा ऐ, इस करियै कुसै बी लिपि, कोड ते गिनतरी च पाठ गी पूरे क्रेडिट च रक्खेआ जंदा ऐ, घट्ट कोला घट्ट इक, इस करियै कुसै बी विनती गी घट्ट कोला घट्ट 10 सैट्स मुक्त मानक शेष पर जां 100 सैट्स प्रो पर शुरू करने दी लोड़ होंदी ऐ। छड़ा असल लागत चार्ज कीती जंदी ऐ; बाकी जिसलै एह् खत्म होई जंदी ऐ तां जारी कीती जंदी ऐ। इक बड्डी विनती उसलै तक्कर अपनी पकड़ बनाई रखदी ऐ जिसलै तक्कर जे एह् चलदी ऐ; जेकर आयोजित क्रेडिट कुसै बी चाल्ली कन्नै उपलब्ध होना बंद होई जंदे न, तां इक स्ट्रीम इक बराबर दे क्रेडिट दे कन्नै रुकदी ऐ। 402 insufficient_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निम्बॉट दी बक्खी किश गलत होआ (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 रखदे नें।

इक तस्वीर दा लिंक इक सार्वजनक मेजबान गी इशारा करना चाहिदाः इक निजी जां स्थानी नैट्टवर्क पर, जां निम्बॉट दी अपनी साइटें पर इक पता, मंजूर नेईं ऐ। ऐप च लागू होने आह्ली प्रदाता गति जित्थै बी लागू होंदी ऐ, इस करियै इक प्रदाता गी अनुरोधें दे इक धमाके गी असफल होने दे बजाए धीमा कीता जाई सकदा ऐ।

ए. पी. आई. केह् देखी सकदा ऐ

API एप्स दी तरियां प्राइवेट नी ऐ, ते एह् स्पष्ट करना जरूरी ऐ कि किअं।

  • एह एंड-टू-एंड एन्क्रिप्टेड नी ऐ। ऐप्स च, तुंʼदे डिवाइस पर इक संदेश गी बंद करी दित्ता जंदा ऐ तां जे चाबी छड़ा निम्बॉट कोल होंदी ऐ ते इक संदेश दे रूप च जातरा करदी ऐ। तोह्फे दी लपेटइक ए. पी. आई. विनती सधारण एच. टी. टी. पी. ऐस्स. ऐः एह् निम्बॉट दे रस्ते च कूटबद्ध ऐ, ते निम्बॉट दा सर्वर इसगी संभालने आस्तै स्पश्ट रूप च पढ़दा ऐ।
  • संकेत ते जवाब संग्रहीत नेईं कीते जंदे न। ओह् माडल दे कोल जंदे न ते जवाब बापस चली जंदा ऐ। जेह्ड़ा किश रक्खेआ जंदा ऐ ओह् बिल ऐः हर इक विनती आस्तै समें, माडल, किसम, टोकन गिनती, लागत, शेष, चाबी ते केह् एह् कामयाब होआ, 90एं दिनें आस्तै, जेह्ड़ा केह् ऐ सवाल करने दा इतिहास तुहैं दस्सदा ऐ। ओदेई रिक्वेस्ट दा इक इस्तेमाल दा रिकॉर्ड (समय, प्रकार, मॉडल, टोकन गिनती, लागत, अवधि ते की उसने वेब सर्च इस्तेमाल कीआ ओर की ओ सफल होईआ) ऐप दे अपने रिकॉर्ड दे कन्नै 90 दिनां तक रख्या जांदा ऐ।
  • इक एन. आई. ऐम्म. आस्तै आयोजत होर सब किश लौह्का ऐ ते इत्थै सूचीबद्ध ऐ। ए. पी. आई. कुंजी इक हैश दे रूपै च भंडारत कीते जंदे न, कदें बी चाबी नेईं, उंʼदे नांऽ दे कन्नै, इक लौह्का इशारा, खर्च सीमा, रीसैट अवधि, मियाद ते जिसलै उʼनें गी बनाया गेआ हा ते खीरली बारी इस्तेमाल कीता गेआ हा; छड़ा बिलकुल नमियां 50 रद्द किश्तियां रेहियां जंदियां न। आटोमैटिक टॉप-अप बटुआ कनेक्शन गी अपनी सीमा, रकम ते खीरी टॉप-अप दे नतीजे दे कन्नै कूट-कूटत कीता जंदा ऐ। वीडियो नौकरी गी 24 घैंटे आस्तै रक्खेआ जंदा ऐ। प्रति कॉल भुगतान कीते गेदे अनुरोध 7 दिनें आस्तै छड़ा इक बिजली भुगतान हैश ते 30 दिनें आस्तै इक हैश रिफंड टोकन छड्डदे न, जेह्ड़ा कोई एन. आई. एम. कन्नै जुड़े दा नेईं ऐ। बाकी किश बी भुगतान नेईं कीता जाई सकदा, जिसलै तक्कर जे कोई टॉप-अप भुगतान नेईं करदा।
  • ऐप गीला करने कन्नै एह् डिलीट हो जांदा ऐ। A उपकरण गी पोंछो हर इक ए. पी. आई. कुंजी गी रद्द ते मिटाई दित्ता जंदा ऐ, ते क्वैरी इतिहास, उपयोग रिकार्ड, बटुआ कनेक्शन ते वीडियो कम्में गी मिटाई दित्ता जंदा ऐ। बाकी रकम ते कोई बी शुल्क अजें बी एन. आई. एम. पर बकाया ऐ।
  • माडल दा प्रदाता तुंʼदी विनती गी देखता ऐ, जिʼयां के एह् ऐप थमां होंदा ऐ। कैटलॉग माडल अपने निर्माताएं पर चलदे न; मानक रस्ते ते एम्बेडिंग क्लाउडफ्लेयर पर चलदे न।
  • जनरेटेड मीडिया सार्वजनक ऐ। लिंक दे रूप च डिलीवर कीते गेदे चित्र ते वीडियो सार्वजनक ब्लॉसम फाइल होस्ट पर अपलोड कीते जंदे न, जित्थै इक फाइल दा पता ओह्दे हैश च होंदा ऐ। लिंक आह्ला कोई बी व्यक्ति इसगी खोली सकदा ऐ, ते निम्बॉट इसगी परतियै खʼल्ल नेईं लेई सकदा ऐ। मंगो b64_json ते इक उत्पन्न तस्वीर प्रतिक्रिया च बापस आई जंदी ऐ ते कदें बी अपलोड नेईं कीती जंदी ऐ।
  • इʼयां गै तस्वीरां जिʼयां तुस जनरेटर दिंदे ओ। इक तस्वीर जेह्ड़ी तुस अपलोड करदे ओ संपादन करो, जां इक दे रूप च भेजो data: जेनेरेटर दी URL image_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रिफंड टोकन चैक्क जां रिडीम करोरिफंड टोकन; रिडीम करने आस्तै एन. आई. एम.

& ldquo; Nym & rdquo; दा मतलब ऐ तुंʼदी नोस्टर कुंजी द्वारा दस्तखत कीती इक विनती, जेह्दे च वर्णत कीता गेआ ऐ अकाउंट रिक्वेस्टां गी साइन करनाउ'नें उपकरणें आस्तै जेह्ड़े पैह्लें शा गै इʼनें प्रारूपें गी बोलदे न, दस्सो औज़ार ते SDKs, ते कोडिंग एजैन्ट्स जियां Claude Code, Codex ते Cline, देखो कोडिंग टूल्स.