ज़्यादातर बार जब आप किसी AI मॉडल से सवाल पूछते हैं, तो आपको जवाब में पूरा निबंध नहीं चाहिए होता। आपको बस “yes”, “billing” या “10 में से 7” चाहिए, ताकि आपका कोड एक रास्ता चुनकर आगे बढ़ सके। Google की नई Gemini Decisions API ठीक इसी काम के लिए बनी है, और आउटपुट के लिए कुछ भी चार्ज नहीं करती।
यह गाइड बताती है कि Python और curl में पहली कॉल कैसे करें, तीनों तरह के जवाब कैसे पढ़ें, और Google के डॉक्यूमेंट किए गए जाल से कैसे बचें। यह 15 नवंबर 2026 तक के Google डॉक्स पर आधारित है। हमने Python और curl सैंपल का सिंटैक्स चेक किया है (कोड कंपाइल होता है और JSON बॉडी पार्स होती है)। असली कॉल के लिए आपकी अपनी API की चाहिए, इसलिए नीचे के सैंपल आउटपुट वही हैं जो डॉक्स में दिखाए गए हैं।
Decisions API असल में क्या है
Google ने इसे 11 नवंबर 2026 को Gemini Decision 1 (gemini-decision-1) नाम के मॉडल के साथ लॉन्च किया। टेक्स्ट लिखने के बजाय, यह मॉडल आपके दिए गए विकल्पों को स्कोर करता है और प्रोबेबिलिटी लौटाता है। Google के मुताबिक़ एक रिक्वेस्ट में एक ही इनपुट पर 1,000 तक सवाल हो सकते हैं, और 16K टोकन तक के इनपुट के लिए मीडियन एंड-टू-एंड लेटेंसी 150 से 250 मिलीसेकंड है।
कीमत 0.10 डॉलर (USD) प्रति मिलियन इनपुट टोकन है, और आउटपुट हमेशा शून्य टोकन होता है। साझा इनपुट का बिल हर रिक्वेस्ट में एक ही बार बनता है, चाहे आप कितने भी सवाल पूछें। Google AI Studio में एक फ़्री टियर है, जिसके बारे में Google का प्राइसिंग पेज कहता है कि आपका डेटा उसके प्रोडक्ट्स बेहतर करने में इस्तेमाल हो सकता है। पेड टियर के बारे में वह कहता है कि ऐसा नहीं होता।
Simon Willison ने बताया कि Google का यह मॉडल एक छोटी कैटेगरी में आता है, जिसमें दो प्रतिद्वंद्वी और हैं। उनके मुताबिक़ Gemini Decision 1 की कीमत OpenAI के GPT-6 Luna डिसीज़न मॉडल जितनी ही है, जबकि Jev नाम का एक मॉडल 4.2 सेंट प्रति मिलियन के साथ सस्ता है। उन्हें एक अनोखी बात भी मिली: हां/नहीं वाले सवालों पर Jev और OpenAI सीधे 1.0 या 0.0 लौटाते हैं, जबकि Gemini ने 0.92 और 0.05 जैसे नरम नंबर लौटाए।
आपको क्या चाहिए
- Google AI Studio से एक Gemini API की।
- Google GenAI SDK के साथ Python, वर्ज़न 3.2 या उससे नया। JavaScript इस्तेमाल करने वालों को
@google/genaiचाहिए। - कोई भी HTTP क्लाइंट, अगर आप SDK के बिना काम करना चाहते हैं।
स्टेप 1: SDK इंस्टॉल करें और अपनी की सेट करें
pip install -U google-genai
export GEMINI_API_KEY=your-key-here
Google डॉक्स का curl उदाहरण की को GEMINI_API_KEY से पढ़ता है। Python, JavaScript और curl से Gemini को कॉल करने के बारे में और जानने के लिए हमारी Gemini 4 Hydrogen API गाइड देखें।
स्टेप 2: अपना पहला हां/नहीं सवाल पूछें
यह Google डॉक्स का क्विकस्टार्ट है। इसे decisions.py नाम से सेव करें:
from google import genai
client = genai.Client(http_options={"api_version": "v1beta"})
result = client.decisions.create(
model="gemini-decision-1",
input="The blue mug I ordered on Monday arrived cracked on Wednesday.",
questions={
"is_damaged": {
"type": "noul",
"instructions": "Did the item arrive damaged?",
},
},
)
answer = result.answers["is_damaged"]
print(f"P(yes)={answer.noul:.2f} confidence={answer.confidence:.2f}")
python decisions.py चलाएं। डॉक्स में yes की प्रोबेबिलिटी और confidence दोनों के लिए 0.99 का जवाब दिखाया गया है, और total_output_tokens 0 है। आप जो की चुनते हैं (is_damaged), वह सिर्फ़ एक लेबल है। मॉडल उसे कभी नहीं देखता, इसलिए पूरा सवाल instructions में लिखें।
स्टेप 3: curl से आज़माएं
यह API एक ही POST रिक्वेस्ट है, इसलिए किसी SDK की ज़रूरत नहीं:
curl -X POST "https://generativelanguage.googleapis.com/v1beta/decisions" \
-H "x-goog-api-key: $GEMINI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gemini-decision-1",
"input": "The blue mug I ordered on Monday arrived cracked on Wednesday.",
"questions": {
"is_damaged": {
"type": "noul",
"instructions": "Did the item arrive damaged?"
}
}
}'
स्टेप 4: तीनों तरह के सवाल समझें
| टाइप | किसलिए | criteria चाहिए? | आपको क्या मिलता है |
|---|---|---|---|
noul | किसी हां/नहीं वाले स्टेटमेंट की जांच | नहीं | noul (0.01 से 0.99), confidence |
choice | 2 से 255 विकल्पों में से एक चुनना | हां, विकल्प और उसके विवरण का मैप | choice, probabilities, confidence |
score | 0 से शुरू होने वाले क्रमवार लेवल पर रेटिंग | हां, लेवल की एक लिस्ट | score, probabilities, legend, confidence |
एक choice सवाल ऐसा दिखता है (डॉक्स का उदाहरण इनपुट है “I was charged twice for my order.” [मेरे ऑर्डर का पैसा दो बार कट गया]):
questions={
"department": {
"type": "choice",
"instructions": "Which department should handle this request?",
"criteria": {
"billing": "Payments, invoices, and refunds.",
"technical": "Problems using the product.",
"shipping": "Delivery and tracking.",
"other": "Anything outside these categories.",
},
},
}
score वैल्यू लेवल नंबरों का प्रोबेबिलिटी-वेटेड औसत है, इसलिए यह दो लेवल के बीच भी आ सकती है। Flavio Copes के लेख में तीन लेवल वाले स्केल पर 1.12 दिखाया गया है।
स्टेप 5: confidence को तय करने दें कि एक्शन कौन लेगा
हर जवाब में 0 से 1 तक का एक confidence होता है, यानी इस बात की अनुमानित प्रोबेबिलिटी कि टॉप जवाब सही है। Google सुझाव देता है कि जवाब से एक्शन चुनें और confidence से तय करें कि कोड उसे चलाए या नहीं:
answer = result.answers["department"]
if answer.confidence >= 0.7:
route_to(answer.choice)
else:
route_to("human_review")
यहां route_to आपका अपना फ़ंक्शन है। Google कहता है कि थ्रेशोल्ड अपने ट्रैफ़िक के लेबल किए गए उदाहरणों से तय करें, 0.7 को कॉपी न करें।
स्टेप 6: सवालों को बैच में भेजें
एक ही इनपुट पर आपस में स्वतंत्र सवालों को एक ही रिक्वेस्ट में रखें। साझा इनपुट एक बार गिना जाता है, और आप अलग-अलग टाइप मिला सकते हैं। Google का उदाहरण एक सपोर्ट टिकट को एक ही कॉल में रूट करता है: हां/नहीं वाली डिफ़ेक्ट जांच, चार विकल्पों में से एक्शन का चुनाव और चार लेवल वाला चर्न स्कोर। सवाल एक-दूसरे को नहीं देख सकते।
जानने लायक लिमिट्स
| लिमिट | वैल्यू |
|---|---|
| प्रति रिक्वेस्ट सवाल | 1 से 1,000 |
| कॉन्टेक्स्ट विंडो | 262,144 टोकन, इनपुट और सवाल मिलाकर |
| फ़्री टियर | 200 रिक्वेस्ट प्रति मिनट, 10,000 प्रति दिन |
| टियर 1 (Tier 1) | 1,500 रिक्वेस्ट प्रति मिनट, 50,000 प्रति दिन |
आम एरर और उनके हल
- निश्चितता चेक करने पर कुछ नहीं होता। हां/नहीं की प्रोबेबिलिटी हमेशा 0.01 और 0.99 के बीच रहती है, इसलिए
noul > 0.99वाला टेस्ट कभी मैच नहीं होता। थ्रेशोल्ड इसी रेंज के अंदर रखें। - बेकार इनपुट को भी लेबल मिल जाता है। चॉइस वाले सवाल प्रोबेबिलिटी को आपके विकल्पों में बांट देते हैं, भले ही कोई भी फ़िट न हो। विवरण के साथ एक
otherविकल्प जोड़ें और confidence चेक करें। - आपका कैच-ऑल विकल्प आख़िर में नहीं आता। API विकल्पों की keys को वर्णक्रम में सॉर्ट करती है, इसलिए
none_of_the_aboveआख़िर में नहीं, बल्किshippingसे पहले आता है।otherजैसा विवरण वाला कैच-ऑल इस्तेमाल करें। - 400 एरर। यह तब आता है जब आप कोई लिमिट तोड़ते हैं, की वैलिडेशन फ़ेल होता है, या सेफ़्टी फ़िल्टर ट्रिगर होते हैं। एरर बॉडी में
safetyजैसा कोईcodeबताया जाता है। - मीडिया लोड नहीं होता। YouTube URL और
gs://एड्रेस सपोर्टेड नहीं हैं। Files API URI, कोई पब्लिक या साइन किया हुआ HTTPS लिंक, या इनलाइन base64 डेटा इस्तेमाल करें। - लंबे डॉक्यूमेंट पर बिल धीरे-धीरे बढ़ता है। कोई कॉन्टेक्स्ट कैशिंग या Batch API नहीं है, इसलिए दोहराया गया इनपुट पूरा गिना जाता है। इसके बजाय सारे सवाल एक ही रिक्वेस्ट में पूछें।
- यूज़र के टेक्स्ट पर अजीब नतीजे। Google चेतावनी देता है कि इनपुट अपने ही क्लासिफ़िकेशन के पक्ष में दलील दे सकता है। पैसे से जुड़े किसी भी काम से पहले किसी इंसान या दूसरी जांच को रखें।
- सेटअप में दिक्कत। कुछ और डीबग करने से पहले चेक करें कि आपके पास SDK 3.2 या नया है और API वर्ज़न
v1betaहै। डॉक्स के मुताबिक़ यह API सिर्फ़ v1beta पर उपलब्ध है।
कब कुछ और इस्तेमाल करें
Decisions API का इस्तेमाल तय जवाबों वाले रूटिंग, फ़िल्टरिंग और नियम-जांच के लिए करें। अगर आपको जनरेट किया गया टेक्स्ट, सारांश या आपके अपने JSON स्कीमा के हिसाब से वैल्यू चाहिए, तो Google इसके बजाय Interactions API की सलाह देता है। अगर आप मॉडल को अपने हार्डवेयर पर चलाना पसंद करते हैं, तो हमारी Ollama गाइड वह तरीका बताती है।
स्रोत
लिंक आख़िरी बार 15 नवंबर 2026 को जांचे गए।





प्रतिक्रिया लिखें