n8n-কে Tokens-এর সাথে যুক্ত করুন

n8n একটা workflow automation tool, ভেতরে AI node আছে। এর OpenAI credential-এ একটা Base URL field আছে, তাই OpenAI Chat Model node, আর তার মাধ্যমে AI Agent node, OpenAI Chat Completions request পাঠাতে পারে Tokens-এ, https://tokens.bd/v1-এ। ঠিকানাটা credential-এ একবার বসালেই হয়, ওই credential ব্যবহার করা প্রতিটা node সেটাই মানে।

এই গাইড n8n 2.42.6-এর সাথে মিলিয়ে দেখা হয়েছে (9 অক্টোবর 2026-এর stable release)। দেখা হয়েছে n8n-এর documentation আর OpenAI Chat Model node-এর source (node version 1.3), অক্টোবর 2026-এ। মিলিয়ে দেখা হয়েছে documentation আর source-এর সাথে, কোনো live Tokens key দিয়ে শুরু থেকে শেষ পর্যন্ত চালিয়ে দেখা হয়নি।

শুরুর আগে#

• একটা Tokens key। spend cap সহ key বানানোর কথা আছে API keys পেজে।
• model catalog থেকে একটা model ID। এই গাইডে deepseek/deepseek-v4.1-flash ব্যবহার করা হয়েছে।
• n8n, n8n Cloud হোক বা self-hosted, আর একটা workflow যেখানে AI Agent node যোগ করা যায়।

Base URL কোথায় থাকে#

বিভিন্ন সূত্র বিভিন্ন কথা বলে। তাই কী কী দেখা হয়েছে সেটা এখানে লেখা হলো।

• n8n-এর documentation-এ এর উল্লেখ নেই। OpenAI credentials পেজ-এ শুধু API key আর Organization ID আছে। OpenAI Chat Model পেজ-এও base URL-এর কথা নেই। মানে, n8n এটা documented করেনি।
• n8n-এর source-এ কিন্তু আছে। OpenAI credential-এ Base URL নামে একটা field আছে, বর্ণনা "Override the default base URL for the API", ডিফল্ট https://api.openai.com/v1। Credential-এর নিজের connection test ওই URL-এর /models call করে।
• Node-এর নিজের একটা ছিল। OpenAI Chat Model node-এ Base URL option আছে শুধু node version 1-এ। Version 1.1 থেকে সেটা লুকানো, আর node credential-এর Base URL পড়ে। আজ নতুন workflow বানালে version 1.3 পাবেন, তাই credential-টাই ব্যবহার করুন।
• GitHub issue 14431 ("Allow setting custom base URL in OpenAI node") যেদিন খোলা হয়েছিল সেদিনই not planned হিসেবে বন্ধ হয়, একজন maintainer উত্তর দেন যে এটা আগে থেকেই সম্ভব। পরের মন্তব্যগুলো provider-এর base URL সরাসরি ব্যবহার করতে বলে। এটা credential-এর field-এর সাথেই মেলে।

আপনার n8n যদি যাচাই করা version-এর চেয়ে পুরনো হয় আর credential-এ Base URL field না থাকে, আগে n8n update করুন।

Credential সেট করুন#

1. n8n-এ Credentials খুলে OpenAI type-এর নতুন একটা credential বানান।
2. API Key: আপনার Tokens key।
3. Organization ID (optional): ফাঁকা রাখুন।
4. Base URL: https://tokens.bd/v1। /v1-এ শেষ করুন, শেষে slash নয়, আর /chat/completions-ও নয়।
5. Add Custom Header বন্ধ রাখুন। Tokens-এর কোনো বাড়তি header লাগে না।
6. Save করুন। n8n Base URL-এর GET /models call করে credential test করে। সবুজ ফল মানে key আর ঠিকানা দুটোই ঠিক।

API Key:   tok_live_your_key
Base URL:  https://tokens.bd/v1

Self-hosted n8n-এ key রাখুন n8n-এর credential store-এ। workflow JSON বা এমন কোনো node field-এ নয়, যা export হয়ে যেতে পারে।

AI Agent node-এ ব্যবহার করুন#

1. একটা AI Agent node যোগ করুন, তারপর Chat Model connector-এ ক্লিক করে একটা OpenAI Chat Model sub-node যোগ করুন।
2. Credential to connect with: আপনার বানানো credential।
3. Model: By ID বেছে deepseek/deepseek-v4.1-flash টাইপ করুন। বিস্তারিত পরের section-এ।
4. Node-এ Use Responses API toggle দেখালে সেটা off করে দিন (নিচে দেখুন)।
5. Agent-এর সাথে tool বা memory যথারীতি জুড়ে দিন।

Slash-ওয়ালা model ID#

Tokens-এর ID দেখতে provider/model-এর মতো। Node version 1.2 আর তার পরে Model field-এর দুটো mode আছে, From List আর By ID।

• From List আপনার Base URL-এ GET /models call করে যা আসে তা দেখায়। Base URL api.openai.com না হলে node ফেরত আসা সব model কোনো filter ছাড়াই দেখায়। List-এ থাকে শুধু আপনার key যে model-গুলো চালাতে পারে, তাই key-তে allowed-models list থাকলে list ছোট হয়।
• By ID আপনি যা টাইপ করেন, অপরিবর্তিত অবস্থায় model-এর নাম হিসেবে পাঠায়। List ফাঁকা থাকলে বা চাওয়া model না থাকলে এটা ব্যবহার করুন। Slash-এর জন্য আলাদা escape লাগে না।

একটা তৃতীয়-পক্ষের লেখায় আছে, field-টাকে expression mode-এ নিয়ে ID একটা string হিসেবে টাইপ করা যায়। n8n-এর documentation এটা বলে না, আর By ID থাকায় এর দরকারও নেই, তাই এই গাইড এর ওপর নির্ভর করে না। যেসব পুরনো workflow-এ node version 1.1 বা তার কম, সেখানে Model field একটা সাধারণ dropdown, By ID mode নেই। সেখানে ID কীভাবে দিতে হয় তা n8n-এর documentation-এ নেই। Node-টা নতুন করে বানিয়ে নিন, তাতে সর্বশেষ version পাবেন।

Use Responses API বন্ধ করুন#

Node version 1.3-এ OpenAI Chat Model-এ একটা Use Responses API toggle আছে। n8n-এর documentation বলে Chat Completions-ই ডিফল্ট। কিন্তু node-এর source নতুন যোগ করা node-এ toggle-টা ডিফল্টে on রাখে। তাই node খুলে নিজে toggle-টা দেখে নিন।

Tokens /v1/responses serve করে শুধু তখন, যখন model-এর পেছনের upstream সেটা support করে (Responses API)। Chat Completions পুরো catalog জুড়ে চলে, তাই toggle-টা off করুন। Built-in Tools (Web Search, File Search, Code Interpreter) Responses API আর OpenAI-র নিজের জিনিস, তাই Tokens-এ খাটে না।

ঠিকমতো চলছে কিনা যাচাই করুন#

আগে curl দিয়ে key আর model পরীক্ষা করুন। এটা চললে আর n8n না চললে সমস্যা n8n-এর সেটিংসে।

export TOKENS_API_KEY=tok_live_your_key
curl -s https://tokens.bd/v1/chat/completions \
  -H "Authorization: Bearer $TOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek/deepseek-v4.1-flash", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with OK"}]}'

n8n-এ একটা Chat Trigger আর AI Agent node যোগ করুন, chat খুলে ছোট একটা message পাঠান। Agent উত্তর দেবে, আর request-টা আপনার Tokens Dashboard-এর usage analytics-এ দেখা যাবে। Node-এর সাথে তুলনা করতে একই URL-এ একটা HTTP Request node বসাতে পারেন, তাতে error body-টা পুরো পাবেন। OpenAI node "Bad request" দেখালে n8n-এর নিজের documentation-ও এটাই করতে বলে।

Tool calling#

AI Agent node সবসময় tools agent হিসেবেই কাজ করে: জুড়ে দেওয়া tool-এর মধ্যে কোনটা call করবে তা সে নিজেই ঠিক করে, আর n8n-এর documentation OpenAI Chat Model-কে তার supported model-দের একটা বলে। Tool calling-এর জন্য এমন model লাগে যা এটা support করে, আর n8n-এ এমন কোনো সেটিং নেই যা এটা চালু করে। Base URL override করা থাকলে OpenAI Chat Model node নিজেই সতর্ক করে, OpenAI-র বাইরের model tool calling বা JSON response format support নাও করতে পারে।

কোনো model-এর ওপর agent বানানোর আগে model catalog-এ তার পেজ দেখুন, আর পড়ুন Tool calling ও Choosing a model। Node strict tool calling বন্ধ রাখে, OpenAI-compatible backend ঠিক এটাই আশা করে।

Background-এ কীসে credit খরচ হয়#

Model-এর প্রতিটা call key-র হিসাবে billed হয়। একটা n8n agent অনেক call করতে পারে।

• প্রতিটা tool-এর result পাওয়ার পর agent আবার model-কে call করে। Max Iterations (Tools Agent options-এ ডিফল্ট 10) হলো একটা run-এ এই round-এর সীমা।
• প্রতি round-এ পুরো conversation আবার যায়, সাথে memory আর tool-এর output। তাই round বাড়লে input token-ও বাড়ে।
• Chat Model-এ Max Retries option আছে। সেট না থাকলে n8n-এর source 2 ধরে নেয়, ফলে fail হওয়া call একাধিকবার যেতে পারে।
• Schedule বা Webhook trigger কেউ না দেখলেও loop চালু করে দেয়, আর যে workflow অনেক item process করে সেটা প্রতি item-এ একবার করে agent চালায়।

n8n-এর জন্য আলাদা একটা key নিন, monthly spend cap আর allowed-models list সহ (API keys)। Cap-এ পৌঁছালে request চলতেই থাকে না, 403 monthly_spend_cap_exceeded দিয়ে fail করে, ফলে বিল বেড়ে যাওয়ার ভয় থাকে না। সহজ agent-এর জন্য Max Iterations কমান, আর node-এর options-এ Maximum Number of Tokens সেট করুন।

সীমা আর যা এখানে দেখা হয়নি#

• শুধু OpenAI Chat Model sub-node দেখা হয়েছে। আলাদা OpenAI node আর Embeddings OpenAI node একই credential ব্যবহার করে, কিন্তু n8n এগুলো custom Base URL-এর সাথে documented করেনি, তাই এখানে ধরা হয়নি। Tokens-এর embeddings endpoint চলে শুধু embedding model-এর জন্য (Models and usage)।
• Tokens image, audio, file বা assistants endpoint support করে না, তাই OpenAI node-এর ওই operation-গুলো 404 unsupported_endpoint ফেরত দেয়।
• শুধু Responses-এর option আর built-in tool ব্যবহার করা যায় না (ওপরে দেখুন)।

সমস্যা হলে#

Credential test 401 দিয়ে fail করছে। missing_api_key বা invalid_api_key মানে key ঠিকমতো paste হয়নি, অথবা revoke বা rotate হয়ে গেছে। Dashboard থেকে আবার copy করুন।

Credential test-এ বা প্রতিটা request-এ 404। Base URL ঠিক https://tokens.bd/v1 কিনা দেখুন: /v1 লাগবে, শেষে slash নয়, আর /chat/completions-ও নয়।

404 model_not_found। Model ID হতে হবে পুরো Tokens ID, যেমন deepseek/deepseek-v4.1-flash, slash-এর পরের অংশটুকু নয়। By ID বেছে নিন, আর GET /v1/models-এর সাথে মিলিয়ে দেখুন।

403 model_not_allowed_on_key। Key-তে এমন allowed-models list আছে যাতে এই model নেই। অনুমোদিত কোনো model নিন, অথবা বিধিনিষেধ ছাড়া অন্য key।

400 invalid_request, বা Responses API নিয়ে error। Use Responses API বন্ধ করুন। অন্য 400-এর জন্য HTTP Request node দিয়ে পুরো error body দেখুন, তারপর node যে parameter পাঠায় model সেগুলো support করে কিনা মিলিয়ে নিন।

Agent কখনো tool call করছে না, বা tool-এর argument ভাঙা আসছে। সম্ভবত model-টা tool calling ভালো সামলায় না। Catalog থেকে অন্য model চেষ্টা করুন।

429 rate_limited বা concurrency_limit। অনেক item process করা workflow request পাঠায় একসাথে। n8n-এর documentation বলে, ছোট ছোট batch পাঠাতে Loop Over Items node ব্যবহার করুন আর শেষে একটা Wait node দিন। Retry-After যত সেকেন্ড বলে তত অপেক্ষা করুন (Rate limits)।

402 insufficient_credits। billing-এ গিয়ে টাকা যোগ করুন বা renew করুন। মনে রাখবেন, "Insufficient quota"-র জন্য n8n-এর নিজের help text লেখা OpenAI account-এর কথা ভেবে, Tokens-এ খাটে না।

সব code-এর তালিকা আছে Errors-এ। support-এর সাথে যোগাযোগ করলে একই call curl দিয়ে চালিয়ে পাওয়া x-tokens-request-id header-টা সাথে দিন।

সূত্র: n8n OpenAI credentials, OpenAI Chat Model node আর তার common issues, AI Agent node আর তার Tools Agent পেজ, n8n issue 14431, আর [email protected] tag-করা n8n source (OpenAI credential আর OpenAI Chat Model node), অক্টোবর 2026-এ দেখা।