> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venice.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# كيف يعمل كتالوج النماذج

> كيف تبني Venice كتالوج النماذج: عائلات النماذج ومتغيراتها، والأسعار الموحَّدة لكل نوع وسائط، ومستويات الخصوصية، ومجموعة المطالبات المرجعية، وكيف سيُقاس الأداء والمعايير.

يُولَّد [كتالوج النماذج](https://docs.venice.ai/ar/models/overview.md) من [`GET /models`](https://docs.venice.ai/ar/api-reference/endpoint/models/list) كل ساعة. تشرح هذه الصفحة كيف تُشتق الأرقام المعروضة فيه، حتى تتمكن من إعادة حسابها ومعرفة ما تعنيه وما لا تعنيه.

## العائلات والمتغيرات

كثير من معرّفات النماذج هي النموذج نفسه مقدَّمًا بطريقة مختلفة. يجمعها الكتالوج في صفحة عائلة واحدة:

| نوع المتغير | مثال | سبب فصله |
| - | - | - |
| الخصوصية | `z-ai-glm-5-3` و`e2ee-glm-5-3-p` | يعمل متغير E2EE داخل بيئة معزولة موثَّقة وقد تكون له حدود مختلفة |
| السرعة | `claude-opus-5-5` و`claude-opus-5-5-fast` | تقديم أسرع بسعر أعلى |
| الوضع | `kling-v3-pro-text-to-video` و`-image-to-video` و`-motion-control` | مدخلات وأسعار مختلفة |
| المهمة | `nano-banana-pro` و`nano-banana-pro-edit` | نقاط نهاية للتوليد والتحرير |

يحتفظ كل متغير بمعرّف النموذج وسعره ومستوى خصوصيته الخاص به. مرّر معرّف المتغير كقيمة `model`. تبقى اللقطات المؤرَّخة مثل `deepseek-v4-flash-0731` عائلات منفصلة وتظهر ضمن **إصدارات أخرى**.

## الأسعار الموحَّدة

يُفوتَر كل نوع وسائط بوحدته الخاصة. يعرض الكتالوج الوحدة الأصلية وسعرًا مرجعيًا واحدًا، بحيث يمكن فرز النماذج ومقارنتها.

| نوع الوسائط | الوحدة الأصلية | السعر المرجعي |
| - | - | - |
| النص | لكل مليون توكن إدخال وإخراج | **المدمج**: `(3 × input + output) / 4`، وهو مزيج 3:1 الذي تستخدمه Artificial Analysis. خصم الإدخال المخزَّن مؤقتًا هو `1 − cached ÷ input`. |
| الصورة | لكل صورة، حسب مستوى الدقّة | سعر الصورة الواحدة عند المستوى المحدد (1K أو 2K أو 4K). تضيف عمليات التحرير رسومًا إضافية لكل صورة مقابل المدخلات الإضافية. |
| الفيديو | لكل مقطع، حسب الدقّة والمدة والصوت | السعر لكل ثانية ولكل مقطع عند الإعدادات المحددة، من مصفوفة عروض أسعار كاملة (أدناه). |
| تحويل النص إلى كلام | لكل مليون حرف | لكل دقيقة كلام بمعدل 150 كلمة (نحو 825 حرفًا) في الدقيقة. |
| تحويل الكلام إلى نص | لكل ثانية صوت | لكل ساعة صوت ولكل 1,000 دقيقة. |
| الموسيقى والمؤثرات الصوتية | لكل مقطوعة، أو لكل ثانية، أو لكل شريحة مدة | لكل دقيقة صوت حيث يسمح النموذج بذلك؛ وإلا فلكل مقطوعة. |
| التضمينات | لكل مليون توكن إدخال | دون تغيير. |

> [!NOTE]
>
> قد تستهلك نماذج الاستدلال توكنات إخراج أكثر بكثير من النماذج غير الاستدلالية في المهمة نفسها، لذا فإن السعر المدمج يقلّل من تقدير تكلفتها الفعلية. من المخطط قياس التكلفة لكل مهمة على تشغيلات المعايير؛ راجع [المعايير](#benchmarks).

### تسعير الفيديو

لا تنشر نماذج الفيديو أسعارها في `GET /models`. في وقت البناء، تستدعي Venice [`POST /video/quote`](https://docs.venice.ai/ar/api-reference/endpoint/video/quote) لكل تركيبة من الدقّة × المدة × الصوت يدعمها كل نموذج، بأول نسبة عرض إلى ارتفاع مدرجة له (نسبة العرض إلى الارتفاع لا تغيّر السعر). يخزّن الكتالوج المصفوفة الكاملة ويشتق منها:

* **لكل ثانية**: وسيط `price ÷ seconds` عبر المدد عند دقّة وإعداد صوت محددين. الأسعار خطية بالنسبة للمدة في جميع النماذج تقريبًا.
* **مقطع تجريبي**: 5 ثوانٍ، 720p، بدون صوت.
* **مقطع إنتاجي**: 10 ثوانٍ، 1080p، مع صوت.

عندما لا يوفّر النموذج الإعداد المطلوب، يستخدم الكتالوج أقرب إعداد يدعمه ويُعلِّم السعر. تُفوتَر أوضاع التحرير والتحكم بالحركة والترقية حسب طول الفيديو المصدر، لذا تعرض **حسب المصدر** بدلًا من السعر. استدعِ دائمًا `POST /video/quote` قبل الإدراج في قائمة الانتظار للحصول على المبلغ الدقيق.

## مستويات الخصوصية

| المستوى | ما يعنيه |
| - | - |
| **E2EE** | تُشفَّر المطالبات على جهازك ولا يُفك تشفيرها إلا داخل بيئة عتادية معزولة موثَّقة. راجع [نماذج TEE وE2EE](https://docs.venice.ai/ar/guides/features/tee-e2ee-models.md). |
| **TEE** | يجري الاستدلال داخل بيئة عتادية معزولة مع توثيق تشفيري. |
| **Private** | يُقدَّم على بنية تحتية تتحكم بها Venice، دون أي احتفاظ بالبيانات. |
| **Anonymized** | يُمرَّر إلى المختبر المصدر دون هويتك. قد يحتفظ المختبر بالمطالبات. |

تسرد العائلة كل المستويات التي توفرها متغيراتها. تؤدي التصفية حسب مستوى إلى عرض المتغير المتوفر في ذلك المستوى، بسعره الخاص.

## مجموعة المطالبات المرجعية

تُولَّد مخرجات نماذج الصور والفيديو على مجموعة مطالبات ثابتة، وهي المطالبات نفسها لكل نماذج نوع الوسائط الواحد، بالإعدادات الافتراضية. هذا ما يجعل معرض المستكشف قابلًا للمقارنة من نموذج إلى آخر.

| نوع الوسائط | المطالبات |
| - | - |
| الصورة | نص داخل الصورة، الواقعية الفوتوغرافية، اتباع التعليمات، أسلوب الرسم التوضيحي |
| الفيديو | منظر طبيعي سينمائي، حلقة سلسة، مشهد حضري سينمائي |

تعرض النماذج التي لا تتوفر لها مخرجات **المخرجات المرجعية قيد الانتظار**.

## الأداء

> [!NOTE]
>
> لم يُنشر بعد. يصف هذا القسم ما سيعرضه الكتالوج.

ستقيس Venice النماذج باستخدام مجسّات اصطناعية، وليس بمطالبات العملاء أبدًا، وستنشر:

| نوع الوسائط | المقاييس |
| - | - |
| النص | وقت التشغيل، الوقت حتى أول توكن، توكنات الإخراج في الثانية، الوقت حتى استجابة من 500 توكن، معدل إصابة ذاكرة التخزين المؤقت، معدل النجاح |
| الصورة | وقت التشغيل، وقت توليد صورة واحدة بدقّة 1K (p50 وp95)، معدل النجاح |
| الفيديو | وقت التشغيل، وقت الانتظار في القائمة ووقت التوليد لمقطع مدته 5 ثوانٍ بدقّة 720p (يُبلَّغ عنهما بشكل منفصل)، معدل النجاح |
| الصوت | وقت التشغيل، الوقت حتى أول صوت، عامل السرعة، معدل النجاح |
| التضمينات | وقت التشغيل، زمن الاستجابة لإدخال من 1K توكن، معدل النجاح |

سيعرض كل رقم نافذته الزمنية (30 يومًا متجددة لوقت التشغيل، و7 أيام لزمن الاستجابة)، والمئين، وعدد العينات، ومنطقة المجسّ. يستثني وقت التشغيل أخطاء 4xx الناتجة عن الطلب نفسه. معدل إصابة ذاكرة التخزين المؤقت هو `cache_read ÷ (input + cache_read + cache_write)` عبر كل حركة المرور. ستُعلَّم النماذج ذات العينات القليلة جدًا بـ **أولي**.

## المعايير

> [!NOTE]
>
> لم يُنشر بعد. يصف هذا القسم ما سيعرضه الكتالوج.

تُختار المعايير لتلائم النماذج الرائدة: أن تظل قادرة على التمييز في القمة، ومقاومة للتلوث، وقابلة للتشغيل على النموذج كما تقدّمه Venice. ستحمل كل نتيجة تصنيف مصدر واحدًا، ولن يُحسب متوسطها مع غيرها أبدًا:

* **موثَّق من Venice**: شُغِّل على نقطة نهاية Venice المعروضة في الصفحة.
* **مستقل**: شغّله طرف ثالث، عادةً على واجهة API الخاصة بالمختبر.
* **مُبلَّغ عنه من المختبر**: نشره صانع النموذج.

تعرض كل نتيجة أيضًا إصدار المعيار وأداة التشغيل، وجهد الاستدلال، وتاريخ الاختبار، وفاصل الثقة. تُعلَّم النتائج التي يزيد عمرها عن 90 يومًا، أو التي حلّ محلها إصدار أحدث من المعيار، بأنها قديمة.

| نوع الوسائط | المجموعة الرئيسية المخطط لها |
| - | - |
| النص | Artificial Analysis Intelligence Index، بالإضافة إلى Humanity's Last Exam وTerminal-Bench وτ³-bench وAA-LCR وIFBench وAA-Omniscience وVenice Openness Score |
| الصورة | تقييم Elo لتفضيلات البشر من ساحات Artificial Analysis وLMArena، وGenEval 2، ومعدل الرفض المفرط |
| الفيديو | تقييم Elo من Artificial Analysis لتحويل النص إلى فيديو (مع الصوت وبدونه) وتحويل الصورة إلى فيديو، وLMArena لتحويل النص إلى فيديو |
| تحويل النص إلى كلام | Artificial Analysis Speech Arena Elo، معدل خطأ الكلمات، الوقت حتى أول صوت |
| تحويل الكلام إلى نص | معدل خطأ الكلمات من Artificial Analysis، Open ASR Leaderboard، عامل السرعة |
| الموسيقى | Artificial Analysis Music Arena (الموسيقى الآلية والغناء) |
| التضمينات | MTEB Multilingual وRTEB ومجموعة استرجاع محجوزة من Venice |

تُراجَع المجموعة كل ربع سنة. يصبح المعيار فحصًا للحد الأدنى، ولا يعود معيارًا رئيسيًا، بمجرد أن تتشبّع به النماذج الرائدة أو يفشل في تدقيق التلوث.

## بيانات قابلة للقراءة آليًا

يُنشر الكتالوج الذي تستند إليه هذه الصفحات بصيغة JSON على [`/data/model-catalog.json`](https://docs.venice.ai/data/model-catalog.json) ويُعاد بناؤه مع كل مزامنة كل ساعة. وهو مناسب للمقارنة والتحليل والوكلاء؛ أما لاختيار نموذج وقت التشغيل، فاستدعِ [`GET /models`](https://docs.venice.ai/ar/api-reference/endpoint/models/list).

| الحقل | المحتوى |
| - | - |
| `version` | إصدار المخطط، حاليًا `1` |
| `generatedAt` | وقت آخر بناء غيّر البيانات بصيغة ISO 8601 |
| `counts` | إجمالي النماذج والعائلات، إجمالًا ولكل نوع وسائط |
| `providers` | صانعو النماذج مفهرسين حسب الـ slug، مع `name` و`logo` |
| `families` | مصفوفة من العائلات: `slug` و`name` و`modality` و`task` و`provider` و`description` و`primary` (معرّف المتغير الافتراضي) و`variants` (معرّفات النماذج) و`created` و`updated` (بثواني Unix) و`privacy` (كل المستويات المتوفرة) و`uncensored` و`openWeights` |
| `models` | كائن مفهرس حسب معرّف النموذج: `name` و`type` (كما في `GET /models`) و`modality` و`task` و`variant` و`provider` و`family` (الـ slug الخاص بعائلته) و`privacy`، وكتلة واحدة من الحدود والقدرات تحمل اسم نوع الوسائط (`text` أو `image` أو `video` أو `audio` أو `embedding`)، و`pricing` بالوحدة الأصلية، و`headline` (السعر المرجعي أعلاه) و`media` (المخرجات المرجعية) |
| `benchmarks` | تعريفات المعايير؛ تكون `null` إلى أن تُنشر المعايير |
| `mediaSuite` | مجموعة المطالبات المرجعية، حسب نوع الوسائط |

تُحذف الحقول التي لا قيمة لها. الأسعار بالدولار الأمريكي.

## مصادر البيانات

يُبنى الكتالوج من نقاط نهاية عامة يمكنك استدعاؤها بنفسك:

* [`GET /models`](https://docs.venice.ai/ar/api-reference/endpoint/models/list) للمواصفات والقدرات والأسعار.
* [`POST /video/quote`](https://docs.venice.ai/ar/api-reference/endpoint/video/quote) لأسعار الفيديو.
* [`GET /models/traits`](https://docs.venice.ai/ar/api-reference/endpoint/models/traits) للقيم الافتراضية مثل `default_code`.

الأسعار بالدولار الأمريكي. تُفوتَر DIEM بالتكافؤ.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.