HI ▾
API कुंजी पाएँ

n8n में OpenAI-संगत API: सेटअप गाइड

यदि आपने openai compatible api n8n खोजा था, तो संक्षिप्त उत्तर यह है कि आपको OpenAI क्रेडेंशियल में केवल दो मान बदलने हैं, Base URL और API कुंजी। शेष वर्कफ़्लो किसी भी OpenAI नोड के साथ समान रहता है।

अपडेट किया गया

API टर्मिनल में डेटा भेजने वाले जुड़े ब्लॉक्स के साथ आइसोमेट्रिक ऑटोमेशन वर्कफ़्लो

मुख्य बिंदु

शुरू करने से पहले आपको क्या चाहिए

एक n8n इंस्टेंस (क्लाउड या सेल्फ-होस्टेड) और इस सेवा से एक API कुंजी। यदि आपके पास अभी तक कुंजी नहीं है, तो API कुंजी पृष्ठ आपको Google या ईमेल और पासवर्ड से साइन-अप करने में मार्गदर्शन करता है। नए उपयोगकर्ता उस पृष्ठ पर एक क्लिक से 7 दिनों के लिए वैध और बिना कार्ड के $0.50 का ट्रायल क्रेडिट दावा कर सकते हैं।

तीन मान n8n में जाते हैं:

  • Base URL: https://api.onekeyllmapi.com/v1
  • API कुंजी: Authorization: Bearer <key> के रूप में भेजी जाती है, जिसे n8n आपके लिए करता है
  • मॉडल ID: uncensored

यह सेवा एक होस्टेड, टेक्स्ट-ओनली LLM API है जो /v1/chat/completions, /v1/responses और /v1/models के लिए OpenAI अनुरोध प्रारूप का पालन करती है। यह किसी मॉडल विक्रेता की आधिकारिक API नहीं है, इसलिए n8n द्वारा OpenAI के चैट एंडपॉइंट पर भेजा गया कुछ भी यहाँ काम करता है, जब तक कि वह एक टेक्स्ट अनुरोध हो।

चरण 1: क्रेडेंशियल बनाएं

n8n में Credentials खोलें, Create credential चुनें और OpenAI API के लिए खोजें। इसे इस प्रकार भरें:

  1. अपनी कुंजी API Key फ़ील्ड में पेस्ट करें।
  2. Organization ID खाली छोड़ें।
  3. डिफ़ॉल्ट Base URL को https://api.onekeyllmapi.com/v1 से बदलें। अंत में /v1 रखें और /chat/completions न जोड़ें।
  4. सहेजें। n8n सहेजते समय एक छोटा टेस्ट कॉल चलाता है; यदि यह विफल हो जाता है, तो नीचे दिए गए ट्रबलशूटिंग अनुभाग पर जाएं।

प्रत्येक एन्वायरनमेंट के लिए एक क्रेडेंशियल रखें। यदि आप एक स्टैजिंग और एक प्रोडक्शन n8n चलाते हैं, तो प्रत्येक को अपनी कुंजी दें ताकि आप खर्च अलग-अलग देख सकें और एक को बिना दूसरे को छुए रद्द कर सकें।

चरण 2: एक सरल चैट कार्यप्रवाह बनाएं

कनेक्शन को साबित करने के लिए सबसे छोटी चीज़ से शुरू करें: एक मैनुअल ट्रिगर और एक मॉडल कॉल।

  1. एक Manual Trigger नोड जोड़ें।
  2. एक OpenAI नोड (या एक बेसिक LLM चेन के अंदर OpenAI Chat Model सब-नोड, आपके n8n संस्करण के अनुसार) जोड़ें और चरण 1 से क्रेडेंशियल चुनें।
  3. मॉडल के लिए, एक ID हाथ से दर्ज करने का तरीका खोजें। हाल के n8n संस्करणों में सूची के बगल में By ID मोड होता है। वहां uncensored टाइप करें। सूची खाली हो सकती है या केवल OpenAI नाम दिखा सकती है, क्योंकि n8n इसे अपनी ओर से फ़िल्टर करता है।
  4. एक प्रॉम्प्ट जैसे इस सहायता टिकट का सारांश दो वाक्यों में लिखें जोड़ें और नोड चलाएं।

यदि आपका n8n वर्शन एक सूची से चुनने पर ज़िद करता है, तो अगले अनुभाग में HTTP Request दृष्टिकोण का उपयोग करें। यह हमेशा काम करता है क्योंकि आप पूरे अनुरोध पर नियंत्रण रखते हैं।

HTTP Request नोड के साथ API कॉल करना

HTTP Request नोड इस API को n8n से कॉल करने का सबसे भरोसेमंद तरीका है, और यह API द्वारा स्वीकृत प्रत्येक पैरामीटर को एक्सपोज़ करता है, जिसमें seed, stop, top_p और tools शामिल हैं। इसे इस प्रकार कॉन्फ़िगर करें:

  • विधि: POST
  • URL: https://api.onekeyllmapi.com/v1/chat/completions
  • प्रमाणीकरण: Generic Credential Type Header Auth के साथ, नाम Authorization, मान Bearer YOUR_KEY
  • बॉडी भेजें: ऑन, कंटेंट टाइप JSON

बॉडी (यदि आप पहले के नोड्स से डेटा डालना चाहते हैं तो फ़ील्ड को Expression पर स्विच करें):

{
  "model": "uncensored",
  "messages": [
    {"role": "system", "content": "You are a concise assistant."},
    {"role": "user", "content": "Summarize this support ticket in two sentences."}
  ],
  "temperature": 0.4
}

प्रतिक्रिया पाठ choices[0].message.content पर मौजूद है। अगले नोड में आप इसे {{ $json.choices[0].message.content }} से संदर्भित कर सकते हैं।

n8n के बाहर उसी अनुरोध का परीक्षण करने के लिए, टर्मिनल में यह चलाएँ:

curl https://api.onekeyllmapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Say hello in five words."}]}'

यदि curl काम करता है और n8n नहीं, तो समस्या नोड सेटिंग्स में है, न कि आपकी कुंजी या बैलेंस में।

आउटपुट को पार्स करने वाले वर्कफ़्लो के लिए JSON मोड

जब एक मॉडल डेटा को मित्रवत पाठ में लिपट देता है तो वर्कफ़्लो टूट जाते हैं। JSON मोड API से एक वैध JSON ऑब्जेक्ट लौटने का अनुरोध करता है, जिसे आप सीधे एक Set या IF नोड को पास कर सकते हैं। बॉडी में response_format जोड़ें:

{
  "model": "uncensored",
  "response_format": {"type": "json_object"},
  "messages": [
    {"role": "system", "content": "Reply only with a JSON object with keys sentiment and summary."},
    {"role": "user", "content": "The delivery was late but support fixed it fast."}
  ]
}

दो आदतें इसे विश्वसनीय बनाती हैं। पहला, प्रॉम्प्ट में JSON शब्द और कुंजियों के नाम दें, क्योंकि JSON मोड सिंटैक्स की गारंटी देता है, न कि आपके स्कीमा की। दूसरा, प्रतिक्रिया अभी भी message.content में एक स्ट्रिंग के रूप में आती है, इसलिए फ़ील्ड्स पढ़ने से पहले Code नोड या JSON.parse() के साथ एक एक्सप्रेशन जोड़ें। OpenAI नोड में, वही स्विच नोड विकल्पों के तहत Response Format विकल्प के रूप में दिखाई देता है।

429 और अन्य त्रुटियों का प्रबंधन

n8n आइटम्स को समानांतर चलाता है, इसलिए 50 पंक्तियों का बैच सीमाओं को जल्दी छू सकता है। एक पूर्ण कुंजी 8 समानांतर अनुरोधों और प्रति मिनट 300 अनुरोधों की अनुमति देती है; एक ट्रायल कुंजी 2 और 60 की अनुमति देती है। जब आप सीमा से अधिक जाते हैं, तो API HTTP 429 उत्तर देती है कोड rate_limited (प्रति मिनट बहुत अधिक) या concurrency (एक साथ बहुत अधिक) के साथ। अस्थायी ओवरलोड पर आपको 429 मिलता है Retry-After: 5 हेडर के साथ।

n8n में व्यावहारिक सेटिंग्स:

  • नोड खोलें, Settings पर जाएं, Retry On Fail सक्षम करें, Max Tries को 3 या 4 पर सेट करें और Wait Between Tries को 5000 ms पर सेट करें।
  • मॉडल कॉल से पहले एक Loop Over Items नोड (बैच साइज़ 4 से 6) रखें ताकि आप 8 समानांतर अनुरोधों से नीचे रहें।
  • नोड Settings के तहत, On Error को त्रुटि आउटपुट के साथ जारी रखने के लिए सेट किया जा सकता है, ताकि एक खराब पंक्ति रन को न रोकें।

सीमाओं के दो प्रकारों के बारे में गहराई से पढ़ने के लिए API दस्तावेज़ीकरण पढ़ें। अन्य त्रुटियां सरल हैं: 401 का अर्थ है कि कुंजी गलत है या हेडर में Bearer शब्द गायब है, और 404 का अर्थ आमतौर पर आधार URL में टाइपो या अतिरिक्त पाथ सेगमेंट है।

ट्रबलशूटिंग चेकलिस्ट

अधिकांश विफलताएं कारणों की एक छोटी सूची से आती हैं। सेवा को संदिग्ध मानने से पहले इसे ऊपर से नीचे तक क्रम से हल करें।

लक्षणसंभावित कारणसमाधान
सेव या रन पर 401गलत कुंजी, या हेडर में Bearer नहीं हैकुंजी को फिर से पेस्ट करें; Header Auth में मान Bearer से शुरू होना चाहिए
404आधार URL में टाइपो या अतिरिक्त पथ हैक्रेडेंशियल में बिल्कुल https://api.onekeyllmapi.com/v1 का उपयोग करें
मॉडल नहीं मिलाModel ID को uncensored के रूप में टाइप नहीं किया गयाBy ID पर स्विच करें, या HTTP Request नोड का उपयोग करें
429 समानांतर अनुरोधों के साथ8 से अधिक समानांतर रन (ट्रायल कुंजी पर 2)Loop Over Items के साथ बैच बनाएं और रेट्री जोड़ें
डेटा प्रसंस्करण श्रृंखला में JSON पार्स त्रुटिप्रतिक्रिया एक स्ट्रिंग है, या प्रॉम्प्ट ने कुंजियों का नाम नहीं दियाJSON.parse() से पार्स करें और सिस्टम प्रॉम्प्ट में कुंजियों का वर्णन करें

जब आप सपोर्ट से संपर्क करते हैं, तो विफल कॉल से X-Request-Id रिस्पॉन्स हेडर शामिल करें। n8n में, आप HTTP Request नोड ऑप्शन में Include Response Headers and Status को चालू करके हेडर देख सकते हैं।

कम खर्च करके परीक्षण

बिल्ड करते समय ट्रायल क्रेडिट का उपयोग करें। 2 समानांतर अनुरोध और प्रति मिनट 60 अनुरोध की सीमा के साथ, बैच के लिए ट्रायल कुंजी धीमी हो सकती है, लेकिन क्रेडेंशियल, प्रॉम्प्ट और पार्सिंग लॉजिक की जाँच के लिए यह पर्याप्त है। जब आप वर्कफ़्लो को शेड्यूल पर ले जाएं, तो पूर्ण कुंजी पर स्विच करें।

लागत और एक समझदारी भरा वर्कफ़्लो डिज़ाइन

मूल्य निर्धारण 'pay as you go' है: $0.15 प्रति 1M इनपुट टोकन और $0.50 प्रति 1M आउटपुट टोकन, प्रीपेड क्रेडिट से। एक कार्यप्रवाह जो 1,000 ईमेलों को वर्गीकृत करता है प्रत्येक में 600 इनपुट और 100 आउटपुट टोकन के साथ, 0.6M इनपुट टोकन ($0.09) और 0.1M आउटपुट टोकन ($0.05) का उपयोग करता है, प्रतिदिन लगभग $0.14। विफल या अस्वीकृत अनुरोधों के लिए चार्ज नहीं किया जाता है, इसलिए त्रुटियों पर पुनः प्रयास बिल को दोगुना नहीं करते। विवरण मूल्य निर्धारण पृष्ठ पर हैं।

प्रॉम्प्ट को छोटा रखें, केवल उन फ़ील्ड्स भेजें जिनकी मॉडल को आवश्यकता है, और जब आप जानते हैं कि उत्तर संक्षिप्त है तो max_tokens सेट करें। यदि आप अपने स्वयं के मशीन पर मॉडल भी चलाते हैं, तो OpenAI-शैली API के माध्यम से लोकल LLM का उपयोग लेख देखें, जो समान क्लाइंट सेटिंग्स का उपयोग करता है।

प्रश्न और उत्तर

कौन से n8n नोड कस्टम बेस URL के साथ काम करते हैं?

कोई भी नोड जो OpenAI क्रेडेंशियल का उपयोग करता है, उसे उपयोग कर सकता है, क्योंकि Base URL फ़ील्ड क्रेडेंशियल से संबंधित है। यदि कोई नोड आपको आवश्यक पैरामीटर प्रदर्शित नहीं करता है, तो HTTP Request नोड का उपयोग करें।

n8n में मॉडल की सूची खाली या गलत क्यों है?

n8n सूची को अपने पक्ष पर लोड और फ़िल्टर करता है। मॉडल ID uncensored को मैन्युअल रूप से दर्ज करें, या HTTP Request नोड का उपयोग करें जहाँ मॉडल बॉडी में केवल एक फ़ील्ड के रूप में मौजूद है।

क्या मैं n8n में स्ट्रीमिंग का उपयोग कर सकता हूँ?

API SSE के माध्यम से स्ट्रीमिंग का समर्थन करता है, लेकिन अधिकांश n8n नोड्स डेटा आगे बढ़ाने से पहले पूर्ण प्रतिक्रिया का प्रतीक्षा करते हैं। वर्कफ़्लो के लिए, एक सामान्य नॉन-स्ट्रीमिंग कॉल अधिक सरल है।

मैं वर्कफ़्लो से अपनी शेष राशि कैसे जाँच सकता हूँ?

GET /v1/balance कॉल करें, या किसी भी प्रतिक्रिया पर X-Balance-USD हेडर पढ़ें, और एक IF नोड जोड़ें जो आपको सूचित करे जब यह एक थ्रेशोल्ड से नीचे गिर जाए।

आपकी कुंजी बस एक फ़ॉर्म दूर है

एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।