الترحيل من LLM Gateway

​

ما الذي سيتغير

​

قبل البدء

• إعداد نقطة نهاية LLM Gateway الحالية ومفتاح API.
• إتاحة PHASEO_API_KEY في البيئات المحلية والتجهيز والإنتاج.
• عينة مرجعية لجودة المخرجات وزمن الاستجابة ومعدل الأخطاء.

​

1) احصر نقاط التكامل

• ابحث عن جميع مواضع استخدام متغيرات البيئة LLM_GATEWAY_*.
• اعثر على كل مراجع عنوان URL الأساسي في إعدادات وقت التشغيل.
• سجّل معرّفات النماذج النشطة حاليًا وسلاسل البدائل.
• دوّن القيم الافتراضية المشتركة للمطالبات وقواعد السماح أو المنع للمزوّدين وإعدادات المعلمات التي ينبغي نقلها إلى إعدادات Gateway المسبقة.

​

2) بدّل نقطة النهاية وبيانات الاعتماد

// Before
import OpenAI from "openai";

const before = new OpenAI({
  apiKey: process.env.LLM_GATEWAY_API_KEY,
  baseURL: "https://api.llmgateway.io/v1",
});

// After
import OpenAI from "openai";

const after = new OpenAI({
  apiKey: process.env.PHASEO_API_KEY,
  baseURL: "https://api.phaseo.app/v1",
});

curl -s "https://api.phaseo.app/v1/chat/completions" \
  -H "Authorization: Bearer $PHASEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role":"user","content":"Hello"}]
  }'

​

3) تحقّق من توافق النماذج

curl -s "https://api.phaseo.app/v1/models" \
  -H "Authorization: Bearer $PHASEO_API_KEY" | jq '.data | length'

​

4) قائمة التحقق من الترحيل من LLMGateway

• تم تعيين جميع متغيرات LLM_GATEWAY_* أو إزالتها.
• تم تحديث عنوان URL الأساسي إلى https://api.phaseo.app/v1.
• تم إعداد PHASEO_API_KEY في جميع بيئات النشر.
• تم التحقق من معرّفات نماذج الإنتاج باستخدام /v1/models.
• تم التحقق في بيئة التجهيز من طلب متدفق وآخر غير متدفق.
• أُعيد فحص معالجة فشل المفاتيح والنماذج غير الصالحة.
• نُقلت القيم الافتراضية المشتركة للمطالبات والتوجيه إلى الإعدادات المسبقة عند الحاجة.
• أُعيد فحص عمليات البحث عن التوليدات عبر GET /v1/generations?id=<request_id> حتى يمكن إعادة تشغيل الطلبات الفاشلة من محتوى replay_request المخزّن عند replay_supported=true.

​

5) تحقّق وأطلق التغيير

1. شغّل مجموعة المطالبات المرجعية وقارن الجودة وزمن الاستجابة والتكلفة بخط الأساس.
2. تأكد من إمكانية استعادة طلبات التجهيز الفاشلة باستخدام حمولة إعادة التشغيل التي يعيدها GET /v1/generations.
3. أطلق التغيير خلف علامة canary وزد نسبة حركة المرور تدريجيًا بعد استقرار النتائج.
4. راقب مقاييس الإنتاج لدورة إصدار واحدة على الأقل قبل إزالة الإعداد القديم.

​

أوامر التحقق

curl -s "https://api.phaseo.app/v1/health"
curl -s "https://api.phaseo.app/v1/models" -H "Authorization: Bearer $PHASEO_API_KEY"

• نفّذ طلبًا متدفقًا وآخر غير متدفق في بيئة التجهيز.
• أعد تشغيل المطالبات المرجعية وقارنها بخط الأساس.

​

الخطوات التالية

• الترحيل من OpenRouter
• الترحيل من Vercel AI Gateway
• البدء السريع