وثائق المطوّرين
كل ما تحتاجه لربط تطبيقك بالمنصّة: مصادقة، توليد، بثّ، أخطاء، وحدود.
العنوان الأساسي
https://<host>/v1بوابة المطوّرين مسارٌ عام ثابت مستقل عن مسارات لوحة التحكم الداخلية — لا يتغيّر بتغيّر الواجهة.
البدء السريع
من صفر إلى أول ردّ في أقل من خمس دقائق.
المصادقة
المفاتيح، الترويسات، وقواعد التعامل مع السرّ.
توليد الردود
نقطة /chat/completions: الطلب، الرد، وحقل usage.
البثّ
قراءة SSE سطرًا سطرًا حتى data: [DONE].
الأخطاء
رموز الحالة، وصيغة الخطأ، وكيف تتصرّف مع كلٍّ منها.
الحدود والحصص
حدّ الطلبات في الدقيقة، سقوف الطلب، وسلوك الرصيد.
سطر الهوية — شفافية كاملة
تضيف المنصّة سطر تعليمات نظام واحدًا في بداية رسائلك، يخبر النموذج أنه مساعد VORIX وألّا يخوض في تفاصيل بنيته الداخلية. هذا السطر الوحيد هو كل ما نضيفه — رسائلك بعده تصل كما كتبتها حرفًا بحرف، بلا حقنٍ خفيّ يغيّر إخراجك أو يكسر تنسيقًا تعتمد عليه. نوثّقه هنا لأن ما يُضاف لطلبك يجب أن تعرفه.
السطر يُحتسب ضمن توكنات الدخل (بضع عشرات من التوكنات).
تحتاج مساعدة؟
إن واجهت سلوكًا لا تفسّره الوثائق، أو احتجت حدودًا أعلى من حدود خطتك، أو أردت مناقشة استخدام مؤسّسي — تواصل معنا من صفحة الدعم في حسابك، أو راسل فريقنا مباشرةً. أرفق دائمًا حقل id من الرد ووقت الطلب: به نجد نداءك بالضبط.
قبل أن تراسلنا
- تحقّق من صلاحية مفتاحك عبر GET /v1/me — يعيد حالة المفتاح ورصيدك.
- راجع صفحة الأخطاء: أغلب الحالات لها رمز صريح يشرح نفسه.
- إن كان الخطأ 429، انتظر انقضاء الدقيقة ثم أعد المحاولة بتباعد متزايد.