मुख्य सामग्री पर जाएं
POST
संरचित निर्णय लें
यह एंडपॉइंट बीटा चरण में है। POST /v1/decisions पर input और questions की एक क्रमबद्ध array भेजें, और हर प्रश्न का एक टाइप किया गया उत्तर, संभावनाओं के साथ, उसी क्रम में पाएं।

निर्णय लें

यह अनुरोध हर प्रकार का एक प्रश्न पूछता है। इसके लिए Phaseo API कुंजी और एक उपलब्ध openai/gpt-6-luna रूट चाहिए।
प्रतिक्रिया (मान उदाहरण के लिए):

प्रश्न लिखें

input एक string है, या user संदेशों की array, जिनका content एक string है या input_text, input_image, input_audio और input_video भागों की सूची। name वैकल्पिक है; उत्तर अनुरोध का क्रम बनाए रखते हैं, जिसमें बिना नाम वाले और दोहराए गए नाम भी शामिल हैं। एक अनुरोध में अधिकतम 128 प्रश्न हो सकते हैं, सिवाय google/gemini-decision-1 के, जो 1,000 तक स्वीकार करता है, parallel/decisions-fast के, जो 100 तक स्वीकार करता है, और Clef के, जो 64 तक स्वीकार करता है। मॉडल की सीमा से अधिक वाला अनुरोध 400 लौटाता है। Boolean विकल्प मान boolean के रूप में ही लौटते हैं। जो मॉडल किसी प्रश्न का उत्तर देने से मना करता है, वह उसके लिए type: "refusal" लौटाता है। कौन-सा मॉडल कौन-से प्रकार समर्थित करता है, यह मॉडल चुनें में सूचीबद्ध है। इमेज input_image भागों में data URL के रूप में जाती हैं। होस्ट की गई HTTPS इमेज URL सिर्फ़ Base Labs मॉडलों (baselabs/elephant-1, baselabs/mammoth-1 और baselabs/joey-1) पर काम करते हैं और Amazon S3, Google Cloud Storage या Azure Blob Storage पर होने चाहिए। एक अनुरोध में अधिकतम 128 इमेज हो सकती हैं, जिन्हें Luna स्वीकार करता है; दूसरे प्रदाता कम सीमाएं तय करते हैं। स्पष्ट इमेज detail और safety_identifier के लिए OpenAI रूट चाहिए।

पुराने state फ़ॉर्मैट का उपयोग करें

state और नामित प्रश्नों के मैप वाले अनुरोध अब भी काम करते हैं और उन्हीं नामों से कुंजीबद्ध उत्तर लौटाते हैं। Together Tev (together/tev1-4b-experimental) को यही फ़ॉर्मैट चाहिए, क्योंकि वह संभावनाओं के बिना लेबल लौटाता है, और सिर्फ़ choice प्रश्नों के उत्तर देता है। Respan Span-01 भी यही फ़ॉर्मैट इस्तेमाल करता है। फ़ॉर्मैट न मिलाएं: state या images के साथ input देने पर 400 लौटता है।
  • state: मूल्यांकन की जाने वाली जानकारी वाली string, ऑब्जेक्ट या array।
  • questions: अधिकतम 128 नामित प्रश्न, या अधिक सीमा वाले मॉडलों पर उससे ज़्यादा। हर प्रश्न type को noul (हां/नहीं), choice या score पर सेट करता है, साथ में instructions। Choice प्रश्न criteria को विकल्प से विवरण के मैप के रूप में लेते हैं; score प्रश्न criteria को कम से कम दो स्तर विवरणों की array के रूप में लेते हैं।
  • locate प्रश्न केवल instructions लेते हैं और बिना images वाला स्ट्रिंग state चाहते हैं; देखें Perplexity Decider।
  • images: अधिकतम चार PNG, JPEG या WebP इमेज, data: URL या { "content_type", "base64" } ऑब्जेक्ट के रूप में।
  • model: न देने पर डिफ़ॉल्ट typesafe/jev-1.13.0 होता है।
उत्तर questions वाली ही कुंजियां इस्तेमाल करते हैं। choice उत्तरों में चुना गया विकल्प, संभावनाएं और confidence होते हैं; noul उत्तरों में 0–1 की संभावना होती है; score उत्तरों में संभावना-भारित स्कोर, एक legend, संभावनाएं और confidence होते हैं।

मॉडल चुनें

इनमें से किसी भी मॉडल को कॉल करने से पहले मॉडल की उपलब्धता जांचें। कीमत के साथ सूचीबद्ध हर मॉडल पर आउटपुट टोकन मुफ़्त हैं।

TypeSafe Jev

Jev 1.13 के लिए typesafe/jev-1.13.0 का उपयोग करें, या नवीनतम Jev रिलीज़ के साथ चलने के लिए typesafe/jev-latest। अपस्ट्रीम प्रश्न अर्थों के लिए TypeSafe का API संदर्भ देखें। समर्थन करने वाले TypeSafe रूट पर, Jev 1.13 और 1.14 input_image या पुराने images फ़ील्ड से इनलाइन PNG या JPEG इमेज स्वीकार करते हैं। Phaseo TypeSafe के इमेज एसेट बनाता है और इमेज समर्थन अपने आप चालू करता है। इमेज को TypeSafe की इमेज सीमाएं पूरी करनी होंगी: हर एक अधिकतम 16 MiB, हर तरफ़ 256 से 1568 पिक्सेल, और कुल कम से कम 78,400 पिक्सेल। TypeSafe आयाम और एन्कोडिंग की जांच करता है और अस्वीकृत इमेज का आकार नहीं बदलता। मैप की गई अपस्ट्रीम JSON बॉडी की सीमा 32 MiB है। इमेज टोकन सामान्य इनपुट कीमत पर लगते हैं। box (Jev 1.14 जैसे समर्थन करने वाले रूट पर) के लिए एक इमेज चाहिए, यह कोई criteria नहीं लेता, और एक bounding box व confidence लौटाता है। इसके किनारे 0 से 1 तक होते हैं, जो ऊपर-बाएं कोने से मापे जाते हैं। Box हमेशा एक आयत लौटाता है, इसलिए जब लक्ष्य मौजूद न भी हो सकता हो, तो इसे predicate उपस्थिति प्रश्न के साथ जोड़ें। पुराने images फ़ील्ड के साथ images[0] का संदर्भ दें; क्रमबद्ध इनपुट के साथ पहली इमेज या [Image 0] का संदर्भ दें। Box कॉन्ट्रैक्ट देखें। प्रति-अनुरोध और प्रति-प्रश्न संदर्भ सीमाओं को डिफ़ॉल्ट 64k प्रति अनुरोध और 32k प्रति प्रश्न से बढ़ाकर 262k टोकन करने के लिए provider_options.typesafe.long_context को true पर सेट करें। लंबे संदर्भ की प्रति टोकन कीमत वही है। इमेज, Box और लंबा संदर्भ प्रायोगिक अपस्ट्रीम क्षमताएं हैं।

Cloudflare Clef और Clef Flash

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

Cloudflare Clef Omni

cloudflare/clef-omni टेक्स्ट, इमेज, ऑडियो और वीडियो स्वीकार करता है। ऑडियो और वीडियो भाग इनपुट फ़ॉर्मैट में Phaseo के एक्सटेंशन हैं; OpenAI रूट सिर्फ़ टेक्स्ट और इमेज स्वीकार करते हैं। यह उदाहरण भेजने से पहले प्लेसहोल्डर ऑडियो बाइट और वीडियो URL को अपने मीडिया से बदलें।
ऑडियो को format: "wav" या "mp3" के साथ input_audio.data के रूप में भेजें, या किसी सार्वजनिक HTTPS URL या इनलाइन ऑडियो data URL के साथ input_audio.url के रूप में। input_video.video_url एक string या { "url": "..." } लेता है, जिसमें सार्वजनिक HTTPS URL या इनलाइन MP4/WebM data URL हो। रिमोट सर्वर को मेल खाता Content-Type लौटाना होगा। Phaseo आकार सीमाओं और निजी-पते व रीडायरेक्ट जांचों के साथ URL फ़ेच करता है, फिर Cloudflare के लिए मीडिया एम्बेड करता है; प्रदाता क्रेडेंशियल कभी मीडिया सर्वर को नहीं भेजे जाते। Cloudflare मीडिया एन्कोडिंग, इमेज आयाम और क्लिप की अवधि की जांच करता है, और वीडियो को दो फ़्रेम प्रति सेकंड पर सैंपल करता है। किसी वीडियो का साउंडट्रैक तब इस्तेमाल होता है जब अनुरोध के हर वीडियो में साउंडट्रैक हो। मीडिया टोकन संदर्भ और बिलिंग में गिने जाते हैं; Phaseo Cloudflare के बताए गए इनपुट उपयोग के आधार पर हिसाब करता है और ऑडियो या वीडियो के लिए अलग शुल्क नहीं जोड़ता। Cloudflare का Omni कॉन्ट्रैक्ट देखें।

Liquid D1.2 और D1.2 Ultra

liquid-ai/d1.2 और liquid-ai/d1.2-ultra पुराने state फ़ॉर्मैट का उपयोग करते हैं, जिसमें अधिकतम चार इमेज और आठ ऑडियो क्लिप भेजी जा सकती हैं। audio को base64 data: URL के रूप में भेजें (WAV, MP3, FLAC, M4A या OGG, हर URL अधिकतम 24 MiB, यानी लगभग 18 MiB ऑडियो); रिमोट ऑडियो URL समर्थित नहीं हैं। noul, choice और score के अलावा ये इन प्रश्न प्रकारों का उत्तर देते हैं: किसी choice प्रश्न पर multiple: true सेट करने पर सभी लागू विकल्प choices में मिलते हैं, साथ में हर विकल्प के लिए probabilities। अन्य मॉडल इन प्रश्न प्रकारों के लिए 400 लौटाते हैं और multiple प्रश्नों का उत्तर एक विकल्प से देते हैं; ऑडियो इनपुट के बिना वाले मॉडल audio को अनदेखा करते हैं। liquid-ai/d1, liquid-ai/d1.1 और liquid-ai/d1-ultra टेक्स्ट और इमेज स्वीकार करते हैं और noul, choice व score का उत्तर देते हैं।

Liquid D1 और Perplexity Decider

Liquid D1 (liquid-ai/d1:free) प्रायोगिक अर्ली एक्सेस के दौरान मुफ़्त है। Perplexity Decider V1.3 (perplexity/pplx-decider-v1.3, या perplexity/pplx-decider-latest) और Decider Flash V1.3 (perplexity/pplx-decider-flash-v1.3, या perplexity/pplx-decider-flash-latest) के लिए Phaseo में Perplexity प्रदाता क्रेडेंशियल चाहिए। इनकी इमेज स्थिति PNG, JPEG या WebP base64 data URL इस्तेमाल करती है; रिमोट इमेज URL समर्थित नहीं हैं। ये locate प्रश्नों का भी जवाब देते हैं, जो स्ट्रिंग input या state के वे हिस्से लौटाते हैं जो instructions से मेल खाते हैं, जैसे "email address"। हर अंश में शब्दशः कॉपी किया गया text, Unicode कोड पॉइंट में गिने गए start और end ऑफ़सेट (end exclusive है), और एक score होता है जिसमें ज़्यादा मान का मतलब ज़्यादा भरोसा है; कुछ भी मेल न खाए तो spans खाली होता है। Locate में criteria नहीं होते, यह इमेज, ऑडियो या वीडियो स्वीकार नहीं करता, और केवल उन्हीं मॉडलों पर चलता है जो इसे सूचीबद्ध करते हैं; बाकी मॉडल 400 लौटाते हैं। Perplexity ने इसे अधिकतम 8K टोकन वाले इनपुट पर प्रशिक्षित किया है। दोनों पर, choice प्रश्न अधिकतम 255 विकल्प और score प्रश्न अधिकतम 10 स्तर स्वीकार करता है।

Inception Mercury Decide

inception/mercury-decide टेक्स्ट या JSON साक्ष्य लेता है। Choice प्रश्न अधिकतम 255 विकल्प और score प्रश्न अधिकतम 10 स्तर स्वीकार करते हैं। इमेज, स्ट्रीमिंग और टूल कॉलिंग समर्थित नहीं हैं। $0.02 की इनपुट कीमत Inception का 50% प्रमोशन है, जिसकी कोई प्रकाशित समाप्ति तारीख नहीं है; उपयोग से पहले मौजूदा अपस्ट्रीम कीमतें जांचें।

Microsoft Decision

microsoft/microsoft-decision-1 एक Azure Foundry डिप्लॉयमेंट पर चलता है और अधिकतम 32,768 टोकन तक का टेक्स्ट या JSON साक्ष्य लेता है। मीडिया, स्ट्रीमिंग, टूल, safety_identifier और service_tier समर्थित नहीं हैं। Microsoft की गाइड देखें।

Respan Span-01

Span-01 पुराना फ़ॉर्मैट इस्तेमाल करता है। state एक बातचीत का अंश होना चाहिए: पिछले संदेशों की एक input array और एक output assistant संदेश। यह सिर्फ़ noul प्रश्नों के उत्तर देता है: noul मान इस बात की संभावना है कि व्यवहार मौजूद है, और probabilities अनुपस्थित और न देखे जा सकने की संभावनाएं भी देता है।
प्रतिक्रिया ऐसी दिखती है:
respan/span-01:free दैनिक सीमा वाला मुफ़्त Lite मॉडल है और Respan के span-01-free मॉडल से मैप होता है। respan/span-01 span-01-pro से मैप होता है और उसकी बिलिंग Respan करता है। Span-01 अर्ली एक्सेस में है: Respan को इसे आपके संगठन के लिए चालू करना होगा, और किसी भी मॉडल को कॉल करने से पहले आप Phaseo में अपनी Respan API कुंजी को Respan प्रदाता क्रेडेंशियल के रूप में जोड़ते हैं।

प्राधिकरण

Authorization
string
header
आवश्यक

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

बॉडी

application/json

OpenAI प्रारूप पसंदीदा है। पुराना प्रारूप समर्थित है। उत्तर अनुरोध जैसा होता है; प्रारूप न मिलाएँ।

model
string
आवश्यक

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

Minimum string length: 1
input
आवश्यक

टेक्स्ट या इनलाइन चित्र वाले संदेश। ऑडियो और वीडियो समर्थित मॉडल के लिए Phaseo विस्तार हैं; OpenAI निर्णय रूट ये विस्तार समर्थित नहीं करते।

Maximum string length: 10485760
questions
object[]
आवश्यक
Required array length: 1 - 1000 elements
models
string[]

model के बाद आज़माए जाने वाले वैकल्पिक, क्रमबद्ध फ़ॉलबैक मॉडल। model आवश्यक है और हमेशा प्राथमिक मॉडल होता है। जब कोई प्रयास 429, 500, 502, 503 या 504 के साथ विफल होता है, तो अगली प्रविष्टि आज़माई जाती है; अन्य त्रुटियाँ बिना बदलाव के लौटाई जाती हैं। अधिकतम 25 मॉडल ID या प्रीसेट स्वीकार करता है; डुप्लिकेट और model के समान प्रविष्टियाँ अनदेखी की जाती हैं। हर प्रयास को अलग अनुरोध के रूप में सत्यापित, लॉग और बिल किया जाता है, और प्रतिक्रिया का model फ़ील्ड तथा रूटिंग ट्रेस उस मॉडल को दिखाते हैं जिसने अनुरोध पूरा किया। स्ट्रीमिंग अनुरोध केवल पहले बाइट से पहले फ़ॉलबैक करते हैं, और वीडियो तथा संगीत जॉब केवल सबमिशन के समय। Batch, realtime और council अनुरोध models को अस्वीकार करते हैं। डायनामिक रूट पर सेट किए गए फ़ॉलबैक को प्राथमिकता मिलती है, और phaseo/auto को models के साथ नहीं जोड़ा जा सकता।

Required array length: 1 - 25 elements
Minimum string length: 1
उदाहरण:
provider_options
object
safety_identifier
string | null

अपारदर्शी उपयोगकर्ता पहचान। केवल OpenAI रूट।

Maximum string length: 128
meta
boolean
डिफ़ॉल्ट:false
echo_upstream_request
boolean
debug
object

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

provider
object

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

routing
object

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

metadata
object

प्रतिक्रिया

200 - application/json

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

input/सूची के लिए क्रमबद्ध उत्तर; पुराने state/मैप के लिए नामित मैप।

model
string
आवश्यक
answers
object[]
आवश्यक

क्रम में हर प्रश्न का उत्तर, बिना नाम या दोहराए नाम वाले प्रश्न सहित।

usage
object
आवश्यक
request_id
string | null
meta
object
अंतिम संशोधन 16 नवंबर 2026