الانتقال إلى المحتوى الرئيسي
غيّر عنوان URL الأساسي إلى https://api.phaseo.app/v1 والمفتاح إلى PHASEO_API_KEY. تظل حمولات الطلبات وترويسة Authorization: Bearer وكائن provider ومصفوفة الاحتياط models تعمل؛ تحقّق من معرّفات النماذج ومن الحقول القليلة في الجدول أدناه.

تبديل العميل

أبقِ الحمولة دون تغيير في المرحلة الأولى، وحقّق التكافؤ قبل التحسين. أزل OPENROUTER_BASE_URL والمفتاح القديم من الشيفرة وإعدادات CI والاستضافة. يصبح @openrouter/ai-sdk-provider هو @phaseo/ai-sdk-provider (راجع الترحيل من Vercel AI Gateway)؛ أما حِزم SDK الخاصة بـ OpenRouter (@openrouter/sdk وopenrouter على PyPI) فتحتاج إلى تغيير العميل، لا مجرد عنوان URL أساسي جديد.

التحقق من معرّفات النماذج

معظم المعرّفات متطابقة، لكن بعض الجهات تختلف: x-ai/ تصبح spacex-ai/، وmeta-llama/ تصبح meta/، وmistralai/ تصبح mistral/. اعرض معرّفات Phaseo وتحقّق من كل نموذج إنتاجي مقابلها:
تحتوي القائمة الافتراضية على النماذج التي يمكنك استدعاؤها الآن فقط؛ أضف availability=all لرؤية النماذج غير النشطة أو القادمة قريبًا. دون format=openai تكون الاستجابة قائمة models المقسّمة إلى صفحات الخاصة بـ Phaseo، ولا تحتوي على مصفوفة data.

مطابقة حقول الطلب

يوفّر Phaseo أيضًا provider.required_execution_region وprovider.required_data_region، وليس لهما مقابل في OpenRouter. راجع تثبيت المزوّدين أو تجاهلهم والتوجيه فقط إلى مزوّدين في الاتحاد الأوروبي أو يدعمون ZDR للاطلاع على طلبات كاملة. أبقِ أي حقول متبقية خاصة بـ OpenRouter في محوّل واحد بدلًا من كل موضع استدعاء، حتى يبقى التراجع مجرد تغيير لعنوان URL الأساسي والمفتاح.

التحقق قبل التحويل

شغّل هذه الطلبات على Phaseo، ثم الفحوصات نفسها عبر مسار العميل الخاص بتطبيقك:
قبل نقل حركة ذات شأن، تأكد من أن:
  • OPENROUTER_API_KEY قد استُبدل بـ PHASEO_API_KEY في كل بيئة؛
  • كل معرّف نموذج إنتاجي موجود في GET /v1/models?format=openai؛
  • طلبًا غير متدفق وطلبًا متدفقًا ينجحان عبر /v1/chat/completions أو /v1/responses، باستخدام مسار العميل نفسه المستخدم في الإنتاج؛
  • مسارات استدعاء الأدوات والمخرجات المنظّمة تنجح بمطالبات حقيقية؛
  • حالات فشل المفتاح غير الصالح والنموذج غير الصالح تُعالَج؛
  • يمكن البحث عن طلب فاشل باستخدام GET /v1/generations?id=<request_id>، وعندما تكون قيمة replay_supported هي true، يمكن إعادة تشغيله من replay_request؛
  • الترويسات وحقول الاستجابة الخاصة بـ OpenRouter قد أُزيلت أو وُحّدت، والإعدادات الافتراضية المشتركة موجودة في الإعدادات المسبقة.

النشر

  1. ابدأ بالحركة الداخلية.
  2. انقل 5-10% من حركة الإنتاج وقارن الجودة وزمن الاستجابة والتكلفة.
  3. ارفع النسبة إلى 100% بعد تأكيد التكافؤ.
  4. أبقِ التراجع مجرد تبديل لعنوان URL الأساسي والمفتاح حتى يستقر التحويل.

تسليم الترحيل إلى وكيل برمجة

امنح الوكيل هذا التسلسل المحدد، أو ثبّت مهارة الترحيل من OpenRouter إلى Phaseo، التي تجمع خطوات الجرد والمطابقة والتحقق والتراجع نفسها:
  1. ابحث في شيفرة التشغيل وإعدادات النشر عن openrouter.ai وOPENROUTER_API_KEY وsk-or-v1 وHTTP-Referer وX-Title.
  2. غيّر حدود العميل إلى https://api.phaseo.app/v1 وPHASEO_API_KEY دون إضافة أي قيمة سرية إلى نظام التحكم في الإصدارات.
  3. استعلم عن GET /v1/models?format=openai وسجّل كل مطابقة من نموذج قديم إلى نموذج جديد.
  4. كيّف خيارات التوجيه أو حقول الاستجابة الخاصة بـ OpenRouter في وحدة توافق واحدة.
  5. شغّل فحوصات الصحة والطلبات غير المتدفقة والمتدفقة ومسارات الفشل أعلاه.
  6. أبلغ عن الملفات المتغيرة وتغييرات أسماء الأسرار ومطابقات النماذج وأدلة الاختبار وفجوات التكافؤ ومفتاح التراجع.
للحصول على نسخة موجّهة، افتح دليل الترحيل التفاعلي من OpenRouter، أو اطّلع على المقارنة بين المنصتين، أو احصل على مساعدة مجانية في الترحيل.
آخر تعديل في ٥ نوفمبر ٢٠٢٦