الانتقال إلى المحتوى الرئيسي
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 أسعار الفئة القياسية.

احصل على القائمة بتنسيق OpenAI

استخدم GET /v1/models?format=openai للعملاء التي تتوقع استجابة قائمة النماذج الخاصة بـ OpenAI. تُرجع القيمة الافتراضية format=json البيانات الوصفية الأغنى للنماذج في Phaseo.
يستخدم تنسيق OpenAI المصادقة نفسها والتوفر الإقليمي نفسه والنماذج الخاصة بمساحة العمل والمرشحات نفسها كما في JSON الأصلي. يُرجع كل النماذج المطابقة ما لم تقدّم limit؛ ويظل offset ساريًا. تبقى المعرّفات بصيغة Phaseo القياسية للاستدلال. يستخدم created تاريخ الإصدار في الفهرس، أو 0 عندما يكون غير معروف؛ ويستخدم owned_by المؤسسة في الفهرس، أو private لنماذج مساحة العمل، أو phaseo عندما تكون غير معروفة.

خزّن قائمة النماذج مؤقتًا

تُخزَّن استجابات الفهرس مؤقتًا لمدة خمس دقائق، وقد تُقدَّم لخمس دقائق أخرى أثناء إعادة التحقق من الذاكرة المؤقتة. ينطبق هذا على تمثيلات JSON وRSS وAtom للفهرس الحالي؛ أما موجز الإصدارات فله ذاكرة استطلاع مؤقتة خاصة أقصر. تتضمن استجابات JSON وتنسيق OpenAI ترويسة ETag ضعيفة (W/"…"). تتغير عندما تتغير النماذج في الصفحة أو limit أو offset أو total أو التنسيق. وتتجاهل gateway_region، لذا يحمل الفهرس نفسه المقدَّم من منطقة أخرى قيمة ETag نفسها. لهذا هي ضعيفة: الاستجابات التي تتشاركها متكافئة، لكن بايتاتها قد تختلف. لا تتضمنها استجابات RSS وAtom والأخطاء. أعد إرسال القيمة المحفوظة دون تغيير في If-None-Match. إذا لم يتغير الفهرس، تكون الاستجابة 304 Not Modified بلا جسم، وتكرر ترويسات ETag وCache-Control وVary. وإلا فستحصل على 200 عادية مع القائمة الجديدة وETag جديدة. يقبل If-None-Match أيضًا قائمة مفصولة بفواصل و*، والمقارنة ضعيفة، لذا تتطابق القيمة مع البادئة W/ أو بدونها.
توفّر الاستجابة 304 النقل والتحليل. ومع ذلك يقيّم الخادم الطلب: فهو يحمّل الفهرس ويعيد حساب ETag. الاستطلاع كل 15 دقيقة تقريبًا كافٍ، مع تنزيل القائمة مجددًا فقط عندما يتغير الفهرس. احتفظ بقيمة ETag واحدة لكل عنوان URL للطلب، لأن لكل صفحة ومجموعة مرشحات وتنسيق قيمته الخاصة.

التفويضات

Authorization
string
header
مطلوب

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

الترويسات

If-None-Match
string

قيمة ETag من استجابة سابقة بتنسيق JSON أو OpenAI لعنوان URL نفسه. إذا كانت لا تزال مطابقة، تكون الاستجابة 304 Not Modified دون جسم. يقبل قائمة مفصولة بفواصل، والمدقِّقات الضعيفة (W/)، و*.

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

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

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
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[]

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

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 الأصلي من Phaseo. يعيد تنسيق OpenAI القائمة المصفاة كاملة ما لم يُحدد limit.

الخيارات المتاحة:
json,
openai,
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[]
مطلوب
access
object

يُرجعه /models/me فقط: ما استبعدته ضوابط الحماية الخاصة بالمتصل من القائمة، قبل البحث والتقسيم إلى صفحات.

آخر تعديل في ١٦ نوفمبر ٢٠٢٦