मुख्य सामग्री पर जाएं
एक छोटा Next.js चैट ऐप चलाएँ जिसका ब्राउज़र कोड सिर्फ़ आपके अपने सर्वर रूट से बात करता है, ताकि आपकी Phaseo API कुंजी कभी ब्राउज़र तक न पहुँचे। अंत में आपके पास एक स्थानीय चैट पेज होगा, जिसमें GET /v1/models से भरा मॉडल पिकर और POST /v1/responses से आए जवाब होंगे। यह सैंपल उदाहरण के लिए है: इसके रूट में न साइन-इन है, न रेट लिमिट, इसलिए जो भी उन तक पहुँच सकता है वह आपकी कुंजी खर्च कर सकता है। पहले डिप्लॉय करने से पहले वाली जाँचें जोड़ें। किसी कोडिंग एजेंट से यही ऐप शुरू से बनवाने के लिए, यह प्रॉम्प्ट पेस्ट करें:

Phaseo Gateway पर Next.js वेब चैट ऐप बनाएँ।

Cursor में खोलें

सैंपल कैसे बना है

सैंपल examples/web-chat-nextjs में है:

इसे चलाएँ

आपको Node.js और एक Phaseo API कुंजी चाहिए।
1

इंस्टॉल करें

सैंपल के साथ package-lock.json आता है, इसलिए npm परखे हुए संस्करण इंस्टॉल करता है।
2

.env.local बनाएँ

सैंपल में .env.example नहीं है। .env.local खुद बनाएँ:
.env.local
यहाँ NEXT_PUBLIC_GATEWAY_URL सिर्फ़ सर्वर पर पढ़ा जाता है, लेकिन NEXT_PUBLIC_ प्रीफ़िक्स इसे ब्राउज़र कोड के सामने खोल देगा, इसलिए इसमें कभी कुंजी न डालें। ऐप एट्रिब्यूशन दोनों वैकल्पिक हेडर समझाता है।
3

दूसरा चैट टर्न ठीक करें

ChatClient.tsx पिछले जवाब का id previous_response_id के रूप में भेजता है। Gateway प्रतिक्रियाएँ संग्रहीत नहीं करता, इसलिए वह इस फ़ील्ड को 400 validation_error (कीवर्ड unsupported_param) के साथ अस्वीकार कर देता है और दूसरा संदेश विफल हो जाता है। app/api/responses/route.ts में वह ब्लॉक हटाएँ जो previous_response_id को payload में कॉपी करता है:
app/api/responses/route.ts
इसके बाद हर टर्न का जवाब अलग से दिया जाता है। संदर्भ बनाए रखने के लिए, पिछले टर्न को input में संदेशों की array के रूप में भेजें।
4

डेव सर्वर शुरू करें

http://localhost:3000 खोलें।

जाँचें कि यह काम किया

  • मॉडल पिकर मॉडल ID से भर जाता है।
  • लगातार दो संदेशों में से हर एक को जवाब मिलता है।
  • ब्राउज़र के नेटवर्क पैनल में अनुरोध सिर्फ़ /api/models और /api/responses पर जाते हैं, और किसी अनुरोध में PHASEO_API_KEY नहीं होती।
  • गलत मॉडल ID खाली जवाब के बजाय Gateway का त्रुटि संदेश दिखाता है।
  • अनुरोध सेटिंग → उपयोग → लॉग्स में आपके सेट किए ऐप टाइटल के साथ दिखते हैं।

डिप्लॉय करने से पहले

  • रूट प्रमाणित करें। /api/responses और /api/models पर साइन-इन किया हुआ उपयोगकर्ता ज़रूरी करें, या OAuth workbench इस्तेमाल करें ताकि हर उपयोगकर्ता अपने क्रेडिट खर्च करे।
  • मॉडल की अनुमति-सूची बनाएँ। रूट ब्राउज़र से आई कोई भी model स्ट्रिंग आगे भेज देता है। सर्वर पर उसे एक तय सूची से जाँचें।
  • इनपुट और दर सीमित करें। इनपुट की लंबाई और हर उपयोगकर्ता के अनुरोध सीमित करें, और कुंजी पर खर्च सीमा सेट करें।
  • ज़रूरत हो तो स्ट्रीम करें। stream: true सेट करें और इवेंट आगे भेजें; स्ट्रीमिंग बताता है कि कौन-सा इवेंट Responses स्ट्रीम खत्म करता है।
UI के बजाय बैकएंड स्क्रिप्ट के लिए, Node REST smoke ऐप या Python gateway CLI से शुरू करें।
अंतिम संशोधन 5 नवंबर 2026