Skip to main content
GET
عرض نماذج البوابة
تعيد نقطة النهاية هذه افتراضيًا النماذج القابلة للتوجيه حاليًا فقط. اضبط availability=all لتضمين النماذج المعروفة غير المتاحة حاليًا. تُخزّن استجابات الكتالوج مؤقتًا لخمس دقائق، وقد تُقدّم لخمس دقائق إضافية أثناء إعادة التحقق من صلاحية التخزين المؤقت. ينطبق ذلك على صيغ JSON وRSS وAtom للكتالوج الحالي؛ أما موجز الإصدارات فله تخزين مؤقت مستقل وأقصر للاستطلاع. GET /models/me مخصص لتصفية مستقبلية للنماذج وفق ضوابط المتصل الحالي. وهو يعيد حاليًا 501 not implemented، لذا استخدم GET /models للوصول إلى كتالوج Gateway المشترك في الوقت الحالي.

عوامل تصفية مفيدة

  • يستخدم endpoints أسماء عامة مثل chat.completions وresponses وmessages
  • يرشح status النماذج حسب دورة حياتها، مثل active أو deprecated أو retired
  • يرشح provider حسب معرّف المزوّد العام، مثل openai أو anthropic أو google_vertex
  • يرشح provider_status حسب مستوى طرح المزوّد، مثل active أو beta أو alpha أو not_ready
  • يرشح provider_routing_status حسب حالة توجيه المزوّد
  • يرشح model_routing_status حسب حالة توجيه النموذج
  • يرشح capability_status حسب حالة إمكانات المزوّد لمطابقة نقطة النهاية المطلوبة
  • يرشح provider_availability_status حسب توفر المزوّد، مثل active أو coming_soon أو inactive
  • يرشح provider_availability_reason حسب سبب توفر المزوّد، مثل preview_only أو provider_not_ready أو gated أو access_limited أو region_limited
  • يرشح organisation حسب بادئة معرّف النموذج العام، مثل anthropic في anthropic/claude-3-haiku
  • القيمة الافتراضية هي availability=active
  • يتضمن availability=all النماذج أو المزوّدين ذوي الحالة coming_soon أو inactive أو غير القابلين للتوجيه للعامة بعد
  • input_modalities اسم بديل لـ input_types
  • output_modalities اسم بديل لـ output_types
  • supported_parameters اسم بديل لـ params
للاطلاع على عقد نقطة النهاية لنموذج واحد، استدعِ GET /models/{author}/{slug}/endpoints. تفصل الاستجابة مسارات المزوّدين وتعرض في كل صف المسار العام والوسائط وتفاصيل المعلمات المدعومة والتوفر وحالة التوجيه واسم النموذج لدى المزوّد وملخص الأسعار. قد تتضمن إدخالات المزوّد أيضًا:
  • availability_status
  • availability_reason
  • provider_status
  • provider_routing_status
  • model_routing_status
  • capability_status

الاستجابة

availability_reason هو الحقل الوحيد الذي يوضح سبب كون إدخال المزوّد نشطًا أو متاحًا للمعاينة فقط أو غير نشط.

التفويضات

Authorization
string
header
مطلوب

المصادقة باستخدام رمز Bearer

معلمات الاستعلام

بحث غير حساس لحالة الأحرف في معرّفات النماذج وأسمائها وأوصافها والمؤسسات.

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

أقصى سعر بالدولار لكل مليون رمز إدخال.

النطاق المطلوب: 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
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,
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[]

التصفية حسب معرّف المزوّد

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.

output_types
string[]

التصفية حسب أنواع الإخراج

output_modalities
string[]

اسم مستعار عام لـ output_types.

params
string[]

التصفية حسب المعلمات

supported_parameters
string[]

اسم مستعار عام لـ params.

availability
enum<string>
افتراضي:active

مرشح التوفر. يعرض active النماذج القابلة للتوجيه علنًا فقط؛ ويشمل all سجلات التوفر غير القابلة للتوجيه.

الخيارات المتاحة:
active,
all
limit
integer
افتراضي:50

تحديد عدد النتائج

النطاق المطلوب: 1 <= x <= 250
offset
integer
افتراضي:0

الإزاحة لأغراض ترقيم الصفحات

النطاق المطلوب: 0 <= x <= 5000
format
enum<string>
افتراضي:json

تنسيق الاستجابة. القيمة الافتراضية هي json.

الخيارات المتاحة:
json,
rss,
atom
feed
enum<string>

اسم مستعار لـ format. يقبل 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[]
مطلوب
آخر تعديل في ٢ أكتوبر ٢٠٢٦