Skip to main content
POST
संरचित निर्णय लें
जब ऐप्लिकेशन को ऐसे संरचित उत्तर चाहिए जिन्हें कोड सीधे इस्तेमाल कर सके, तो POST /v1/decisions इस्तेमाल करें। समर्थित मॉडल में TypeSafe Jev 1.13 (typesafe/jev-1.13.0), Together Tev1 4B Experimental (together/tev1-4b-experimental) और Respan Span-01 (respan/span-01:free तथा respan/span-01) शामिल हैं। अनुरोध में ये शामिल हैं:
  • state: मूल्यांकन की जानकारी वाली स्ट्रिंग, ऑब्जेक्ट या ऐरे।
  • questions: नाम वाले प्रश्नों का मैप। हर प्रश्न में type को noul, choice या score रखा जाता है और instructions शामिल होता है; समर्थित प्रकार चुने गए मॉडल पर निर्भर हैं।
  • model: Phaseo मॉडल आईडी। Jev 1.13 के लिए typesafe/jev-1.13.0 या नवीनतम Jev रिलीज़ के लिए typesafe/jev-latest इस्तेमाल करें।
Liquid D1 (liquid-ai/d1:free, liquid-ai/d1 के रूप में भी उपलब्ध) और Perplexity Decider 27B (perplexity/decider-27b) तीनों प्रश्न प्रकारों का समर्थन करते हैं। D1 प्रयोगात्मक शुरुआती पहुँच के दौरान मुफ़्त है। Decider की कीमत चित्र टोकन सहित प्रति दस लाख इनपुट टोकन 0.04 अमेरिकी डॉलर है; आउटपुट टोकन मुफ़्त हैं। Decider के लिए Phaseo में Perplexity प्रदाता क्रेडेंशियल जोड़ें। चित्र वाली स्थिति PNG, JPEG या WebP के base64 डेटा URL इस्तेमाल करती है; दूरस्थ चित्र URL समर्थित नहीं हैं। हर चयन प्रश्न में अधिकतम 255 विकल्प और हर स्कोर प्रश्न में अधिकतम 10 स्तर हो सकते हैं। दोनों में से किसी मॉडल को कॉल करने से पहले उसकी उपलब्धता जाँचें। Respan Span-01 के लिए state बातचीत का ऐसा भाग होना चाहिए जिसमें पिछले संदेशों का input ऐरे और सहायक का output संदेश हो। Span-01 केवल noul प्रश्नों का समर्थन करता है। noul उत्तर व्यवहार मौजूद होने की संभावना है; probabilities में अनुपस्थित और न देखे जा सकने की संभावनाएँ भी हैं।
respan/span-01:free दैनिक सीमा वाला मुफ़्त Lite मॉडल है; Phaseo इसे Respan की API मॉडल आईडी span-01-free से मैप करता है। respan/span-01, Respan की API मॉडल आईडी span-01-pro से मैप होता है और Respan प्रति दस लाख इनपुट टोकन 0.02 अमेरिकी डॉलर लेता है; आउटपुट टोकन मुफ़्त हैं। Span-01 शुरुआती पहुँच में है, इसलिए Respan को आपके संगठन के लिए पहुँच सक्षम करनी होगी। इन मॉडल को कॉल करने से पहले अपनी Respan API कुंजी Phaseo में Respan प्रदाता क्रेडेंशियल के रूप में जोड़ें। उत्तर questions वाली ही कुंजियाँ इस्तेमाल करते हैं। choice उत्तर में चुना हुआ विकल्प, संभावनाएँ और विश्वास स्तर होते हैं; noul उत्तर में 0–1 की संभावना होती है; और score उत्तर में संभावना-भारित स्कोर, संकेत विवरण, संभावनाएँ और विश्वास स्तर होते हैं। Respan उदाहरण के लिए प्रतिक्रिया इस प्रकार होती है:
Jev एक अनुरोध में तीनों प्रश्न प्रकारों को मिलाने का समर्थन करता है; Span-01 केवल noul प्रश्नों का समर्थन करता है। कॉपी-पेस्ट करने योग्य cURL, JavaScript, TypeScript SDK और Python SDK उदाहरणों के लिए त्वरित शुरुआत देखें। Jev 1.13 की कीमत प्रति दस लाख इनपुट टोकन 0.042 अमेरिकी डॉलर है; आउटपुट टोकन मुफ़्त हैं। प्रदाता के प्रश्नों के अर्थ के लिए TypeSafe का API संदर्भ देखें।

Clef के साथ चित्र निर्णय

cloudflare/clef और cloudflare/clef-flash, Cloudflare Workers AI के ज़रिए तीनों प्रश्न प्रकार और एम्बेड किए गए चित्रों का समर्थन करते हैं। दोनों की कॉन्टेक्स्ट विंडो 65,536 टोकन है। इनपुट की कीमत प्रति दस लाख टोकन Clef के लिए 0.24 USD और Clef Flash के लिए 0.09 USD है।
आप images में data:image/png;base64,... स्ट्रिंग भी दे सकते हैं। Clef अधिकतम चार PNG, JPEG या WebP चित्र स्वीकार करता है। हर चित्र अधिकतम 4 MiB और 16 मेगापिक्सल का हो सकता है; डिकोड किए गए चित्र डेटा की कुल सीमा 8 MiB और अनुरोध बॉडी की सीमा 13 MiB है। रिमोट URL समर्थित नहीं हैं। Cloudflare चित्रों के प्रारूप और आयाम जाँचता है। जिन मॉडलों में चित्र समर्थन नहीं है, वे चित्र अनुरोध अस्वीकार करते हैं। Clef अधिकतम 64 प्रश्न स्वीकार करता है। ID में अधिकतम 100 अक्षर, अंक, अंडरस्कोर, डॉट या हाइफ़न हो सकते हैं। विकल्प वाले प्रश्नों में 2–255 विकल्प और स्कोर वाले प्रश्नों में 2–10 स्तर आवश्यक हैं। Cloudflare के Clef दस्तावेज़ देखें।

प्राधिकरण

Authorization
string
header
आवश्यक

Bearer टोकन से प्रमाणीकरण

बॉडी

application/json
model
string
डिफ़ॉल्ट:typesafe/jev-1.13.0
आवश्यक

मानक Phaseo मॉडल आईडी या प्रदाता मॉडल उपनाम।

state
आवश्यक

मॉडल द्वारा मूल्यांकित संरचित स्थिति।

questions
object
आवश्यक
images
(string | object)[]

विज़न समर्थित निर्णय मॉडलों के लिए एम्बेड किए गए चित्र। Clef PNG, JPEG या WebP स्वीकार करता है; रिमोट URL समर्थित नहीं हैं। हर चित्र की सीमा 4 MiB और 16 मेगापिक्सल, कुल डिकोड डेटा की सीमा 8 MiB और हर अनुरोध बॉडी की सीमा 13 MiB है।

Maximum array length: 4
Pattern: ^[Dd][Aa][Tt][Aa]:image/(png|jpeg|webp);base64,[A-Za-z0-9+/]+={0,2}$
meta
boolean
डिफ़ॉल्ट:false
echo_upstream_request
boolean
debug
object

गेटवे डिबग नियंत्रण। ये फ़्लैग कभी भी प्रदाता को फ़ॉरवर्ड नहीं किए जाते।

provider
object

गेटवे चयन के लिए प्रदाता रूटिंग प्राथमिकताएँ।

routing
object

गेटवे चयन के लिए प्रदाता रूटिंग प्राथमिकताएँ।

metadata
object

प्रतिक्रिया

200 - application/json

संरचित निर्णय प्रतिक्रिया

model
string
answers
object
usage
object
request_id
string | null
meta
object
अंतिम संशोधन 2 अक्टूबर 2026