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

> n8n-এর OpenAI credential-এর Base URL বদলে Tokens-এ পাঠান, তারপর AI Agent node-এ OpenAI Chat Model চালান: model ID, Responses API toggle, tool calling আর খরচের সীমা।

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](/docs/api-keys) পেজে।
- [model catalog](/models) থেকে একটা model ID। এই গাইডে `deepseek/deepseek-v4.1-flash` ব্যবহার করা হয়েছে।
- n8n, n8n Cloud হোক বা self-hosted, আর একটা workflow যেখানে AI Agent node যোগ করা যায়।

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

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

- **n8n-এর documentation-এ এর উল্লেখ নেই।** [OpenAI credentials পেজ](https://docs.n8n.io/integrations/builtin/credentials/openai/)-এ শুধু API key আর Organization ID আছে। [OpenAI Chat Model পেজ](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/)-এও 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 আর ঠিকানা দুটোই ঠিক।

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

:::note[Gateway credits নয়]
n8n Cloud-এ supported node-গুলোর credential field-এ "Use Gateway credits" দেখা যায়। ওটা n8n-এর নিজের billing, Tokens-এর মধ্য দিয়ে যায় না। তার বদলে এইমাত্র বানানো credential-টা বেছে নিন।
:::

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](/docs/responses))। Chat Completions পুরো catalog জুড়ে চলে, তাই toggle-টা off করুন। Built-in Tools (Web Search, File Search, Code Interpreter) Responses API আর OpenAI-র নিজের জিনিস, তাই Tokens-এ খাটে না।

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

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

```bash
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](/models)-এ তার পেজ দেখুন, আর পড়ুন [Tool calling](/docs/tool-calling) ও [Choosing a model](/docs/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](/docs/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](/docs/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](/docs/rate-limits))।

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

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

সূত্র: [n8n OpenAI credentials](https://docs.n8n.io/integrations/builtin/credentials/openai/), [OpenAI Chat Model node](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/) আর তার [common issues](https://docs.n8n.io/integrations/builtin/cluster-nodes/sub-nodes/n8n-nodes-langchain.lmchatopenai/common-issues/), [AI Agent node](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/) আর তার [Tools Agent পেজ](https://docs.n8n.io/integrations/builtin/cluster-nodes/root-nodes/n8n-nodes-langchain.agent/tools-agent/), [n8n issue 14431](https://github.com/n8n-io/n8n/issues/14431), আর n8n@2.42.6 tag-করা n8n source (OpenAI credential আর OpenAI Chat Model node), অক্টোবর 2026-এ দেখা।

---
Page: https://tokens.bd/bn/docs/n8n