ডকস মেনু
রেফারেন্স
API রেফারেন্সAPI রেফারেন্স
v1· জুল ২০২৬-এ হালনাগাদ160+টি মডেল · 12টি মডেল পরিবার
WayJet একটি OpenAI-সামঞ্জস্যপূর্ণ গেটওয়ে। যেকোনো OpenAI SDK নিচের বেস URL-এ দিন, একটি sk- API কী ব্যবহার করুন, আর একটি API দিয়েই সব প্রদানকারীকে কল করুন।
12টি মডেল পরিবার
OpenAI, Anthropic, Gemini, Groq ও আরও অনেক কিছু, একটি API-এর পেছনে।
OpenAI-সামঞ্জস্যপূর্ণ
যেকোনো OpenAI SDK বেস URL-এ দিন — কোড বদলাতে হবে না।
স্ট্রিমিং
chat completions-এ টোকেন ধরে ধরে SSE, শুরু থেকেই।
কী ও বাজেট
সীমিত অনুমতির কী, সময়কাল অনুযায়ী খরচের সীমা আর ব্যবহারের হিসাব।
গেটওয়ে আপনাকে কোন মডেলগুলো দেয় দেখতে নিজের কী দিয়ে GET /v1/models কল করুন।
পরিচিতি#
প্রতিটি অনুরোধ একটি বেস URL-এ যায়। গেটওয়ে OpenAI-এর ফরম্যাটে কথা বলে, তাই আপনার এখনকার SDK আর টুল কোনো পরিবর্তন ছাড়াই কাজ করে — শুধু বেস URL আর কী বদলাতে হয়।
https://api.wayjet.ai/v1প্রমাণীকরণ#
Authorization হেডারে bearer টোকেন দিয়ে প্রমাণীকরণ করুন। API কী পেজে sk- দিয়ে শুরু হওয়া একটি কী তৈরি করুন — সিক্রেট একবারই দেখানো হয়, তাই নিরাপদ জায়গায় রাখুন।
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
দ্রুত শুরু#
আপনার প্রথম chat completion পাঠান। WAYJET_API_KEY-এ আপনার API কী দিন আর যেমন আছে চালান, অথবা gpt-5.1-এর জায়গায় GET /v1/models-এর যেকোনো মডেল id দিন — এটি আপনার কী যে মডেলগুলো কল করতে পারে তার তালিকা দেয়।
curl https://api.wayjet.ai/v1/chat/completions \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.1",
"messages": [{"role": "user", "content": "Hello"}]
}'Chat completions#
POST /v1/chat/completions — মূল এন্ডপয়েন্ট। অনুরোধ আর উত্তর OpenAI-এর স্কিমা মেনে চলে; গেটওয়ে উত্তরে provider আর cache_status যোগ করে।
| প্যারামিটার | ধরন | বিবরণ |
|---|---|---|
| model* | string | GET /v1/models থেকে একটি মডেল id (উদাহরণে gpt-5.1) |
| messages* | array | কথোপকথনের বার্তা (role + content) |
| stream | boolean | টোকেন server-sent events হিসেবে ফেরত পাঠায় |
| temperature | number | স্যাম্পলিং তাপমাত্রা, 0–2 (ডিফল্ট 1) |
| max_tokens | integer | সর্বোচ্চ কতগুলো টোকেন তৈরি হবে |
| top_p | number | নিউক্লিয়াস স্যাম্পলিংয়ের সম্ভাব্যতা |
| tools | array | মডেল যে ফাংশন/টুল কল করতে পারে তাদের সংজ্ঞা |
| tool_choice | string | object | টুল বাছাই নির্দিষ্ট বা সীমিত করে |
| response_format | object | যেমন JSON মোডের জন্য { "type": "json_object" } |
| reasoning_effort | string | low · medium · high (রিজনিং মডেল) |
| stop | string | array | সর্বোচ্চ 4টি স্টপ সিকোয়েন্স |
| seed | integer | যতটা সম্ভব একই ফল দেওয়া স্যাম্পলিং |
| provider | string | শুধু গেটওয়ের জন্য — অনুরোধ একটি প্রদানকারীতে নির্দিষ্ট করে |
* আবশ্যক
স্ট্রিমিং#
টোকেন server-sent events হিসেবে পেতে stream: true দিন। প্রতিটি ইভেন্ট একটি ডেল্টাসহ data: লাইন; স্ট্রিম শেষ হয় data: [DONE] দিয়ে।
curl https://api.wayjet.ai/v1/chat/completions \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.1",
"messages": [{"role": "user", "content": "Hello"}],
"stream": true
}'
# → server-sent events: lines of data: {...} terminated by data: [DONE]প্রম্পট ক্যাশিং#
কিছু প্রদানকারী সম্প্রতি দেখা প্রম্পটের শুরুর অংশ ক্যাশ করে রাখে এবং আবার প্রক্রিয়া করতে কম টাকা নেয়। OpenAI, Gemini আর DeepSeek-এ এটি স্বয়ংক্রিয়ভাবে হয়: আপনার কোনো প্যারামিটার লাগে না, আর আপনি বা WayJet কেউই এটি বন্ধ করতে পারেন না। Anthropic শুধু তখনই ক্যাশ করে যখন অনুরোধে বলা থাকে।
প্ল্যাটফর্ম কী-তে WayJet শুধু সেই অ্যাকাউন্টগুলোর জন্য `cache_control` মানে, যেগুলো নিজস্ব Anthropic ওয়ার্কস্পেসে নির্দিষ্ট। অন্য ক্ষেত্রে মার্কারটি গ্রহণ করা হয় এবং অনুরোধ Anthropic-এ পৌঁছানোর আগেই সরিয়ে ফেলা হয়। কল তবুও সফল হয়, কিন্তু এর usage-এ কোনো ক্যাশ টোকেন থাকে না এবং প্রতিটি ইনপুট টোকেন পূর্ণ ইনপুট দরে বিল হয় — Anthropic-ও এর জন্য এটাই নেয়। নিজের Anthropic কী দিলে মার্কারটি সবসময় যায়।
প্রতিটি প্রদানকারী ক্যাশের সীমা টানে তার নিজের গ্রাহকের ওপর। WayJet প্ল্যাটফর্ম কী-তে সেই গ্রাহক হলো WayJet — তাই তিনটি স্বয়ংক্রিয় প্রদানকারীতে আপনার অনুরোধ নিচের সময়সীমা পর্যন্ত অন্য WayJet অ্যাকাউন্টের সঙ্গে একটি ক্যাশ স্পেস ভাগ করে। গেটওয়ে chat completions-এ cache_status ফেরত দেয়, কিন্তু এটি শুধু বলে কোনো প্রিফিক্স আবার ব্যবহার হয়েছে কি না, সেটি কার ছিল তা নয়।
| প্রদানকারী | ক্যাশিং | ক্যাশের সীমা | পুনর্ব্যবহারের সময়সীমা |
|---|---|---|---|
| OpenAI | স্বয়ংক্রিয় | সংস্থা — প্ল্যাটফর্ম কী-তে WayJet-এর | 30 মিনিট পর্যন্ত |
| Gemini | স্বয়ংক্রিয় | Google Cloud প্রজেক্ট — প্ল্যাটফর্ম কী-তে WayJet-এর | 24 ঘণ্টা পর্যন্ত |
| DeepSeek | স্বয়ংক্রিয় | অ্যাকাউন্ট — প্ল্যাটফর্ম কী-তে WayJet-এর | কয়েক ঘণ্টা থেকে কয়েক দিন |
| Anthropic | অনুরোধে (cache_control), নিজের কী বা নির্দিষ্ট অ্যাকাউন্ট দিয়ে | আপনার নিজের অ্যাকাউন্ট (BYOK) বা আপনার নির্দিষ্ট ওয়ার্কস্পেস | 5 মিনিট |
| Bedrock / Vertex-এ Claude | অনুরোধে, শুধু নিজের ক্রেডেনশিয়ালে | AWS অ্যাকাউন্ট / GCP প্রজেক্ট | 5 মিনিট |
শেয়ার করা ক্যাশের মানে কী, আর কী নয়
প্রম্পট ক্যাশের মধ্য দিয়ে কোনো প্রম্পট বা উত্তরের বিষয়বস্তু অন্য কারও কাছে যায় না। ক্যাশ হিট মানে প্রদানকারী কম খরচে সেই প্রিফিক্সটি আবার প্রক্রিয়া করছে, যা কলকারী নিজেই আগে পাঠিয়েছিল — এটি কারও লেখা অন্য কাউকে দেয় না। শেয়ার করা স্পেস যা প্রকাশ করে তা হলো সময়: যার কাছে আগে থেকেই হুবহু একটি প্রিফিক্স আছে, সে তাত্ত্বিকভাবে দ্রুত বা সস্তা উত্তর দেখে বুঝতে পারে যে এটি সম্প্রতি পাঠানো হয়েছে। এর জন্য তাকে আগে প্রিফিক্সটি জানতে হবে, আর সেটাই ঝুঁকির সীমা।
আমরা এটি প্রকাশ করছি কারণ আপনি নিজে এটি দেখতে পারেন না। কোন প্রদানকারী অনুরোধটি পূরণ করেছে, WayJet তা ইচ্ছাকৃতভাবে লুকিয়ে রাখে, তাই API বা ড্যাশবোর্ডের কিছুই আপনাকে বলবে না প্রদানকারীর ক্যাশের সীমা কোথায়। আপনি যদি নিজের ব্যবহারকারীদের কাছে ইনফারেন্স বিক্রি করেন, তাহলে এক ধাপ নিচে একই প্রশ্নের উত্তর এটাই।
যদি আপনার নিজস্ব ক্যাশ স্পেস দরকার হয়
দুটি পথ আছে, আর এই দুটিই সৎ পথ — প্ল্যাটফর্ম কী-তে প্রতি গ্রাহকের জন্য এমন কোনো সেটিং নেই যা এটি করতে পারে:
- নিজের কী আনুন। নিজের প্রদানকারীর ক্রেডেনশিয়াল যোগ করুন, তাহলে আপনার ট্রাফিক প্রদানকারীর কাছে আপনার অ্যাকাউন্টে চলবে, আর ক্যাশের সীমা টানা হবে আপনার ওপর। এটি সব প্রদানকারীতে কাজ করে এবং পূর্ণ সমাধান।
- একটি Anthropic ওয়ার্কস্পেস চান। শুধু Anthropic-এর জন্য, আমরা আপনার অ্যাকাউন্টকে তার নিজস্ব Anthropic ওয়ার্কস্পেসে নির্দিষ্ট করতে পারি, ফলে প্ল্যাটফর্ম কী ব্যবহার করেও আপনার প্রম্পট ক্যাশ শুধু আপনার থাকবে। এটি অনুরোধে এবং প্রতিটি অ্যাকাউন্টের জন্য আলাদাভাবে চালু হয় — নিজে চালু করার কোনো সুইচ নেই, এবং এটি Bedrock বা Vertex দিয়ে চলা Claude-এ প্রযোজ্য নয়, কারণ সেখানে এমন কিছু নেই। প্ল্যাটফর্ম কী-র অ্যাকাউন্টে Anthropic ক্যাশিং চালু করার উপায়ও এটাই।
Embeddings#
POST /v1/embeddings — সার্চ আর RAG-এর জন্য টেক্সটকে ভেক্টরে রূপান্তর করে। একটি স্ট্রিং বা স্ট্রিংয়ের অ্যারে নেয়।
curl https://api.wayjet.ai/v1/embeddings \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-embedding-model",
"input": "The quick brown fox"
}'অডিও (স্পিচ)#
POST /v1/audio/speech টেক্সটকে কথায় রূপান্তর করে (প্রতি ইনপুট অক্ষরে বিল), আর POST /v1/audio/transcriptions আপলোড করা অডিও ফাইলকে টেক্সটে রূপান্তর করে (প্রতি অডিও-মিনিটে বিল)। দুটোই OpenAI-সামঞ্জস্যপূর্ণ।
টেক্সট-টু-স্পিচ
curl https://api.wayjet.ai/v1/audio/speech \
-H "Authorization: Bearer $WAYJET_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "your-tts-model",
"input": "The quick brown fox jumped over the lazy dog.",
"voice": "alloy"
}' \
--output speech.mp3স্পিচ-টু-টেক্সট
ফাইলটি multipart/form-data হিসেবে আপলোড করুন। সাধারণ টেক্সটের বদলে টাইমস্ট্যাম্পসহ সাবটাইটেল পেতে response_format-এ srt, vtt বা verbose_json দিন।
curl https://api.wayjet.ai/v1/audio/transcriptions \ -H "Authorization: Bearer $WAYJET_API_KEY" \ -F "model=your-stt-model" \ -F "file=@audio.mp3" \ -F "response_format=json" # json (default) · text · srt · vtt · verbose_json
মডেল#
GET /v1/models আপনার কী-র জন্য উপলব্ধ ক্যাটালগ ফেরত দেয়, প্রতিটি মডেলের দাম আর সক্ষমতাসহ। এই পেজের প্রতিটি উদাহরণে model হিসেবে এই তালিকার একটি id ব্যবহার করুন।
curl https://api.wayjet.ai/v1/models \ -H "Authorization: Bearer $WAYJET_API_KEY"
CLI টুল (Claude Code, Codex)#
গেটওয়ে Anthropic Messages API (POST /v1/messages) আর OpenAI Responses API (POST /v1/responses) দুটোই বোঝে, তাই জনপ্রিয় কোডিং CLI সরাসরি WayJet-এ যুক্ত হয় এবং আপনার নিজের কী দিয়ে বিল হয় — কোনো প্রক্সি বা প্রতিটি প্রদানকারীর আলাদা SDK লাগে না। প্রতিটি টুলকে এমন মডেলে দিন যেটি আপনি কল করতে পারেন।
squad কী?
squad হলো যে মডেলের নাম ধরে আপনি কল করেন: গেটওয়েতে একটি নামযুক্ত প্রোডাক্ট, যা নিজের নামেই উত্তর দেয়। যেখানে মডেলের নাম দিতে হয়, সেখানে squad-এর নাম দিন। GET /v1/models আপনার কী যে squad-গুলো কল করতে পারে তার তালিকা দেয়। নিচের কনফিগের মডেল নামগুলো squad, তাই যেমন আছে তেমনই কাজ করে।
Claude Code
~/.claude/settings.json-এ যোগ করুন। কী যায় ANTHROPIC_AUTH_TOKEN-এ (অথবা x-api-key হেডার হিসেবে ANTHROPIC_API_KEY-এ), আর প্রতিটি স্তর আপনার পছন্দের মডেলের সঙ্গে যুক্ত হয়।
{
"hasCompletedOnboarding": true,
"env": {
"ANTHROPIC_BASE_URL": "https://api.wayjet.ai",
"ANTHROPIC_AUTH_TOKEN": "sk-your-key",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5-20251001"
}
}Codex
Codex ডিফল্টভাবে OpenAI Responses API ব্যবহার করে — wire_api = "chat" দেওয়ার দরকার নেই।
model = "gpt-5.1" model_provider = "wayjet" [model_providers.wayjet] name = "WayJet" base_url = "https://api.wayjet.ai/v1" wire_api = "responses"
{
"auth_mode": "apikey",
"OPENAI_API_KEY": "sk-your-key"
}Claude Code আর Codex প্রতিটি অনুরোধ সেই একটি মডেলেই পাঠায় যার নাম তারা উল্লেখ করে।
ত্রুটি#
ত্রুটিতে মানক HTTP স্ট্যাটাস কোড আর OpenAI-ধাঁচের কাঠামো ব্যবহার হয়।
{
"error": {
"message": "Incorrect API key provided.",
"type": "authentication_error",
"code": null,
"param": null
}
}| স্ট্যাটাস | ধরন | অর্থ |
|---|---|---|
| 200 | OK | অনুরোধ সফল হয়েছে |
| 400 | invalid_request_error | অনুরোধ ভুলভাবে গঠিত বা প্যারামিটার অবৈধ |
| 401 | authentication_error | API কী নেই, অবৈধ বা বাতিল করা হয়েছে |
| 403 | permission_error | এই কী-র এই কাজটি করার অনুমতি নেই |
| 404 | not_found_error | অজানা মডেল বা রিসোর্স |
| 429 | rate_limit_error | রেট লিমিট ছুঁয়েছে, বা বাজেট পেরিয়ে গেছে |
| 500 | api_error | গেটওয়েতে অপ্রত্যাশিত ত্রুটি |
এন্ডপয়েন্ট#
যে এন্ডপয়েন্টগুলো API কী দিয়ে কল করা যায়। কী, ব্যবহার আর বাজেট ড্যাশবোর্ড থেকে পরিচালনা করা হয়।
| মেথড | এন্ডপয়েন্ট | বিবরণ |
|---|---|---|
| POST | /v1/chat/completions | Chat completion (স্ট্রিমিং ও স্ট্রিমিং ছাড়া) |
| POST | /v1/messages | Anthropic Messages ফরম্যাট (স্ট্রিমিং ও স্ট্রিমিং ছাড়া; x-api-key বা Bearer) |
| POST | /v1/responses | OpenAI Responses ফরম্যাট (স্ট্রিমিং ও স্ট্রিমিং ছাড়া)। স্টেটলেস: previous_response_id উপেক্ষা করা হয়, তাই প্রতিবার পুরো কথোপকথন পাঠান |
| GET | /v1/generation | একটি অনুরোধের খরচ ও টোকেন, তার X-Wayjet-Request-Id দিয়ে (?id=) |
| POST | /v1/embeddings | Embeddings তৈরি করুন |
| POST | /v1/audio/speech | টেক্সট-টু-স্পিচ (অডিও আউটপুট) |
| POST | /v1/audio/transcriptions | স্পিচ-টু-টেক্সট (ট্রান্সক্রিপশন) |
| GET | /v1/models | উপলব্ধ মডেলের তালিকা |
পরিবর্তন লগ#
পাবলিক API-এর উল্লেখযোগ্য পরিবর্তন। পুরোনো কোডের সঙ্গে মিল রাখতে বেস URL /v1-ই থাকে।
- জুল ২০২৬CLI টুল: Claude Code (/v1/messages) আর Codex (/v1/responses) সরাসরি ব্যবহার করুন। জেনারেশনের পরিসংখ্যান (/v1/generation)।
- জুল ২০২৬অডিও: টেক্সট-টু-স্পিচ (/v1/audio/speech) আর স্পিচ-টু-টেক্সট (/v1/audio/transcriptions, srt/vtt/verbose_json ফরম্যাটসহ)।
- জুন ২০২৬reasoning_effort যোগ হয়েছে।
- মে ২০২৬Embeddings এন্ডপয়েন্ট আর JSON মোড (response_format)।
- এপ্রি ২০২৬chat completions-এ স্ট্রিমিং (SSE); প্রোভাইডার পিনিং।

