सामग्री पर जाएं
निम्बॉट पर वापस जाएँ

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

ए. पी. आई. का अवलोकन

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

एपीआई क्या है

HTTP API का उपयोग करें nymbot.ai जो एक ही अनुरोधों का जवाब देता है जो एक OpenAI या Anthropic क्लाइंट पहले से ही भेजता है. आप प्राप्त करते हैं:

यह एक ही दो से भुगतान किया जाता है संतुलन एपीआई पर कोई सदस्यता नहीं है और कोई मुफ्त अनुदान नहीं है: प्रत्येक अनुरोध आपके द्वारा खरीदे गए क्रेडिट से भुगतान किया जाता है।

एपीआई जो नहीं करता है वह है निम्बॉट का अपना कुछ भी जोड़ना। आपके संदेश मॉडल पर जाते हैं जैसे ही आपने उन्हें भेजा हैः कोई निम्बॉट सिस्टम प्रॉम्प्ट नहीं, कोई मेमोरी नहीं, कोई तारीख या भाषा संकेत नहीं। जो वापस आता है वह मॉडल का जवाब है और इसकी कीमत का एक नोट है।

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

उपयोग करें।आधार URL
ओपनएआई एसडीके और ओपनएआई-संगत उपकरणhttps://nymbot.ai/api/v1
एंथ्रोपिक एस. डी. के. और कोड कोडhttps://nymbot.ai/api (एस. डी. के. जोड़ता है /v1/messages स्वयं)

हर अंत में रहता है /api/v1/. एक अज्ञात रास्ता लौटता है 404 और गलत तरीके से बुलाया गया एक ज्ञात मार्ग वापस आता है 405JSON के रूप में।

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

प्रत्येक JSON शरीर को भेजें Content-Type: application/json. किसी भी अन्य प्रकार के साथ अस्वीकार कर दिया जाता है 415, तो एक साधारण HTML प्रारूप या एक text/plain किसी अन्य साइट से अनुरोध API तक नहीं पहुंच सकता. cURL के साथ, पास करें -H "Content-Type: application/json" साथ में -d.

आग की कुंजी

कुंजी ऐप में बनाई जाती हैं। एपीआई वेब ऐप के साइड बार में, या Android और iOS पर मेनू में, और कुंजी बनाएंइसे एक नाम और, यदि आप चाहते हैं, एक कैप और समाप्ति की तारीख दें।

कुंजी को एक बार दिखाया जाता है। शीट को बंद करने से पहले इसे कहीं सुरक्षित रूप से कॉपी करें। निम्बॉट केवल इसका एक फिंगरप्रिंट रखता है, इसलिए यह आपको इसे फिर से नहीं दिखा सकता है। एक खोई हुई कुंजी को पुनर्प्राप्त नहीं किया जा सकता है; इसे वापस लें और दूसरा बनाएँ।

एक कुंजी दिखती है sk-nymbot- इसके बाद 43 अक्षरों, आंकड़ों, डैश्स और अंडरसेट होते हैं. ऐप प्रत्येक कुंजी को अपने नाम और एक छोटा सुझाव के साथ सूचीबद्ध करता है जैसे: sk-nymbot-Qm7x…c2Lw.

  • एक चाबी आपके एन. आई. एम. की होती है। यह आपके संतुलन का खर्च करता है, और केवल आपका नाम इसे बना सकता है, बदल सकता है या रद्द कर सकता है. चाबी रखने वाला कोई भी इसके साथ खर्च कर सकता है, इसलिए इसे एक पासवर्ड की तरह व्यवहार करें।
  • कैप्स सैट्स में हैं। एक कुंजी की एक खर्च सीमा हो सकती है, और सीमा हर दिन, हर सप्ताह (सोमवार) या हर महीने (पहला), 00:00 यूटीसी पर रीसेट की जा सकती है। यह दोनों शेष राशि, 10 सैट्स के रूप में एक मानक क्रेडिट और 100 के रूप में एक प्रो क्रेडिट की गणना करता है, इसलिए इसका मतलब है कि एक अनुरोध जो भी शेष राशि खर्च करता है। एक अनुरोध चलाने से पहले, इसकी सबसे अधिक लागत (पूरे क्रेडिट तक गोल) कैप के बचे हुए हिस्से के खिलाफ सेट की जाती है। यदि यह फिट नहीं होता है, तो अनुरोध को अस्वीकार कर दिया जाता है। 403 key_limit_reached, भले ही जवाब कैप के तहत आया हो; त्रुटि बताती है कि कितना बचा है और कैप कब रीसेट होता है। लोअरिंग max_tokens सबसे खराब स्थिति को कम करता है। एक अनुरोध से वह शुल्क लिया जाता है जो वास्तव में इसकी लागत है और जो कैप के खिलाफ गिना जाता है, इसलिए यदि प्रदाता अलग रखे गए टोकन से अधिक की रिपोर्ट करता है, तो अंतिम अनुरोध जो फिट होता है वह कुंजी को उसकी कैप से थोड़ा आगे ले जा सकता है; फिर अगले अनुरोध को अस्वीकार कर दिया जाता है।
  • एक खर्च की गई सीमा केवल खर्च को रोकती है। इसके कैप पर एक कुंजी अभी भी शेष राशि की जांच कर सकती है, इसके इतिहास को पढ़ सकती है, मॉडल की सूची बना सकती है, टोकन की गिनती कर सकती है, टॉप अप कर सकती है और उस वीडियो की जांच कर सकती है जो पहले से ही शुरू हो चुका है।
  • समाप्ति वैकल्पिक है। आपके द्वारा निर्धारित तिथि के बाद, कुंजी काम करना बंद कर देती है।
  • रद्द करना तत्काल और अंतिम है। एक रद्द कुंजी अपने अगले अनुरोध में विफल रहती है. यह सूची में रहता है, रद्द चिह्नित किया गया है, इसलिए इसकी खर्च इतिहास अभी भी समझ में आता है.
  • आपके पास 25 तक सक्रिय कुंजी हो सकती हैं, जिनमें से प्रत्येक का अपना नाम है. एक कुंजी के रिसेट अवधि को बदलने से एक नया अवधि शून्य से शुरू होती है.

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

अनुरोध को प्रमाणित करना

इन शीर्षकों में से किसी एक में कुंजी भेजें। वे समतुल्य हैं, इसलिए जो भी आपका ग्राहक डिफ़ॉल्ट रूप से भेजता है उसका उपयोग करेंः

हेडरभेजा
Authorization: Bearer sk-nymbot-…ओपनएआई एसडीके, अधिकांश उपकरण, क्लाउड कोड के साथ ANTHROPIC_AUTH_TOKEN
x-api-key: sk-nymbot-…एंथ्रोपिक एस. डी. के.
api-key: sk-nymbot-…एज़्योर-शैली के ग्राहक

एक गायब, अज्ञात, रद्द या समाप्त कुंजी वापसी 401कोड के साथ missing_api_key, invalid_api_key, revoked_api_key या expired_api_keyसूची मॉडल, ऑडियो मॉडल और आवाज, और भुगतान विधियों की कोई कुंजी की आवश्यकता नहीं है।

बिना किसी चाबी के बिजली पर एक बार में एक अनुरोध के लिए चित्र, वीडियो, भाषण, प्रतिलेखन और एम्बेडिंग का भी भुगतान किया जा सकता हैः बिना किसी चाबी के अनुरोध भेजें और चालान का भुगतान करें। 402 जवाब दीजिए। बिना चाबी के प्रति अनुरोध भुगतान करना.

कुंजी प्रबंधन, खाता सारांश और स्वचालित टॉप-अप अपवाद हैंः वे एक कुंजी के बजाय आपके एन. आई. एम. से हस्ताक्षर लेते हैं, इसलिए एक लीक की अधिक कुंजी नहीं बना सकती है। खाता अनुरोधों पर हस्ताक्षर करना.

आपकी पहली मांग

एक पर्यावरण परिवर्तक में कुंजी रखें, फिर एक मॉडल से कुछ पूछें. इन पृष्ठों के माध्यम से उदाहरण इसे पढ़ते हैं 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 a credit). हर अन्य चैट मॉडल खर्च करता है प्रो संतुलन (100 बिट एक क्रेडिट)। मानक छवि जनरेटर और मानक आवाज मानक क्रेडिट खर्च करते हैं; प्रत्येक अन्य जनरेटर प्रो खर्च करता है. इनबैंडिंग मानक क्रेडिट खर्च करते हैं. ट्रांसक्रिप्शन मानक क्रेडिट खर्च करता है जब मानक संतुलन इसे कवर कर सकता है, और प्रो क्रेडिट अन्यथा।
  • कितना। एक चैट अनुरोध मॉडल को वास्तव में पढ़ने और लिखने वाले टोकन पर मापा जाता है, प्रदाता के प्रकाशित दरों पर। उस मूल्य में 5% शुल्क जोड़ा गया है और फिर 1.5 से गुणा किया जाता है, इसलिए आप प्रदाता की सूची मूल्य के 1.575 गुना भुगतान करते हैं। यह लाइव बिटकॉइन मूल्य पर sats में परिवर्तित किया जाता है और एक क्रेडिट के हजारों प्रतिशत में शुल्क दिया जाता है। प्रो चित्र, वीडियो और भाषण प्रति पीढ़ी, प्रति सेकंड या प्रति चरित्र, और ऑडियो के प्रति सेकंड ट्रांसक्रिप्शन, एक ही शुल्क और मार्जिन के साथ मूल्य। मानक छवि एक फ्लैट 5 मानक क्रेडिट है और मानक आवाज एक फ्लैट 3 है।
  • न्यूनतम। प्रत्येक माप किए गए अनुरोध जो कम से कम 0.05 क्रेडिट खर्च करता है: मानक संतुलन पर आधे सेट, प्रो पर 5 sats।
  • पकड़ो, फिर बैठो। किसी अनुरोध को चलाने से पहले, आपके द्वारा भेजे गए और उसके द्वारा लिखे जाने वाले सबसे अधिक टोकन के आधार पर आपकी जमा राशि में से सबसे अधिक लागत रखी जाती है। साधारण ए. एस. सी. आई. आई. के बाहर के पाठ को उसके यू. टी. एफ.-8 बाइट्स से आकार दिया जाता है, और ए. एस. सी. आई. आई. अंक और विराम चिह्न प्रत्येक को एक टोकन के रूप में गिना जाता है, इसलिए किसी भी स्क्रिप्ट, कोड और संख्याओं में पाठ को पूर्ण रूप से रखा जाता है। होल्ड पूरे क्रेडिट में होता है, कम से कम एक, इसलिए किसी भी अनुरोध को शुरू करने के लिए मानक शेष राशि पर कम से कम 10 सैट्स मुफ्त या प्रो पर 100 सैट्स की आवश्यकता होती है। केवल वास्तविक लागत ली जाती है; बाकी को समाप्त होने पर जारी किया जाता है। एक लंबा अनुरोध तब तक अपनी पकड़ रखता है जब तक कि यह चलता है; यदि संग्रहीत क्रेडिट वैसे भी उपलब्ध नहीं होते हैं, तो एक धारा बंद हो जाती है। 402 insufficient_balance जब तक कि यह संभव नहीं हो जाता है, तब तक यह संभव नहीं हो पाता है कि यह संभव हो जाता है, जब तक कि यह संभव हो जाता है कि यह संभव हो जाता है (owed_sats में nymbot वस्तु, और एक नकारात्मक संतुलन)। जो भुगतान किया जाता है, पहले अगले क्रेडिट से भुगतान किया जाता है जो उस संतुलन तक पहुंचता है. जब तक यह भुगतान नहीं किया जाता है, उस संतुलन पर कुछ भी खर्च नहीं किया जा सकता है: एपीआई द्वारा नहीं, ऐप में जवाब, एक हस्तांतरण या एक उपहार।
  • पर्याप्त ऋण नहीं। यदि संतुलन धारणा को कवर नहीं कर सकता है, तो अनुरोध अस्वीकार किया जाता है 402 कुछ भी चलने से पहले। त्रुटि बताती है कि कौन सा शेष राशि कम है, अनुरोध को कितने सैट्स की आवश्यकता है और कितने मुफ्त हैं। एक छोटा max_tokens इसका मतलब है एक छोटी सी पकड़।
  • असफलताएं एक विफल अनुरोध कुछ भी खर्च नहीं करता है, जब तक कि प्रदाता ने विफल होने से पहले किए गए काम के लिए शुल्क नहीं दिया, या वेब खोज या nymbot/auto कार्य चेक पहले से ही चला गया था; फिर आप क्या भुगतान करते हैं, कम से कम 0.05 क्रेडिट। एक स्ट्रीम जिसे आप काटते हैं, को प्रदाता द्वारा रिपोर्ट किए गए टोकन के लिए शुल्क दिया जाता है: Nymbot आप उस गिनती को प्राप्त करने के लिए छोड़ने के बाद 25 सेकंड तक प्रदाता के स्ट्रीम को पढ़ता रहता है।
  • वेब खोज एक खोज की लागत $0.008 है, जिसे सैट्स में परिवर्तित किया जाता है, जब भी कोई खोज चलती है, तो क्या मॉडल जवाब देता है या विफल होता है। इसके द्वारा पढ़े गए पृष्ठ भी इनपुट के रूप में मॉडल को भेजे जाते हैं, इसलिए वे अपने टोकन जोड़ते हैं।

प्रत्येक प्रतिक्रिया बताती है कि इसकी लागत क्या है। जे. एस. ओ. एन. प्रतिक्रियाओं में एक nymbot वस्तु जिसमें से भुगतान किया गया था, क्रेडिट और sats में शुल्क, और क्या छोड़ दिया गया है:

मूल्य वस्तु

"nymbot": {
  "balance": "pro",
  "charged_credits": 0.162,
  "charged_sats": 16.2,
  "balance_credits": 412.425,
  "balance_sats": 41242.5
}

भुगतान किए गए उत्तर भी इन हेडरों को लेते हैं, जो ऐसे उत्तर की लागत की तलाश करने के लिए हैं जो JSON नहीं है, जैसे कि भाषण:

हेडरअर्थ।
X-Nymbot-Cost-Satsइस अनुरोध की लागत क्या है, sats में।
X-Nymbot-Balance-Satsजो बाकी है उस संतुलन पर जिससे यह भुगतान किया गया था, 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_errorJSON का उपयोग नहीं किया जाता है (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इस कुंजी पर, इस पते से, या प्रमाण पत्रों के साथ बहुत सारे अनुरोध जो सत्यापित करने में विफल रहे (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).
  • एक स्ट्रीमिंग अनुरोध जो अपने पहले बाइट से पहले विफल हो जाता है, उसे उपरोक्त स्थिति के साथ एक साधारण JSON त्रुटि मिलती है, न कि एक इवेंट स्ट्रीम। स्ट्रीम शुरू होने के बाद एक विफलता को उस एंडप्वाइंट के अपने प्रारूप में स्ट्रीम के अंतिम इवेंट के रूप में भेजा जाता है।

त्रुटि संदेशों में कभी भी किसी अन्य सेवा का आंतरिक विवरण नहीं होता है। आपके पास पहुंचने से पहले प्रदाता की अपनी त्रुटि को फिर से लिखा जाता है।

सीमाएं

सीमामूल्य
प्रति कुंजी अनुरोध120 सेकंड के लिए, इसके अलावा, 429 के साथ Retry-After.
कुंजी के बिना अनुरोध120 एक मिनट प्रति पते, मॉडल, ऑडियो और भुगतान विधि सूची के लिए, वापसी टोकन चेक, और एक कुंजी या भुगतान के बिना फोन किए गए भुगतान अंत बिंदु। 429 के साथ Retry-After.
प्रमाणीकरण विफलकुंजी, हस्ताक्षर, भुगतान क्रेडेंशियल्स और रिफंड टोकन जो सत्यापित नहीं करते हैं, के लिए 30 रुपये प्रति मिनट प्रति पता। इसके अलावा, पते से प्रत्येक अनुरोध जिसमें एक क्रेडेंशियल होता है, प्राप्त होता है। 429 के साथ Retry-After मिनट खत्म हो जाता है. शरीर को पढ़ने से पहले मान्यताओं की जांच की जाती है.
नई कुंजियाँ60 प्रति घंटा प्रति एन. आई. एम. और 120 प्रति घंटा प्रति पता।
टॉप-अप चालान60 प्रति घंटा प्रति एन. आई. एम. और 120 प्रति घंटा प्रति पता।
एन. डब्ल्यू. सी. बटुआ कनेक्शन10 प्रति घंटा प्रति एन. आई. एम. और 30 प्रति घंटा प्रति पता। वॉलेट रिले का उपयोग करना पड़ता है wss:// मानक बंदरगाह पर।
टोकन वापसप्रति मिनट 60 अनुरोध।
पतेएक IPv6 पते को प्रत्येक पते सीमा में अपने पूरे /64 के रूप में गिना जाता है, और एक IPv4 मैप किया गया IPv6 पते को अपने IPv4 पते के रूप में गिना जाता है।
JSON अनुरोध शरीर4 एमबी; 64 के. बी. आपके एन. आई. एम. के साथ हस्ताक्षरित अनुरोधों के लिए।
बहु-भाग अनुरोध निकाय (अपलोड)32 एमबी. संपादित करने के लिए एक छवि 20 एमबी तक हो सकती है, एक ऑडियो फ़ाइल 25 एमबी तक हो सकती है. अधिकतम 64 भागों पर, प्रत्येक में अधिकतम 8 KB भाग शीर्षक, और 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 दिनों तक रखा गया।
सक्रिय कुंजी प्रति एन. आई. एम.केवल नवीनतम 50 रद्द कुंजी रखी जाती हैं।

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

आग क्या देखती है

एपीआई ऐप्स की तरह निजी नहीं है, और यह सटीक होने लायक है कि कैसे।

  • यह एंड-टू-एंड एन्क्रिप्टेड नहीं है। ऐप्स में, एक संदेश आपके डिवाइस पर केवल Nymbot को पकड़ने और एक के रूप में यात्रा करने के लिए कुंजी के लिए सील किया जाता है उपहार Wrap. एक एपीआई अनुरोध सामान्य एचटीटीपीएस होता हैः यह निम्बॉट के रास्ते में एन्क्रिप्ट किया जाता है, और निम्बॉट का सर्वर इसे संभालने के लिए इसे स्पष्ट रूप से पढ़ता है।
  • संकेत और उत्तर संग्रहीत नहीं किए जाते हैं। वे मॉडल के माध्यम से जाते हैं और जवाब वापस जाता है. जो रखा जाता है वह बिल है: प्रत्येक अनुरोध के लिए समय, मॉडल, प्रकार, टोकन गिनती, लागत, संतुलन, कुंजी और क्या यह सफल रहा, 90 दिनों के लिए, जो कि क्या है पूछताछ का इतिहास आपको दिखाता है। उसी अनुरोध (समय, प्रकार, मॉडल, टोकन गिनती, लागत, अवधि और क्या इसने वेब खोज का उपयोग किया या सफल हुआ) का उपयोग रिकॉर्ड भी ऐप के अपने साथ 90 दिनों के लिए रखा जाता है।
  • एक नाइम के लिए रखी गई अन्य सभी चीजें छोटी हैं और यहां सूचीबद्ध हैं। आग की कुंजी हैश के रूप में संग्रहीत किए जाते हैं, कभी भी कुंजी नहीं, उनके नाम के साथ, एक छोटा संकेत, खर्च की सीमा, रीसेट अवधि, समाप्ति और जब वे बनाए गए थे और अंतिम बार उपयोग किए गए थे; केवल नवीनतम 50 रद्द की गई कुंजियाँ रखी जाती हैं। स्वचालित टॉप-अप वॉलेट कनेक्शन को एन्क्रिप्टेड रूप से संग्रहीत किया जाता है, इसकी सीमा, राशि और अंतिम टॉप-अप के परिणाम के साथ। वीडियो नौकरियां 24 घंटे तक संग्रहीत की जाती हैं. कॉल पर भुगतान किए गए अनुरोध केवल 7 दिनों के लिए एक लाइटनिंग भुगतान हैश छोड़ देते हैं और 30 दिनों के लिए एक टॉप-अप रिटर्न टोकन, कोई नमी से जुड़ा हुआ है।
  • ऐप को हटाने से इसे हटाया जाता है। A उपकरण Wipe प्रत्येक एपीआई कुंजी को रद्द करता है और हटाता है, और पूछताछ इतिहास, उपयोग रिकॉर्ड, वॉलेट कनेक्शन और वीडियो नौकरियों को हटाता है।
  • मॉडल का प्रदाता आपके अनुरोध को देखता है, जैसा कि ऐप से होता है। कैटलॉग मॉडल अपने निर्माताओं पर चलते हैं; मानक मार्ग और एम्बेडिंग क्लाउडफ्लेयर पर चलते हैं।
  • सोशल मीडिया सार्वजनिक है। लिंक के रूप में दिए गए चित्र और वीडियो सार्वजनिक ब्लॉसम फ़ाइल होस्ट पर अपलोड किए जाते हैं, जहां एक फ़ाइल का पता उसका हैश होता है। लिंक वाला कोई भी व्यक्ति इसे खोल सकता है, और निम्बॉट इसे फिर से नीचे नहीं ले जा सकता है। इसके लिए पूछें b64_json और एक उत्पन्न छवि प्रतिक्रिया में वापस आती है और कभी अपलोड नहीं की जाती है।
  • आप जिन चित्रों को जनरेटर देते हैं, वे भी ऐसे ही हैं। एक तस्वीर जो आप अपलोड करते हैं एडिट, या एक के रूप में भेजें data: एक जनरेटर में URL image_url, पहले एक सार्वजनिक ब्लॉसम होस्ट पर अपलोड किया जाता है ताकि जनरेटर इसे प्राप्त कर सके, और वही उस पर लागू होता है। https:// लिंक को उस लिंक के रूप में भेजा जाता है। चैट अनुरोध में चित्र मॉडल के प्रदाता के पास जाते हैं, न कि ब्लॉसम के पास।
  • एक कुंजी आपके NIM से जुड़ी हुई है। एक कुंजी खर्च करने वाली हर चीज आपके नाम के संतुलन से आती है, इसलिए एपीआई का उपयोग नहीं है अनाम. यदि आप चाहते हैं कि ए. पी. आई. का उपयोग आपके रोजमर्रा के एन. आई. एम. से अलग रखा जाए, तो अपने स्वयं के संतुलन के साथ एक अलग एन. आई. एम. से चाबियाँ बनाएँ।

यदि आपको ऐप की सुरक्षा की आवश्यकता है, तो ऐप का उपयोग करें। एपीआई तब होता है जब आपको अपने स्वयं के उपकरणों में मॉडल की आवश्यकता होती है।

हर अंत

अंतिम बिंदुयह क्या करता हैऑथ.
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 जैसे कोडिंग एजेंटों के लिए, देखें कोडिंग उपकरण.