Skip to main content
इस ट्यूटोरियल से सफल Phaseo अनुरोध करें—जनरेट किया गया टेक्स्ट या संरचित निर्णय—और देखें कि प्रतिक्रिया कहाँ आती है।
कोडिंग एजेंट इस्तेमाल कर रहे हैं? शुरू करने से पहले यह प्रॉम्प्ट कॉपी और पेस्ट करें:
इसमें आप:
  • API कुंजी बनाएँगे
  • टेक्स्ट अनुरोध या संरचित निर्णय भेजना
  • जनरेट टेक्स्ट या प्रकारयुक्त उत्तर पढ़ना
  • अनुरोध विफल होने पर पहले क्या जाँचना है, यह जानेंगे

1. API कुंजी बनाएँ

  1. Phaseo डैशबोर्ड खोलें।
  2. Gateway -> कुंजियाँ के अंतर्गत एक कुंजी बनाएँ।
  3. इसे एक बार कॉपी करें और सुरक्षित रखें।
इस फ़ॉर्मैट का उपयोग करें:
API कुंजी को पासवर्ड की तरह सुरक्षित रखें। इसे क्लाइंट-साइड कोड में न रखें।

2. टेक्स्ट अनुरोध भेजें

पहले अनुरोध के लिए POST /v1/responses इस्तेमाल करें। नए टेक्स्ट जनरेशन इंटीग्रेशन के लिए यही सुझाया गया endpoint है।

अनुरोध

जवाब

Responses API को सीधे कॉल करने पर असिस्टेंट का जवाब output[].content[] में उस आइटम से पढ़ें जिसका type output_text है। अगर आप Vercel AI SDK इस्तेमाल करते हैं, तो जवाब result.text से पढ़ें।

3. संरचित निर्णय लें

ऐप्लिकेशन को जनरेट टेक्स्ट की जगह प्रकारयुक्त उत्तर चाहिए तो POST /v1/decisions इस्तेमाल करें। Phaseo TypeSafe का Jev 1.13 मॉडल ID typesafe/jev-1.13.0 से देता है। state मान और एक या अधिक नामित प्रश्न भेजें; हर उत्तर उसी नाम से लौटता है।
Decisions बीटा सुविधा है और कार्यक्षेत्र में सक्षम करना पड़ सकता है। Jev 1.13 का शुल्क प्रति 10 लाख इनपुट टोकन $0.042 है; आउटपुट टोकन मुफ़्त हैं।
PHASEO_API_KEY सेट करके ये उदाहरण सर्वर पर चलाएँ। ब्राउज़र कोड में Gateway API कुंजी कभी न दिखाएँ। तीन प्रश्न प्रकार हैं:
  • choice मानदंड मैप से एक विकल्प चुनता है और संभावनाएँ व विश्वास लौटाता है।
  • noul 0 से 1 तक हाँ/नहीं की संभावना लौटाता है।
  • score क्रमबद्ध मानदंड ऐरे का मूल्यांकन करता है और संभावना-भारित स्कोर लौटाता है।
एक ही अनुरोध में अलग प्रश्न प्रकार मिला सकते हैं।

अनुरोध

प्रतिक्रिया

प्रश्न ID से मेल खाने वाले उत्तर से प्रकारयुक्त मान पढ़ें, जैसे answers.department.choice, answers.is_urgent.noul या answers.customer_impact.score। केवल मान से निर्णय लेने के बजाय ऐप्लिकेशन सीमा तय करने के लिए confidence और probabilities इस्तेमाल करें। पूरे अनुरोध और प्रतिक्रिया अनुबंध के लिए Decisions API संदर्भ, और मॉडल व्यवहार व प्रदाता सीमाओं के लिए TypeSafe का Jev मॉडल संदर्भ देखें।

4. पहले अनुरोध की समस्या हल करें

  • 401: API कुंजी और Authorization हेडर जाँचें।
  • 400: अनुरोध बॉडी और मॉडल ID जाँचें।
  • 402: :free मॉडल चुनें या पेड मॉडल इस्तेमाल करने से पहले क्रेडिट जोड़ें।
  • 429 या 5xx: एक्सपोनेंशियल बैकऑफ़ के साथ फिर कोशिश करें।
समस्या जल्दी ढूँढ़ने के लिए त्रुटि प्रबंधन संदर्भ देखें।

5. अगर आप वीडियो बना रहे हैं

वीडियो जनरेशन एसिंक्रोनस है। पहले job बनाएँ, फिर उसका स्टेटस पूछें या नतीजे के लिए subscribe करें।
  1. POST /v1/videos से job बनाएँ।
  2. पूरा होने तक GET /v1/videos/{video_id} से स्टेटस पूछें।
  3. GET /v1/videos/{video_id}/content से सामग्री डाउनलोड करें।

6. आगे बनाते रहें

Gateway के साथ इंटीग्रेशन

प्रोडक्शन इंटीग्रेशन के तरीके और endpoint चुनने की जानकारी।

API संदर्भ

हर endpoint के अनुरोध और जवाब का पूरा दस्तावेज़।

उदाहरण

आम वर्कफ़्लो के लिए और विस्तृत अनुरोध उदाहरण।

सहायता

डिबगिंग, रूटिंग और मॉडल के व्यवहार में मदद पाएँ।
अंतिम संशोधन 2 अक्टूबर 2026