الترحيل من OpenRouter إلى Phaseo

​

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

1. أبقِ شكل الحمولة كما هو.
2. بدّل عنوان URL الأساسي ومصدر مفتاح API.
3. تحقّق من معرّفات النماذج والعناوين الخاصة بـ OpenRouter.
4. حوّل حركة المرور تدريجيًا وقارن زمن الاستجابة والمخرجات والتكلفة.

​

قبل البدء

• الوصول إلى رمز تكامل OpenRouter الحالي وإعدادات النشر.
• إتاحة PHASEO_API_KEY في التطوير والاختبار والإنتاج.
• قائمة قصيرة بمعرّفات نماذج الإنتاج ومطالبات ممثلة.

​

1) احصر استخدام OpenRouter الحالي

• ابحث عن نقاط النهاية openrouter.ai.
• ابحث عن OPENROUTER_API_KEY في الرمز وCI ومتغيرات بيئة الاستضافة.
• ابحث عن العناوين الخاصة مثل HTTP-Referer وX-Title.
• وثّق معرّفات النماذج النشطة ومنطق البدائل.
• حدّد القيم المشتركة للمطالبات أو المزوّد أو المعلمات التي ينبغي نقلها إلى إعدادات Gateway مسبقة بدل تكرارها في رمز التطبيق.

​

2) بدّل عنوان URL الأساسي وبيانات الاعتماد

// Before
import OpenAI from "openai";

const before = new OpenAI({
  apiKey: process.env.OPENROUTER_API_KEY,
  baseURL: "https://openrouter.ai/api/v1",
});

const response = await before.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "Summarize our migration plan." }],
});

// After
import OpenAI from "openai";

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

const response = await after.chat.completions.create({
  model: "openai/gpt-4.1-mini",
  messages: [{ role: "user", content: "Summarize our migration plan." }],
});

# Before
curl -s "https://openrouter.ai/api/v1/chat/completions" \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-4.1-mini",
    "messages": [{"role":"user","content":"Say hello"}]
  }'

# After
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":"Say hello"}]
  }'

​

3) تحقّق من معرّفات النماذج ومواءمة السلوك الخاص بـ OpenRouter

curl -s "https://api.phaseo.app/v1/models" \
  -H "Authorization: Bearer $PHASEO_API_KEY" | jq '.data[0:10] | map(.id)'

• أبقِ تنسيق Authorization: Bearer دون تغيير.
• احتفظ بـ HTTP-Referer وX-Title إذا كانا يعرّفان التطبيق المستدعي. يقبل Phaseo أيضًا الصيغتين بأحرف صغيرة http-referer وx-title.
• إذا كان المستدعون يعتمدون على حقول استجابة خاصة بـ OpenRouter، فكيّفها في طبقة توافق واحدة.
• انقل قوائم السماح/الرفض للمزوّدين وإعدادات التوجيه الافتراضية إلى الإعدادات المسبقة والتوجيه والبدائل.

​

مواءمة عناصر التحكم بالمزوّدين

​

4) قائمة التحقق من التكافؤ مع OpenRouter

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

​

قائمة ترحيل لوكيل برمجي

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 وسجّل كل مواءمة بين النماذج القديمة والجديدة.
4. كيّف خيارات التوجيه أو حقول الاستجابة الخاصة بـ OpenRouter في وحدة توافق واحدة.
5. نفّذ فحوص الصحة والنماذج والطلبات والبث ومسارات الفشل أدناه.
6. أبلغ عن الملفات المعدلة وتغييرات أسماء الأسرار ومواءمات النماذج وأدلة الاختبار وفجوات التكافؤ وخيار التراجع.

​

5) أطلق التغيير بأمان

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

​

أوامر التحقق

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

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

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

• نفّذ طلب بث عبر اختبار تكامل التطبيق.
• نفّذ اختبارًا سلبيًا لمفتاح أو نموذج غير صالح.
• أعد تشغيل مجموعة صغيرة من المطالبات المرجعية وقارن المخرجات.

​

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

• احصل على مساعدة مجانية لترحيل تكامل OpenRouter
• افتح دليل الترحيل التفاعلي لـ OpenRouter
• قارن Phaseo وOpenRouter
• البدء السريع
• مرجع API: النماذج
• أمثلة
• معالجة الأخطاء