نقاط النهاية

يقدّم Tianshu مسارين — ما عليك سوى اختيار أحدهما بناءً على نوع الطلب.

المسار القياسي (الافتراضي)

https://tian-shu.org

مناسب لـ الغالبية العظمى من نقاط النهاية: المحادثة، النص، التضمينات (embeddings)، إعادة الترتيب (rerank)، وما إلى ذلك. يبدأ مخرج المحادثة بالبث (streaming) في إعادة الرموز (tokens) بمجرد إنشاء الاتصال، ولا يتأثر بمهلات أول بايت (first-byte timeouts)، لذا فإن هذا المسار موصى به افتراضيًا.

المسار المباشر (الطلبات طويلة الأمد / توليد الصور)

https://api.tian-shu.org

مناسب لـ الطلبات طويلة الأمد التي تُعيد النتيجة دفعة واحدة، وعادةً ما يكون ذلك توليد الصور (/v1/images/generations وما شابه). لا تُعيد هذه الطلبات نتيجتها إلا بعد انتهاء الخادم من الحساب، وهو ما قد يؤدي بسهولة إلى تشغيل مهلات طلب الـ CDN؛ يتجاوز المسار المباشر الـ CDN ويصل إلى الأصل (origin) مباشرةً، متجنبًا انقطاعات المهلة.

قاعدة عامة: الطلبات بالبث التي تستمر في إصدار الرموز (tokens) ← المسار القياسي؛ الطلبات التي تحسب لفترة طويلة ثم تُعيد النتيجة دفعة واحدة (توليد الصور، إلخ) ← المسار المباشر.

مسارات نقاط النهاية

كلا المسارين متوافق مع المسارات بأسلوب OpenAI، على سبيل المثال:

الاستخدام	المسار
إكمالات المحادثة	/v1/chat/completions
الاستجابات	/v1/responses
رسائل Claude	/v1/messages
التضمينات	/v1/embeddings
إعادة الترتيب	/v1/rerank
توليد الصور	/v1/images/generations
الكلام / النسخ النصي	/v1/audio/speech, /v1/audio/transcriptions

تتحدد نقاط النهاية التي يدعمها نموذج معيّن بناءً على ما هو مدوّن في سوق النماذج.