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

> Amp-এর নিজের catalog-এর model Model Routing-এর Custom URL connection দিয়ে Tokens-এ পাঠান। Amp-এ নতুন model ID যোগ করা যায় না, তাই আগে সীমাবদ্ধতা পড়ে নিন।

Amp (ampcode.com, Sourcegraph-এর তৈরি) একটা coding agent। এর settings UI আছে, CLI-ও আছে। Amp-এর **Model Routing** feature দিয়ে কোনো model-এর request নিজের পছন্দের connection দিয়ে পাঠানো যায়। এই connection-কে বলে Custom URL। Custom URL connection `https://tokens.bd/v1`-এ OpenAI Chat Completions বলতে পারে, অথবা `https://tokens.bd`-তে Anthropic Messages।

## সীমাবদ্ধতা: Amp শুধু নিজের catalog-এর model route করে

শুরুর আগে এটা পড়ে নিন, কারণ Amp আপনার কাজে লাগবে কিনা, তা এর ওপরই নির্ভর করছে।

Amp-এর model mapping **Amp-এর নিজস্ব canonical model ID** ব্যবহার করে, যার চেহারা `provider/model`। Custom URL connection শুধু সেই model-ই চালাতে পারে, যা আগে থেকেই Amp-এর catalog-এ আছে। upstream-এ যে ID যাবে, সেটা আপনি বদলাতে পারবেন। কিন্তু Amp যে model চেনে না, তেমন নতুন model যোগ করতে পারবেন না।

Tokens-এর ক্ষেত্রে এর মানে:

- কোনো model Amp-এর catalog-এ আছে আর Tokens-এও একই model আছে, তাহলে সেটা Tokens দিয়ে route করা যায়।
- `deepseek/deepseek-v4.1-flash` বা Tokens-এর অন্য কোনো model Amp-এ যোগ করা যাবে না, যদি না Amp-এর catalog-এ তার জন্য entry থাকে। Amp-এর catalog-এ Tokens-এর সাথে মেলানো যায় এমন কোনো DeepSeek model আছে কিনা, তা আমরা নিশ্চিত করে দেখিনি।

Tokens [catalog](/models)-এর যেকোনো model স্বাধীনভাবে বাছতে চাইলে এমন agent নিন, যাতে custom provider খোলাখুলি দেওয়া যায়। যেমন [OpenCode](/docs/opencode), [Claude Code](/docs/claude-code) বা [Cline](/docs/cline)।

## Amp Model Routing-এ Custom URL connection যোগ করুন

### 1. key তৈরি করুন

Dashboard থেকে একটা API key তৈরি করুন। spend cap আর allow-list নিয়ে জানতে দেখুন [API keys](/docs/api-keys)। Amp Tokens দিয়ে শুধু নির্দিষ্ট কিছু model ব্যবহার করুক, এটা চাইলে allow-list দেওয়া key নিন। তাহলে সীমাটা আমাদের দিক থেকেই কার্যকর হবে।

### 2. connection যোগ করুন

1. Amp-এ আপনার personal settings খুলে **Model Routing**-এ যান।
2. **Add**-এ ক্লিক করে **Custom URL** বেছে নিন। terminal থেকে করতে চাইলে `amp config model-providers` একই কাজ করে।
3. format আর base URL ঠিক করুন:

| Format                       | Base URL               | Amp request পাঠায়                      |
| ---------------------------- | ---------------------- | --------------------------------------- |
| `chat-completions` (default) | `https://tokens.bd/v1` | `https://tokens.bd/v1/chat/completions` |
| `anthropic-messages`         | `https://tokens.bd`    | `https://tokens.bd/v1/messages`         |

4. আপনার API key দিন: `tok_live_your_key`। Amp এটা `Authorization: Bearer` হিসেবে পাঠায়।

format অনুযায়ী base URL ঠিক দিতে হবে। `chat-completions` নিজে `/chat/completions` জুড়ে নেয়, তাই base-এ `/v1` থাকতে হবে। `anthropic-messages` জোড়ে `/v1/messages`, তাই এখানে `/v1` দেবেন না।

Amp key-টা connection-এর সাথেই রাখে। `TOKENS_API_KEY` সে পড়ে না।

### 3. Amp-এর model-কে Tokens ID-র সাথে মেলান

Amp catalog-এর যে model route করবেন, তার mapping-এ upstream-এ যাওয়া ID বদলে দেওয়া যায়। Amp-এর docs-এ format-টা এই লাইনের মতো দেখানো আছে:

```text
moonshotai/kimi-k3 -> kimi-k3-turbo
```

বাঁ দিকে Amp-এর canonical ID। ডান দিকের ID-টা আপনার connection পায়। Tokens-এর জন্য ডান দিকে Tokens-এর model ID হুবহু বসাতে হবে। Tokens-এর ID-ও `provider/model` আকারের, কিন্তু বানান সবসময় Amp-এর সাথে মেলে না। তাই ঠিক ID [catalog](/models) থেকে দেখে নিন, অথবা এই command চালান:

```bash
curl -s https://tokens.bd/v1/models -H "Authorization: Bearer $TOKENS_API_KEY"
```

## model বদলানো

Amp-এ model বদলানো আগের মতোই: Amp-এর catalog থেকে বেছে নেন। তার মধ্যে কোনগুলো Tokens দিয়ে যাবে, সেটা ঠিক হয় আপনার Model Routing mapping দিয়ে। আরেকটা model route করতে চাইলে তার Amp ID থেকে মানানসই Tokens ID-তে একটা mapping যোগ করুন। Tokens-এ কয়েকটা বিকল্প থাকলে বাছতে সাহায্য করবে [Choosing a model](/docs/choosing-a-model)।

## ঠিকমতো চলছে কিনা দেখুন

আগে key-টা সরাসরি test করুন:

```bash
export TOKENS_API_KEY=tok_live_your_key
curl -s https://tokens.bd/v1/models -H "Authorization: Bearer $TOKENS_API_KEY"
```

তারপর Amp-এর নিজের check চালান। UI-তে connection-এর পাশে **Check Access**-এ ক্লিক করুন। CLI থেকে:

```bash
amp config model-providers test <connection-id>
amp config model-providers check-access --provider-model <provider/model>
```

`<connection-id>`-র জায়গায় আপনার connection-এর ID বসান, আর `<provider/model>`-এর জায়গায় যে Amp catalog ID mapping করেছেন সেটা। শেষে ওই model দিয়ে Amp-এ ছোট একটা কাজ চালান, আর Dashboard-এর usage analytics-এ request-টা এসেছে কিনা দেখুন।

## সমস্যা হলে

**যে model চান সেটা বাছাই করা যাচ্ছে না।** model-টা Amp-এর catalog-এ নেই, আর Model Routing দিয়ে তা যোগ করা যায় না। ওই model-এর জন্য অন্য agent ব্যবহার করুন।

**404 `model_not_found`।** mapping-এর ডান দিকের ID কোনো Tokens ID-র সাথে মিলছে না। `GET /v1/models` থেকে হুবহু copy করে বসান।

**প্রতিটা request-এ 404।** format-এর সাথে base URL মেলেনি। `chat-completions`-এর জন্য `https://tokens.bd/v1` আর `anthropic-messages`-এর জন্য `https://tokens.bd` দিন।

**401 `invalid_api_key`।** key ভুল, revoke করা বা rotate করা। rotate করলে পুরোনো secret সাথে সাথে বন্ধ হয়ে যায়।

**403 `model_not_allowed_on_key` বা `tier_permission_denied`।** key-র allow-list বা আপনার plan-এ mapping করা model-টা নেই।

**429 error।** `Retry-After` দেখুন। প্রতিটা code-এর ব্যাখ্যা [Troubleshooting](/docs/troubleshooting)-এ আছে।

Request-এর format দেখুন [Chat Completions](/docs/chat-completions) আর [Messages](/docs/messages) পাতায়।

Source: [Amp docs, model routing](https://ampcode.com/docs/customize/model-routing), October 2026-এ দেখা।

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