Gemini Decisions API क्विकस्टार्ट: Python और curl में हां/नहीं, चॉइस और स्कोर वाले जवाब

Google की Gemini Decisions API टेक्स्ट की जगह प्रोबेबिलिटी लौटाती है, और आउटपुट टोकन का कोई बिल नहीं बनता। यहां Python और curl के साथ स्टेप-बाय-स्टेप क्विकस्टार्ट है, साथ में लिमिट्स और गलतियों से बचने के तरीके।

Graphic showing a quickstart for the Gemini Decisions API with a yes, choice and score answer card.

ज़्यादातर बार जब आप किसी AI मॉडल से सवाल पूछते हैं, तो आपको जवाब में पूरा निबंध नहीं चाहिए होता। आपको बस “yes”, “billing” या “10 में से 7” चाहिए, ताकि आपका कोड एक रास्ता चुनकर आगे बढ़ सके। Google की नई Gemini Decisions API ठीक इसी काम के लिए बनी है, और आउटपुट के लिए कुछ भी चार्ज नहीं करती।

Mindloop Experience पर देखें: Gemini Decisions API: 1,000 Questions in One Call for $0.10 per Million Tokens

यह गाइड बताती है कि 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
choice2 से 255 विकल्पों में से एक चुननाहां, विकल्प और उसके विवरण का मैपchoice, probabilities, confidence
score0 से शुरू होने वाले क्रमवार लेवल पर रेटिंगहां, लेवल की एक लिस्ट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 को जांचे गए।

लेखक: Mindloop Editorial

The Mindloop Experience editorial team writes clear, carefully sourced explainers and how-tos on tech, science, money and culture, for anyone who likes to know how things actually work.

Mindloop Experience के बारे में

प्रतिक्रियाएँ

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

Mindloop Experience से और

Mindloop Experience के सभी लेख

आप 50 बार तक ताली बजा सकते हैं।