मुख्य सामग्री पर जाएं
GET
गेटवे मॉडल की सूची बनाएँ
जिन मॉडलों पर आप अभी रूट कर सकते हैं, उनकी सूची के लिए GET /v1/models कॉल करें। जो मॉडल ज्ञात हैं लेकिन अभी उपलब्ध नहीं हैं, उन्हें भी शामिल करने के लिए availability=all सेट करें।
हर मॉडल offers में हर प्रदाता रूट के लिए एक प्रविष्टि दिखाता है (संक्षिप्त, मान उदाहरण के लिए):
प्रोडक्शन ट्रैफ़िक सिर्फ़ उसी ऑफ़र पर रूट करें जिसका routable true हो। status_reason बताता है कि कोई ऑफ़र सिर्फ़ पूर्वावलोकन या निष्क्रिय क्यों है। पूरी स्कीमा नीचे है। GET /models/me वही सूची आपकी कुंजी के गार्डरेल लागू करके लौटाता है: आपके वर्कस्पेस के गोपनीयता और प्रदाता नियम, और कुंजी के विभागों, उसके सदस्य और स्वयं कुंजी पर लगे गार्डरेल। जिन मॉडलों को कोई मॉडल नियम रोकता है, और जिनका कोई अनुमत प्रदाता नहीं है, वे शामिल नहीं होते, और हर मॉडल में केवल वे ऑफ़र रहते हैं जिन तक उसके अनुरोध भेजे जा सकते हैं। यह GET /models वाले ही फ़िल्टर लेता है। प्रतिक्रिया में access भी होता है: क्या कोई नियम लागू है (restricted), नियम किन मॉडलों को बाहर रखते हैं (hidden_model_count और hidden_models, आईडी और नामों के साथ) और सूचीबद्ध कितने मॉडलों के कुछ प्रदाता हट गए (limited_model_count), ताकि आप बता सकें कि कोई मॉडल क्यों नहीं दिख रहा।

सूची फ़िल्टर करें

जो फ़िल्टर कई मान लेते हैं, वे दोहराए गए पैरामीटर या कॉमा से अलग की गई सूची स्वीकार करते हैं। किसी एक मॉडल के प्रदाता रूट, पैरामीटर विवरण और कीमतें देखने के लिए GET /models/{author}/{slug}/endpoints कॉल करें।

हर ऑफ़र के सर्विस टियर जांचें

offers की हर प्रविष्टि में service_tiers होता है, यानी वे सर्विस टियर जिन्हें वह प्रदाता ऑफ़र स्वीकार करता है। यह flex, priority, standard और ultrafast का वर्णानुक्रम में क्रमबद्ध उपसमूह है, जिसमें priority Fast टियर है। कोई टियर तब सूचीबद्ध होता है जब प्रदाता रूट के पास उसके लिए सक्रिय, अभी प्रभावी कीमतें हों, और जो रूट एक ही टियर देता है वह सिर्फ़ वही टियर सूचीबद्ध करता है। कुछ टियर अलग टियर-विशिष्ट प्रदाता रूट से भी उपलब्ध होते हैं, जो सूचीबद्ध नहीं होते। pricing के अंतर्गत कीमतें standard टियर की कीमतें ही रहती हैं।

सूची OpenAI फ़ॉर्मैट में पाएं

जो क्लाइंट OpenAI की model-list प्रतिक्रिया की अपेक्षा करते हैं, उनके लिए GET /v1/models?format=openai का उपयोग करें। डिफ़ॉल्ट format=json Phaseo का ज़्यादा विस्तृत मॉडल मेटाडेटा लौटाता है।
OpenAI फ़ॉर्मैट नेटिव JSON वाला ही प्रमाणीकरण, क्षेत्रीय उपलब्धता, वर्कस्पेस के निजी मॉडल और फ़िल्टर इस्तेमाल करता है। जब तक आप limit न दें, यह सभी मेल खाने वाले मॉडल लौटाता है; offset फिर भी लागू होता है। इन्फ़रेंस के लिए ID Phaseo के मानक रूप में ही रहते हैं। created कैटलॉग की रिलीज़ तारीख इस्तेमाल करता है, या अज्ञात होने पर 0; owned_by कैटलॉग का संगठन, वर्कस्पेस मॉडलों के लिए private, या अज्ञात होने पर phaseo इस्तेमाल करता है।

मॉडल सूची कैश करें

कैटलॉग प्रतिक्रियाएं पांच मिनट के लिए कैश होती हैं, और कैश के पुनः सत्यापन के दौरान अगले पांच मिनट तक भी दी जा सकती हैं। यह मौजूदा कैटलॉग के JSON, RSS और Atom रूपों पर लागू होता है; रिलीज़ फ़ीड का अपना छोटा पोलिंग कैश है। JSON और OpenAI-फ़ॉर्मैट प्रतिक्रियाओं में एक weak ETag हेडर (W/"…") होता है। यह तब बदलता है जब पेज के मॉडल, limit, offset, total या फ़ॉर्मैट बदलते हैं। यह gateway_region को अनदेखा करता है, इसलिए किसी दूसरे क्षेत्र से दिए गए उसी कैटलॉग का ETag भी वही होता है। इसी कारण यह weak है: जिन प्रतिक्रियाओं का यह साझा है वे समान हैं, लेकिन उनके बाइट अलग हो सकते हैं। RSS, Atom और त्रुटि प्रतिक्रियाओं में यह नहीं होता। सहेजा गया मान बिना बदले If-None-Match में वापस भेजें। अगर कैटलॉग नहीं बदला है, तो प्रतिक्रिया बिना बॉडी के 304 Not Modified होती है और ETag, Cache-Control और Vary हेडर दोहराती है। वरना आपको नई सूची और नए ETag के साथ सामान्य 200 मिलता है। If-None-Match कॉमा से अलग की गई सूची और * भी स्वीकार करता है, और तुलना weak होती है, इसलिए मान W/ प्रीफ़िक्स के साथ या बिना, दोनों तरह मेल खाता है।
304 ट्रांसफ़र और पार्सिंग बचाता है। सर्वर फिर भी अनुरोध का मूल्यांकन करता है: वह कैटलॉग लोड करता है और ETag दोबारा निकालता है। लगभग हर 15 मिनट में पोल करना काफ़ी है, और सूची सिर्फ़ तब दोबारा डाउनलोड होती है जब कैटलॉग बदलता है। हर अनुरोध URL के लिए एक ETag रखें, क्योंकि हर पेज, फ़िल्टर सेट और फ़ॉर्मैट का अपना मान होता है।

प्राधिकरण

Authorization
string
header
आवश्यक

Bearer टोकन से प्रमाणीकरण

हेडर

If-None-Match
string

उसी URL के लिए पिछली JSON या OpenAI प्रारूप वाली प्रतिक्रिया का ETag। अगर यह अब भी मेल खाता है, तो प्रतिक्रिया बिना बॉडी के 304 Not Modified होती है। कॉमा से अलग की गई सूची, कमज़ोर (W/) वैलिडेटर और * स्वीकार करता है।

क्वेरी पैरामीटर

मॉडल ID, नाम, विवरण और संगठनों में बड़े-छोटे अक्षरों का भेद किए बिना खोजें।

Maximum string length: 200

प्रदाता या मॉडल संगठन में बड़े-छोटे अक्षरों का भेद किए बिना खोजें।

Maximum string length: 100
input_modality
enum<string>

समर्थित इनपुट मोडैलिटी आवश्यक करें।

उपलब्ध विकल्प:
text,
image,
audio,
video
minimum_context_tokens
number

कम से कम इतने इनपुट संदर्भ टोकन आवश्यक करें।

आवश्यक सीमा: x >= 0
maximum_input_price_per_million
number

प्रति दस लाख इनपुट टोकन अधिकतम मूल्य (USD)।

आवश्यक सीमा: x >= 0
gateway_available_only
boolean
डिफ़ॉल्ट:false

केवल वे मॉडल लौटाएँ जिनका कम से कम एक रूट करने योग्य गेटवे ऑफ़र हो।

sort_by
enum<string>
डिफ़ॉल्ट:relevance

मॉडल खोज परिणामों को क्रमबद्ध करने वाला फ़ील्ड।

उपलब्ध विकल्प:
relevance,
input_price,
output_price,
context_length,
provider_count
sort_order
enum<string>

वैकल्पिक क्रम दिशा। मूल्य डिफ़ॉल्ट रूप से बढ़ते क्रम में और अन्य संख्याएँ घटते क्रम में होती हैं।

उपलब्ध विकल्प:
asc,
desc
include
enum<string>[]

हर ऑफ़र के अनुरोध पैरामीटर मानक रूप में जोड़ने के लिए parameter_specs सेट करें।

उपलब्ध विकल्प:
parameter_specs
endpoints
string[]

एंडपॉइंट के अनुसार फ़िल्टर करें

organisation

संगठन के अनुसार फ़िल्टर करें संगठन पहचानकर्ता।

उपलब्ध विकल्प:
01-ai,
adept,
ai21,
aion-labs,
aisingapore,
alibaba,
allenai,
amazon,
anthracite-org,
anthropic,
arcee-ai,
baai,
baichuan,
baidu,
bigcode,
black-forest-labs,
bytedance,
bytedance-seed,
cogito,
cognitivecomputations,
cohere,
crofai,
cursor,
cyfragovpl,
databricks,
dealignai,
decart,
deepseek,
dots-studio,
early-access,
eleven-labs,
essential-ai,
fastino,
fish-audio,
github,
google,
gryphe,
hexgrad,
ibm,
ibm-granite,
inception,
inclusionai,
inference-net,
inflection,
intfloat,
jetbrains,
kblab,
kling,
kuaishou,
kwaipilot,
kwaivgi,
lg,
lightricks,
liquid-ai,
mancer,
medaibase,
meituan,
meta,
microsoft,
mindai,
minimax,
mistral,
mistralai,
moonshotai,
morph,
naver-hyperclova,
near-ai,
nex-agi,
nous,
nousresearch,
novasearch,
nvidia,
openai,
openbmb,
opencompass,
opengvlab,
orcarouter,
ornith,
perceptron,
perplexity,
phala,
pixverse,
poe,
poolside,
prime-intellect,
prism-ml,
qwen,
reka,
relace,
runway,
sakana,
sao10k,
sapiens-ai,
sentence-transformers,
sference,
shanghai-ai-laboratory,
shengshu-ai,
snowflake,
sourceful,
spacex-ai,
speakleash,
stability-ai,
stealth,
stepfun,
suno,
tencent,
thedrummer,
thinking-machines,
undi95,
upstage,
venice,
vercel,
villanova-ai,
voyage,
windsurf,
writer,
xai,
xgenerationlab,
xiaomi,
z-ai,
zyphra
provider
string[]

प्रदाता ID के अनुसार फ़िल्टर करें

provider_status
string[]

प्रदाता रोलआउट स्थिति के अनुसार फ़िल्टर करें

provider_routing_status
string[]

प्रदाता रूटिंग स्थिति के अनुसार फ़िल्टर करें

model_routing_status
string[]

मॉडल रूटिंग स्थिति के अनुसार फ़िल्टर करें

capability_status
string[]

प्रदाता क्षमता स्थिति के अनुसार फ़िल्टर करें

provider_availability_status
string[]

प्रदाता उपलब्धता स्थिति के अनुसार फ़िल्टर करें

provider_availability_reason
string[]

प्रदाता उपलब्धता कारण के अनुसार फ़िल्टर करें

status
string[]

मॉडल स्थिति के अनुसार फ़िल्टर करें

input_types
string[]

इनपुट प्रकारों के अनुसार फ़िल्टर करें

input_modalities
string[]

input_types के लिए सार्वजनिक alias।

output_types
string[]

आउटपुट प्रकारों के अनुसार फ़िल्टर करें

output_modalities
string[]

output_types के लिए सार्वजनिक alias।

params
string[]

पैरामीटर के अनुसार फ़िल्टर करें

supported_parameters
string[]

params के लिए सार्वजनिक alias।

availability
enum<string>
डिफ़ॉल्ट:active

उपलब्धता फ़िल्टर। active केवल सार्वजनिक रूप से रूट किए जा सकने वाले मॉडल लौटाता है; all में रूट न किए जा सकने वाले उपलब्धता रिकॉर्ड भी शामिल हैं।

उपलब्ध विकल्प:
active,
all
limit
integer
डिफ़ॉल्ट:50

परिणामों की संख्या सीमित करें

आवश्यक सीमा: 1 <= x <= 250
offset
integer
डिफ़ॉल्ट:0

पेजिनेशन के लिए ऑफ़सेट

आवश्यक सीमा: 0 <= x <= 5000
format
enum<string>
डिफ़ॉल्ट:json

प्रतिक्रिया का प्रारूप। डिफ़ॉल्ट Phaseo का मूल JSON है। limit न दिए जाने पर OpenAI प्रारूप पूरी फ़िल्टर की गई सूची लौटाता है।

उपलब्ध विकल्प:
json,
openai,
rss,
atom
feed
enum<string>

format का alias। json, rss या atom स्वीकार करता है।

उपलब्ध विकल्प:
json,
rss,
atom

प्रतिक्रिया

मॉडल की सूची

ok
boolean
आवश्यक
उदाहरण:

true

availability_mode
enum<string>
आवश्यक
उपलब्ध विकल्प:
active,
all
उदाहरण:

"active"

limit
integer
आवश्यक
आवश्यक सीमा: 1 <= x <= 250
उदाहरण:

50

offset
integer
आवश्यक
आवश्यक सीमा: 0 <= x <= 5000
उदाहरण:

0

total
integer
आवश्यक
आवश्यक सीमा: x >= 0
उदाहरण:

128

models
object[]
आवश्यक
access
object

केवल /models/me लौटाता है: कॉल करने वाले के गार्डरेल ने खोज और पेजिंग से पहले सूची से क्या बाहर रखा।

अंतिम संशोधन 16 नवंबर 2026