कोडिंग एजेंट इस्तेमाल कर रहे हैं? शुरू करने से पहले यह प्रॉम्प्ट कॉपी और पेस्ट करें:
- API कुंजी बनाएँगे
- टेक्स्ट अनुरोध या संरचित निर्णय भेजना
- जनरेट टेक्स्ट या प्रकारयुक्त उत्तर पढ़ना
- अनुरोध विफल होने पर पहले क्या जाँचना है, यह जानेंगे
1. API कुंजी बनाएँ
- Phaseo डैशबोर्ड खोलें।
- Gateway -> कुंजियाँ के अंतर्गत एक कुंजी बनाएँ।
- इसे एक बार कॉपी करें और सुरक्षित रखें।
API कुंजी को पासवर्ड की तरह सुरक्षित रखें। इसे क्लाइंट-साइड कोड में न रखें।
2. टेक्स्ट अनुरोध भेजें
पहले अनुरोध के लिएPOST /v1/responses इस्तेमाल करें। नए टेक्स्ट जनरेशन इंटीग्रेशन के लिए यही सुझाया गया endpoint है।
अनुरोध
जवाब
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मानदंड मैप से एक विकल्प चुनता है और संभावनाएँ व विश्वास लौटाता है।noul0 से 1 तक हाँ/नहीं की संभावना लौटाता है।scoreक्रमबद्ध मानदंड ऐरे का मूल्यांकन करता है और संभावना-भारित स्कोर लौटाता है।
अनुरोध
प्रतिक्रिया
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 करें।POST /v1/videosसे job बनाएँ।- पूरा होने तक
GET /v1/videos/{video_id}से स्टेटस पूछें। GET /v1/videos/{video_id}/contentसे सामग्री डाउनलोड करें।
6. आगे बनाते रहें
Gateway के साथ इंटीग्रेशन
प्रोडक्शन इंटीग्रेशन के तरीके और endpoint चुनने की जानकारी।
API संदर्भ
हर endpoint के अनुरोध और जवाब का पूरा दस्तावेज़।
उदाहरण
आम वर्कफ़्लो के लिए और विस्तृत अनुरोध उदाहरण।
सहायता
डिबगिंग, रूटिंग और मॉडल के व्यवहार में मदद पाएँ।