الانتقال إلى المحتوى الرئيسي
أرسل الطلبات النصية إلى eu.api.phaseo.app أو us.api.phaseo.app لاستخدام مسارات المزوّدين التي تشغّل النموذج وتعالج بيانات الموجّه والإكمال داخل تلك المنطقة فقط. تبقى معرّفات النماذج ومفاتيح API كما هي. تُدعم Chat Completions وResponses وMessages.
التوجيه الإقليمي ليس بعد ضمانًا شاملًا لإقامة البيانات من البداية إلى النهاية. يقيّد Phaseo اختيار المزوّد ويضع الـ Gateway قرب المنطقة، لكن أنظمة الحساب والفوترة والذاكرة المؤقتة والتشغيل المشتركة قد تعالج البيانات خارجها. راجع ما يبقى خارج المنطقة.

أرسل طلبًا إقليميًا

في حزم SDK، اضبط region على "eu" أو "us"؛ واتركه، أو استخدم "global"، للتوجيه العالمي. ترمي حزمة SDK خطأً إذا ضبطت كلًا من region وbaseUrl مخصصًا (base_url في Python)، لأنهما يختاران مضيفين مختلفين. اسم المضيف هو السياسة. يفشل وجود required_execution_region أو required_data_region في الطلب أو في إعداد مسبق يسمّي منطقة أخرى بالخطأ 400 validation_error والسبب deployment_region_conflict. تُطبَّق الإعدادات المسبقة وقواعد التوجيه الديناميكي أولًا والقاعدة الإقليمية أخيرًا، لذا لا يمكنها إضعافها. لا يعيد Phaseo المحاولة أبدًا عبر مزوّد خارج المنطقة.

ما الذي يمكن أن يحتويه الطلب الإقليمي

أدواتك الخاصة مسموح بها لأنها تعمل في تطبيقك. أما الأدوات المستضافة وأدوات الخادم فتعمل في مكان لا تستطيع القاعدة الإقليمية التحكم فيه.

اعثر على النماذج المتاحة في منطقة

استدعِ /v1/models على اسم المضيف نفسه الذي ترسل إليه الطلبات. يختلف التوفر بين نقاط النهاية الأوروبية والأمريكية والعالمية.
لا تحتوي القائمة إلا على النماذج التي لها مسار مزوّد نشط تشمل منطقتا التنفيذ والبيانات المصرّح بهما فيه المنطقة المعنية، ولا تعلن إلا عن Chat Completions وResponses وMessages بإدخال ومخرجات نصية. يعرض كل عرض مناطقه:

تحقّق من الـ Gateway الذي عالج الطلب

تحمل الاستجابات الإقليمية X-Phaseo-Gateway-Region: eu (أو us). تسمّي الترويسة السياسة الإقليمية التي عالجت الطلب؛ وليست دليلًا على المكان الذي شغّله فيه Cloudflare. تسجّل تفاصيل الطلب أيضًا منطقتي التنفيذ والبيانات المطلوبتين، والمزوّد المختار، والمناطق المصرّح بها لذلك المزوّد.

الأخطاء

تعيد مخالفات القاعدة الإقليمية 400 not_supported مع إحدى قيم reason التالية: يعني 400 validation_error مع السبب deployment_region_conflict أن الطلب أو إعدادًا مسبقًا يسمّي منطقة أخرى؛ أزل ذلك الإعداد. إذا لم يستوفِ أي مسار مزوّد سليم النموذج والمنطقة معًا، يتوقف الطلب قبل استدعاء أي مزوّد؛ اختر نموذجًا مدرجًا في /v1/models الإقليمية.

ما يبقى خارج المنطقة

تغطي القاعدة الإقليمية المزوّد الذي يشغّل النموذج ويعالج بيانات الموجّه والإكمال. ولا تغطي بعد دورة حياة الطلب كاملة:
  • يضع تموضع Cloudflare الـ Gateway قرب المنطقة، لكنه ليس حدًا للامتثال.
  • تعيش بيانات الحساب والمصادقة والفوترة والبيانات الوصفية للطلبات على بنية Supabase التحتية المشتركة.
  • لا ترتبط Cloudflare KV وسجلات استدعاء Worker بمنطقة.
  • تذهب الاستدعاءات إلى المزوّد إلى نقطة النهاية الإقليمية لذلك المزوّد، بغض النظر عن المكان الذي وضع فيه Cloudflare الـ Gateway.
  • لا يقتصر موظفو الدعم والتشغيل على المنطقة.
لن يسمّي Phaseo هذا إقامة بيانات شاملة من البداية إلى النهاية إلا عندما تملك مسارات الـ Gateway والتخزين والتسجيل والمزوّد والتشغيل كلها ضوابط إقليمية قابلة للإنفاذ.
آخر تعديل في ٥ نوفمبر ٢٠٢٦