दस्तावेज़ मेनू
संदर्भ
API संदर्भAPI संदर्भ
v1· जुल॰ 2026 में अपडेट किया गया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 उन squads की सूची देता है जिन्हें आपकी कुंजी कॉल कर सकती है। नीचे की कॉन्फ़िग में दिए मॉडल नाम squads हैं, इसलिए वे वैसे ही काम करते हैं।
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 ही रहता है।
- जुल॰ 2026CLI टूल: Claude Code (/v1/messages) और Codex (/v1/responses) सीधे इस्तेमाल करें। जनरेशन के आँकड़े (/v1/generation)।
- जुल॰ 2026ऑडियो: टेक्स्ट-टू-स्पीच (/v1/audio/speech) और स्पीच-टू-टेक्स्ट (/v1/audio/transcriptions, srt/vtt/verbose_json फ़ॉर्मैट के साथ)।
- जून 2026reasoning_effort जोड़ा गया।
- मई 2026Embeddings एंडपॉइंट और JSON मोड (response_format)।
- अप्रैल 2026chat completions पर स्ट्रीमिंग (SSE); प्रदाता पिनिंग।

