हर इंटीग्रेशन को जो तीन मानों की आवश्यकता होती है
nanobanana api इंटीग्रेशन के लगभग हर गाइड में अलग-अलग जगह पर समान तीन फ़ील्ड्स भरने की बात की जाती है। यह सेवा OpenAI चैट-कम्प्लीशंस प्रोटोकॉल का उपयोग करती है, इसलिए कोई भी टूल जो OpenAI एंडपॉइंट को ओवरराइड करने की अनुमति देता है, इसके साथ बातचीत कर सकता है।
| फ़ील्ड | मान |
|---|---|
| बेस URL | https://api.nanobananaapis.com/v1 |
| API कुंजी | आपकी कुंजी, Authorization: Bearer <key> के रूप में भेजी जाती है |
| मॉडल ID | uncensored |
शुरू करने से पहले एक स्कोप नोट। यह एक टेक्स्ट लैंगुएज मॉडल है, इसलिए यह उन जगहों पर काम नहीं करेगा जहाँ छवि जनरेशन, स्पीच या एम्बेडिंग्स की उम्मीद की जाती है। समर्थित विधियाँ POST /v1/chat/completions और GET /v1/models हैं। यदि कोई टूल खोज के लिए एम्बेडिंग मॉडल मांगता है, तो उस भाग को किसी अलग प्रदाता की ओर इशारा करें।
आपकी कुंजी API key page से मिलती है। नए खातों एक क्लिक के साथ $0.50 का ट्रायल क्रेडिट दावा कर सकते हैं, बिना कार्ड के, जो 7 दिनों के लिए मान्य है।
किसी भी टूल को छुए जाने से पहले एंडपॉइंट का परीक्षण करें
जब कोई इंटीग्रेशन विफल होती है, तो लोग टूल को दोष देते हैं। अधिकांश समय कुंजी या URL गलत होता है। एक तीस सेकंड का curl टेस्ट उस शक को दूर करता है। पहले मॉडल की सूची बनाएँ:
curl https://api.nanobananaapis.com/v1/models -H "Authorization: Bearer YOUR_API_KEY"
फिर एक छोटी चैट अनुरोध भेजें:
curl https://api.nanobananaapis.com/v1/chat/completions -H "Authorization: Bearer YOUR_API_KEY" -H "Content-Type: application/json" -d '{"model":"uncensored","messages":[{"role":"user","content":"Reply with the word ready."}],"max_tokens":10}'
यदि दोनों काम करते हैं, तो एंडपॉइंट और कुंजी ठीक हैं, और बाद की कोई भी त्रुटि टूल की कॉन्फ़िगरेशन के तरीके से आती है। यदि पहला कॉल 401 लौटाता है, तो कुंजी गलत है या हेडर में Bearer शब्द छूट गया है। 404 आमतौर पर इसका मतलब है कि URL में /v1 छूट गया है या एक अतिरिक्त पथ है।
सिली टैवर्न
SillyTavern रोलप्ले और कैरेक्टर चैट के लिए एक फ्रंट एंड है, और यह आपको एक OpenAI-कम्पैटिबल एंडपॉइंट जोड़ने की अनुमति देता है। मेनू लेबल्स रिलीज के बीच बदल जाते हैं, इसलिए चरणों को एक मैप के रूप में देखें, बिल्कुल शब्दावली के रूप में नहीं।
- API कनेक्शन पैनल खोलें और API प्रकार के रूप में Chat Completion चुनें।
- कस्टम (OpenAI-संगत) स्रोत का चयन करें।
- एंडपॉइंट URL के रूप में
https://api.nanobananaapis.com/v1पेस्ट करें। - कुंजी फ़ील्ड में अपनी कुंजी पेस्ट करें।
- मॉडल नाम के रूप में
uncensoredदर्ज करें, या कनेक्ट बटन दबाएँ और उस सूची से चुनें जोGET /v1/modelsलौटाती है। - कनेक्ट दबाएँ और एक टेस्ट संदेश भेजें।
दो ट्यूनिंग नोट्स। SillyTavern कैरेक्टर कार्ड्स के साथ लंबी हिस्ट्री भेजता है, इसलिए प्रॉम्प्ट और रिप्लाई दोनों के लिए शेयर की गई 100,000-टोकन कॉन्टेक्स्ट विंडो पर ध्यान दें। और यदि आप ग्रुप चैट्स का उपयोग करते हैं जो एक साथ कई कंकरेंट रिक्वेस्ट फायर करते हैं, तो एक फुल की पर 8 कंकरेंट रिक्वेस्ट की लिमिट याद रखें (ट्रायल की पर 2)। रोलप्ले और कंपैनियन सेटअप्स वयस्कों के लिए हैं; मॉडल किसी भी प्रॉम्प्ट के तहत नाबालिगों से संबंधित यौन सामग्री नहीं उत्पन्न करेगा।
लैंगचेन
Python में, langchain-openai पैकेज ChatOpenAI प्रदान करता है, जो एक कस्टम बेस URL स्वीकार करता है। इसे pip install langchain-openai के साथ इंस्टॉल करें।
import os
from langchain_openai import ChatOpenAI
llm = ChatOpenAI(
base_url="https://api.nanobananaapis.com/v1",
api_key=os.environ["NANOBANANA_KEY"],
model="uncensored",
temperature=0.7,
)
print(llm.invoke("Give me three names for a fictional smuggler ship.").content)
चेन, प्रॉम्प्ट टेम्पलेट और आउटपुट पार्सर बाद में उसी तरह काम करते हैं, क्योंकि उन्हें केवल चैट इंटरफ़ेस की ज़रूरत होती है। टूल कॉलिंग स्टैंडर्ड पाथ से जाती है, इसलिए llm.bind_tools([...]) रिक्वेस्ट में tools भेजता है। किसी एजेंट के आसपास बिल्ड करने से पहले एक सिंगल टूल कॉल टेस्ट करें, और एजेंट पेरालेलिज़्म को 8 तक सीमित करें। एक ग्राफ जो बीस शाखाओं में फैलता है, वह concurrency एरर पर पहुंच जाएगा।
जावास्क्रिप्ट पैकेज @langchain/openai configuration: { baseURL } विकल्प पर ChatOpenAI के माध्यम से उसी विचार को लागू करता है।
Cursor और अन्य एडिटर
Cursor, कई अन्य कोडिंग एडिटरों की तरह, मॉडल के लिए सेटिंग्स क्षेत्र रखता है जहाँ आप अपना खुद का OpenAI API कुंजी प्रदान कर सकते हैं और बेस URL ओवरराइड कर सकते हैं। लगभग: मॉडल सेटिंग्स खोलें, कस्टम OpenAI कुंजी विकल्प को सक्षम करें, ओवरराइड बेस URL को https://api.nanobananaapis.com/v1 पर सेट करें, अपनी कुंजी पेस्ट करें, और uncensored को एक कस्टम मॉडल नाम के रूप में जोड़ें।
इससे आपको क्या मिलता है, इस बारे में यथार्थवादी रहें। एडिटर अपने खुद के बैकएंड और विशिष्ट मॉडल नामों के आसपास कुछ सुविधाएँ बनाते हैं, जैसे कि इनलाइन पूर्वावलोकन, इसलिए एक कस्टम एंडपॉइंट केवल चैट या कमांड के एक उपसमुच्चय पर ही लागू हो सकता है। सटीक विकल्प संस्करणों के बीच बदलते हैं, इसलिए एडिटर की वर्तमान दस्तावेज़ीकरण जाँचें। यदि कोई सुविधा कुछ ऐसा माँगती है जो इस API प्रदान नहीं करती, जैसे कि एम्बेडिंग या इमेज इनपुट, तो यह इस एंडपॉइंट के माध्यम से काम नहीं करेगी।
Open WebUI, Continue और अन्य समान चैट फ्रंट एंड्स जैसे अन्य OpenAI-संगत क्लाइंट्स के लिए वही पैटर्न लागू होता है: एक कस्टम OpenAI एंडपॉइंट के लिए फ़ील्ड खोजें, तीन मान दर्ज करें और परीक्षण करें।
सादे SDK और पर्यावरण चर
यदि आप अपना कोड लिखते हैं, तो आधिकारिक SDK मानक पर्यावरण चर पढ़ते हैं, जिससे आप स्रोत फ़ाइलों को छुए बिना एंडपॉइंट बदल सकते हैं। Python और Node SDK में, OPENAI_BASE_URL और OPENAI_API_KEY सेट करना पर्याप्त है।
export OPENAI_BASE_URL="https://api.nanobananaapis.com/v1"
export OPENAI_API_KEY="YOUR_API_KEY"
python app.py # app.py calls client.chat.completions.create(model="uncensored", ...)
Node में एक स्पष्ट क्लाइंट इस प्रकार दिखता है:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.nanobananaapis.com/v1",
apiKey: process.env.NANOBANANA_KEY,
});
const stream = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Draft a short product description for a paper lantern." }],
stream: true,
});
for await (const part of stream) {
process.stdout.write(part.choices[0]?.delta?.content ?? "");
}
स्ट्रीमिंग SSE के माध्यम से आती है और उपयोग अंत में रिपोर्ट किया जाता है। फुल पैरामीटर विवरण docs पेज पर हैं, और प्रॉम्प्ट जनरेशन पर आर्टिकल दिखाता है कि एक टेक्स्ट स्टेप को इमेज पाइपलाइन से कैसे कनेक्ट करें।
सामान्य विफलताओं को ठीक करना
| लक्षण | संभावित कारण | समाधान |
|---|---|---|
| 401 अनअथोराइज्ड | गलत कुंजी, या हेडर में Bearer अनुपस्थित | कुंजी को दोबारा टाइप करें और curl के साथ परीक्षण करें |
| 404 Not Found | बेस URL में /v1 नहीं है, या डबल पथ | सटीक रूप से https://api.nanobananaapis.com/v1 का उपयोग करें |
| मॉडल नहीं मिला | टूल डिफ़ॉल्ट रूप से एक विक्रेता मॉडल नाम पर जाता है | मॉडल को uncensored पर सेट करें |
429 with rate_limited | प्रति मिनट 300 से अधिक अनुरोध (ट्रायल पर 60) | गति धीमी करें और पुनः प्रयास करें |
concurrency के साथ 429 | एक साथ 8 से अधिक अनुरोध (ट्रायल पर 2) | समानांतर अनुरोध कम करें |
| Retry-After: 5 के साथ 429 | अस्थायी ओवरलोड | पाँच सेकंड प्रतीक्षा करें और पुनः प्रयास करें |
| अनुरोध बहुत बड़ा है | बॉडी 8 MB से अधिक | अटैचमेंट या इतिहास को कम करें |
ध्यान रखें कि एक स्ट्रीम किए गए अनुरोध में समानांतरता स्लॉट तब तक आबद्ध रहता है जब तक कि स्ट्रीम समाप्त न हो जाए, इसलिए एक संपादक जो स्ट्रीम्स को छोड़ देता है, वह व्यस्त न होने पर भी सीमा को छूता हुआ प्रतीत हो सकता है। विफल कॉलों से X-Request-Id हेडर को लॉग करें; सपोर्ट इसे सबसे पहले मांगेगा।
लागत के बारे में, 2,000 टोकन इन और 500 आउट की एक सामान्य चैट मैसेज की लागत $0.00055 है ($0.15 और $0.50 प्रति 1M टोकन पर), और फेल रिक्वेस्ट पर चार्ज नहीं किया जाता है। प्राइसिंग पेज $20 से $500 तक के टॉप-अप और बोनस टियर्स को कवर करता है।
कुंजियाँ, सुरक्षा और कौन क्या देखता है
प्रत्येक इंटीग्रेशन आपकी कुंजी को कहीं न कहीं स्टोर करता है, और कुछ इसे अन्य की तुलना में बेहतर स्टोर करते हैं। एक डेस्कटॉप फ्रंट एंड में कुंजी एक लोकल सेटिंग्स फ़ाइल में होती है। एक ब्राउज़र-आधारित टूल में यह ब्राउज़र में सहेजी जा सकती है। एक एडिटर में यह ऐप कॉन्फ़िगरेशन में रहती है। स्क्रीन शेयर करने, एक डॉटफ़ाइल कमिट करने या किसी को लैपटॉप सौंपने से पहले जान लें कि आप किसका उपयोग कर रहे हैं।
कुछ नियम इसे प्रबंधनीय बनाए रखते हैं। जहाँ संभव हो, प्रत्येक टूल के लिए एक अलग API कुंजी का उपयोग करें, ताकि एक को बदलने पर बाकी न टूटें। मदद माँगते समय अपनी कुंजी को सार्वजनिक इश्यू ट्रैकर में पेस्ट न करें; इसके बजाय अनुरोध ID साझा करें। यदि कुंजी लीक हो जाती है, तो कुंजी पृष्ठ से उसे बदलें और अपने टूल्स को अपडेट करें। API के माध्यम से भेजे गए प्रॉम्प्ट को ट्रेनिंग के लिए उपयोग नहीं किया जाता है, और गोपनीयता पृष्ठ डेटा हैंडलिंग के शेष पहलुओं का वर्णन करता है।
यदि आप अन्य लोगों के लिए एक फ्रंट एंड होस्ट करते हैं, तो अपनी कुंजी ब्राउज़र में न भेजें। अपने उपयोगकर्ताओं और API के बीच एक छोटा सर्वर रखें, वहाँ अपनी सीमाएँ जोड़ें, और कुंजी सर्वर पर रखें। आपके उपयोगकर्ता फिर आपके 8 समानांतर अनुरोध साझा करते हैं, इसलिए योजना बनाएँ कि एक साथ कितने लोग चैट कर सकते हैं।
कौन सा टूल किस काम के लिए उपयुक्त है
चूंकि इंटीग्रेशन हर जगह समान है, टूल का चयन इस बात पर निर्भर करता है कि आप क्या बना रहे हैं।
- SillyTavern या एक समान चैट फ्रंट-एंड वयस्कों के लिए किरदार चैट, कथा और रोलप्ले के लिए उपयुक्त है, जहां आपको बिना कोड लिखे एक परिष्कृत इंटरफ़ेस और किरदार कार्ड चाहिए।
- LangChain कोड में पाइपलाइन्स के लिए उपयुक्त है: लोडर्स, प्रॉम्प्ट टेम्पलेट्स, पार्सर और मल्टी-स्टेप चेन। यह एक और डिपेंडेंसी की लागत पर संरचना जोड़ता है।
- एक साधारण SDK कॉल छोटे स्क्रिप्ट्स और सेवाओं के लिए उपयुक्त है। यदि आपका कार्य एक प्रॉम्प्ट इन और एक उत्तर आउट है, तो OpenAI पैकेज का रखरखाव एक फ्रेमवर्क की तुलना में कम होता है।
- Cursor जैसे एडिटर कोड पर चैट के लिए उपयुक्त हैं। किसी पर भरोसा करने से पहले जांचें कि इसके कौन से फीचर्स एक कस्टम एंडपॉइंट स्वीकार करते हैं।
साधारण curl टेस्ट से शुरू करें, फिर SDK का उपयोग करें, और तभी फ्रेमवर्क जोड़ें जब आपको आवश्यकता महसूस हो। बाद में बदलना आसान है, क्योंकि तीनों मान कभी नहीं बदलते। पहले अनुरोध और पूर्ण पैरामीटर सूची के लिए, दस्तावेज़ पढ़ें।
