ডকস মেনু

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- দিয়ে শুরু হওয়া একটি কী তৈরি করুন — সিক্রেট একবারই দেখানো হয়, তাই নিরাপদ জায়গায় রাখুন।

header
Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxxxxxx
ক্লায়েন্ট-সাইড কোডে কখনো কী প্রকাশ করবেন না। গেটওয়ে নিজের সার্ভার থেকে কল করুন, বা প্রক্সির মাধ্যমে।
API কী তৈরি করুন

দ্রুত শুরু#

আপনার প্রথম 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*stringGET /v1/models থেকে একটি মডেল id (উদাহরণে gpt-5.1)
messages*arrayকথোপকথনের বার্তা (role + content)
streambooleanটোকেন server-sent events হিসেবে ফেরত পাঠায়
temperaturenumberস্যাম্পলিং তাপমাত্রা, 0–2 (ডিফল্ট 1)
max_tokensintegerসর্বোচ্চ কতগুলো টোকেন তৈরি হবে
top_pnumberনিউক্লিয়াস স্যাম্পলিংয়ের সম্ভাব্যতা
toolsarrayমডেল যে ফাংশন/টুল কল করতে পারে তাদের সংজ্ঞা
tool_choicestring | objectটুল বাছাই নির্দিষ্ট বা সীমিত করে
response_formatobjectযেমন JSON মোডের জন্য { "type": "json_object" }
reasoning_effortstringlow · medium · high (রিজনিং মডেল)
stopstring | arrayসর্বোচ্চ 4টি স্টপ সিকোয়েন্স
seedintegerযতটা সম্ভব একই ফল দেওয়া স্যাম্পলিং
providerstringশুধু গেটওয়ের জন্য — অনুরোধ একটি প্রদানকারীতে নির্দিষ্ট করে

* আবশ্যক

স্ট্রিমিং#

টোকেন 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 ব্যবহার করুন।

shell
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-এ), আর প্রতিটি স্তর আপনার পছন্দের মডেলের সঙ্গে যুক্ত হয়।

~/.claude/settings.json
{
  "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" দেওয়ার দরকার নেই।

~/.codex/config.toml
model = "gpt-5.1"
model_provider = "wayjet"

[model_providers.wayjet]
name = "WayJet"
base_url = "https://api.wayjet.ai/v1"
wire_api = "responses"
~/.codex/auth.json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-your-key"
}

Claude Code আর Codex প্রতিটি অনুরোধ সেই একটি মডেলেই পাঠায় যার নাম তারা উল্লেখ করে।

ত্রুটি#

ত্রুটিতে মানক HTTP স্ট্যাটাস কোড আর OpenAI-ধাঁচের কাঠামো ব্যবহার হয়।

json
{
  "error": {
    "message": "Incorrect API key provided.",
    "type": "authentication_error",
    "code": null,
    "param": null
  }
}
স্ট্যাটাসধরনঅর্থ
200OKঅনুরোধ সফল হয়েছে
400invalid_request_errorঅনুরোধ ভুলভাবে গঠিত বা প্যারামিটার অবৈধ
401authentication_errorAPI কী নেই, অবৈধ বা বাতিল করা হয়েছে
403permission_errorএই কী-র এই কাজটি করার অনুমতি নেই
404not_found_errorঅজানা মডেল বা রিসোর্স
429rate_limit_errorরেট লিমিট ছুঁয়েছে, বা বাজেট পেরিয়ে গেছে
500api_errorগেটওয়েতে অপ্রত্যাশিত ত্রুটি
আপনার ব্যবহার ও সীমা দেখুন

এন্ডপয়েন্ট#

যে এন্ডপয়েন্টগুলো API কী দিয়ে কল করা যায়। কী, ব্যবহার আর বাজেট ড্যাশবোর্ড থেকে পরিচালনা করা হয়।

মেথডএন্ডপয়েন্টবিবরণ
POST/v1/chat/completionsChat completion (স্ট্রিমিং ও স্ট্রিমিং ছাড়া)
POST/v1/messagesAnthropic Messages ফরম্যাট (স্ট্রিমিং ও স্ট্রিমিং ছাড়া; x-api-key বা Bearer)
POST/v1/responsesOpenAI Responses ফরম্যাট (স্ট্রিমিং ও স্ট্রিমিং ছাড়া)। স্টেটলেস: previous_response_id উপেক্ষা করা হয়, তাই প্রতিবার পুরো কথোপকথন পাঠান
GET/v1/generationএকটি অনুরোধের খরচ ও টোকেন, তার X-Wayjet-Request-Id দিয়ে (?id=)
POST/v1/embeddingsEmbeddings তৈরি করুন
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); প্রোভাইডার পিনিং।
পুরো পরিবর্তন লগ