OpenRouter से Phaseo पर माइग्रेट करना

​

क्या बदलता है

1. Payload का आकार वही रखें।
2. Base URL और API key का स्रोत बदलें।
3. Model IDs और OpenRouter-only headers जाँचें।
4. Traffic धीरे-धीरे बढ़ाते हुए latency, output और cost की तुलना करें।

​

शुरू करने से पहले

• मौजूदा OpenRouter एकीकरण कोड और डिप्लॉयमेंट कॉन्फ़िगरेशन तक पहुँच।
• dev, staging और production में PHASEO_API_KEY उपलब्ध हो।
• production model IDs और प्रतिनिधि prompts की छोटी सूची।

​

1) OpenRouter के मौजूदा इस्तेमाल की सूची बनाएँ

• openrouter.ai endpoints खोजें।
• code, CI और hosting environment variables में OPENROUTER_API_KEY खोजें।
• HTTP-Referer और X-Title जैसे OpenRouter-only headers खोजें।
• active model IDs और fallback logic दर्ज करें।
• ऐसे साझा prompt, provider या parameter defaults पहचानें जिन्हें application code में दोहराने के बजाय Gateway presets में ले जाना चाहिए।

​

2) Base URL और credentials बदलें

// 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) Model IDs जाँचें और OpenRouter-only व्यवहार का मिलान करें

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

• Authorization: Bearer format वैसा ही रखें।
• ऐप की पहचान के लिए इस्तेमाल होने पर HTTP-Referer और X-Title रखें। Phaseo इनके lowercase रूप http-referer और x-title भी स्वीकार करता है।
• callers OpenRouter-only response fields पर निर्भर हों, तो उन्हें एक compatibility layer में adapt करें।
• provider allow/deny lists या routing defaults को callers में बिखेरने के बजाय Presets और Routing और fallbacks में ले जाएँ।

​

प्रदाता नियंत्रणों का मिलान

​

4) OpenRouter व्यवहार-समानता की जाँच-सूची

• Base URL https://api.phaseo.app/v1 है।
• सभी environments में OPENROUTER_API_KEY को PHASEO_API_KEY से बदला गया है।
• सभी production model IDs को /v1/models से जाँचा गया है।
• /v1/chat/completions या /v1/responses से एक non-streaming request सफल है।
• production वाला app integration path इस्तेमाल करके एक streaming request सफल है।
• GET /v1/generations?id=<request_id> जाँचा गया है, ताकि replay_supported=true होने पर संग्रहीत replay_request से failed requests दोबारा चलाई जा सकें।
• असली prompts के साथ tool-calling और structured-output flows दोबारा जाँचे गए हैं।
• staging में invalid-key और invalid-model errors जाँचे गए हैं।
• OpenRouter-only headers और response fields हटाए या स्पष्ट रूप से normalize किए गए हैं।
• साझा prompt/routing defaults जहाँ उपयुक्त हों, presets में ले जाए गए हैं।

​

एजेंट के लिए माइग्रेशन जाँच-सूची

1. runtime code और deployment config में openrouter.ai, OPENROUTER_API_KEY, sk-or-v1, HTTP-Referer और X-Title खोजें।
2. कोई secret source control में जोड़े बिना client boundary को https://api.phaseo.app/v1 और PHASEO_API_KEY पर बदलें।
3. GET /v1/models query कर हर पुराने और नए model mapping को दर्ज करें।
4. OpenRouter-विशिष्ट रूटिंग विकल्पों या प्रतिक्रिया फ़ील्ड को एक संगतता मॉड्यूल में ढालें।
5. नीचे दिए health, model, request, streaming और failure checks चलाएँ।
6. बदली गई फ़ाइलों, गुप्त नामों में परिवर्तनों, मॉडल मैपिंग, परीक्षण के प्रमाण, समानता की कमियों और रोलबैक स्विच की रिपोर्ट दें।

​

5) सुरक्षित rollout करें

1. शुरुआत सिर्फ़ internal traffic से करें।
2. production traffic को 5–10% तक बढ़ाकर quality, latency और cost की तुलना करें।
3. parity की पुष्टि के बाद ही 100% करें।
4. बदलाव स्थिर होने तक rollback को सिर्फ़ URL और key बदलने तक सीमित रखें।

​

सत्यापन कमांड

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"}]}'

• ऐप के integration test से एक streaming request चलाएँ।
• invalid key या model के लिए negative test चलाएँ।
• छोटे baseline prompt set को दोबारा चलाकर outputs की तुलना करें।

​

अगले चरण

• OpenRouter integration को माइग्रेट करने में मुफ़्त मदद पाएँ
• OpenRouter की इंटरैक्टिव माइग्रेशन गाइड खोलें
• Phaseo और OpenRouter की तुलना करें
• क्विकस्टार्ट
• API Reference: models
• उदाहरण
• Error handling