Gemini API पासकोड का इस्तेमाल करना

Gemini API का इस्तेमाल करने के लिए, आपको अपने अनुरोधों की पुष्टि करनी होगी. स्टैंडर्ड या अनुमति वाले एपीआई पासकोड का इस्तेमाल करके, पुष्टि की जा सकती है.

Gemini API पासकोड बनाना या देखना

एपीआई पासकोड के टाइप: स्टैंडर्ड बनाम ऑथराइज़ेशन

एपीआई पासकोड से Gemini API को ऐक्सेस किया जा सकता है. हालांकि, इनकी सुरक्षा से जुड़ी विशेषताएं अलग-अलग होती हैं. Gemini API, स्टैंडर्ड एपीआई पासकोड से ऑथराइज़ेशन पासकोड पर स्विच कर रहा है, ताकि सुरक्षा को बेहतर बनाया जा सके:

• स्टैंडर्ड एपीआई पासकोड: बिलिंग और कोटा के लिए, अनुरोधों को Google Cloud प्रोजेक्ट से जोड़ें. स्टैंडर्ड कुंजियां, कॉल करने वाले की पहचान नहीं करती हैं. इससे, अनुमतियों और ऐक्सेस कंट्रोल की बारीकियों को सीमित कर दिया जाता है.
• अनुमति देने वाली (पुष्टि करने वाली) कुंजियां: ये सीधे तौर पर Google Cloud सेवा खाते से जुड़ी होती हैं. ऑथराइज़ेशन कुंजी का इस्तेमाल करने पर, आपके अनुरोधों को उस सीमित सेवा खाते की पहचान के तहत प्रोसेस किया जाता है. इससे ऐक्सेस कंट्रोल को ज़्यादा बारीकी से मैनेज किया जा सकता है. अनुमति देने वाली कुंजियां, डिफ़ॉल्ट रूप से Generative Language API (Gemini API) तक ही सीमित होती हैं. साथ ही, ये लीक हुई कुंजियों को लागू करने की सुविधा तुरंत उपलब्ध कराती हैं. इससे हमारे सिस्टम से लीक हुई कुंजियों का इस्तेमाल तुरंत बंद हो जाता है.

Gemini API को सुरक्षित तरीके से इस्तेमाल करने के लिए, स्टैंडर्ड पासकोड से ऑथ पासकोड पर स्विच किया जाएगा:

• डिफ़ॉल्ट तौर पर ऑथ की: 28 मई, 2026 से, Google AI Studio में बनाए गए सभी नए एपीआई पासकोड, अपने-आप ऑथ की के तौर पर बनाए जाएंगे.
• बिना पाबंदी वाली कुंजियों को अस्वीकार किया गया: Gemini API, बिना पाबंदी वाली स्टैंडर्ड कुंजियों से किए गए अनुरोधों को अस्वीकार कर देता है. जिन स्टैंडर्ड एपीआई पासकोड पर साफ़ तौर पर पाबंदियां लागू की गई हैं वे काम करते रहेंगे. इस पाबंदी की वजह से, उन कुंजियों का इस्तेमाल बिना अनुमति के नहीं किया जा सकता जिन्हें सार्वजनिक तौर पर शेयर किया गया हो या जो अन्य सेवाओं से लिंक हों.

Google AI Studio में एपीआई पासकोड मैनेज करना

Google AI Studio में जाकर, अपने प्रोजेक्ट और कुंजियों को सीधे तौर पर मैनेज किया जा सकता है.

Google Cloud प्रोजेक्ट

हर Gemini API पासकोड, किसी Google Cloud प्रोजेक्ट से जुड़ा होता है. Google Cloud प्रोजेक्ट, बिलिंग, सहयोगियों, और अनुमतियों को मैनेज करते हैं. Google AI Studio, इन प्रोजेक्ट को ऐक्सेस करने के लिए एक आसान इंटरफ़ेस उपलब्ध कराता है.

• डिफ़ॉल्ट प्रोजेक्ट: अगर आप नए उपयोगकर्ता हैं, तो सेवा की शर्तें स्वीकार करने के बाद, Google AI Studio अपने-आप एक डिफ़ॉल्ट Google Cloud प्रोजेक्ट और एपीआई पासकोड बना देता है. इस प्रोजेक्ट का नाम बदलने के लिए, अपने डैशबोर्ड में प्रोजेक्ट व्यू पर जाएं.
• मौजूदा प्रोजेक्ट: अगर आपके पास पहले से कोई Google Cloud खाता है, तो AI Studio कोई डिफ़ॉल्ट प्रोजेक्ट नहीं बनाता. इसके बजाय, आपको अपने मौजूदा प्रोजेक्ट इंपोर्ट करने होंगे.

प्रोजेक्ट इंपोर्ट करना

डिफ़ॉल्ट रूप से, Google AI Studio आपके सभी Google Cloud प्रोजेक्ट नहीं दिखाता. आपको वे प्रोजेक्ट इंपोर्ट करने होंगे जिनका इस्तेमाल करना है:

1. Google AI Studio पर जाएं.
2. बाईं ओर मौजूद पैनल से डैशबोर्ड खोलें और प्रोजेक्ट को चुनें.
3. प्रोजेक्ट इंपोर्ट करें बटन पर क्लिक करें.
4. आपको जो Google Cloud प्रोजेक्ट इंपोर्ट करना है उसे खोजें और चुनें. इसके बाद, इंपोर्ट करें पर क्लिक करें.
5. इंपोर्ट करने के बाद, डैशबोर्ड में एपीआई पासकोड पेज पर जाएं, ताकि उस प्रोजेक्ट में पासकोड बनाया जा सके.

कुंजी बनाने की अनुमतियों से जुड़ी समस्याओं को हल करना

अगर एपीआई पासकोड बनाएं बटन उपलब्ध नहीं है और यह मैसेज दिखता है: "आपके पास इस प्रोजेक्ट में पासकोड बनाने की अनुमति नहीं है", तो इसका मतलब है कि आपके पास ज़रूरी आईएएम अनुमतियां नहीं हैं.

अपने Google Cloud प्रोजेक्ट या संगठन के एडमिन से, आपको ऐसी भूमिका देने के लिए कहें जिसमें ये अनुमतियां शामिल हों (जैसे, प्रोजेक्ट एडिटर):

• resourcemanager.projects.get: इससे AI Studio को प्रोजेक्ट की पुष्टि करने की अनुमति मिलती है.
• apikeys.keys.create: इससे पासकोड जनरेट किए जा सकते हैं.
• serviceusage.services.enable: इससे यह पक्का होता है कि Generative Language API चालू है.
• iam.serviceAccounts.create: लिंक की गई सेवा खाता बनाने के लिए ज़रूरी है.
• iam.serviceAccountApiKeyBindings.create: सेवा खाते को एपीआई पासकोड से बाइंड करता है.

अगर आपको एडमिन के तौर पर ऐक्सेस नहीं मिल पाता है, तो अपनी कुंजियां जनरेट करने के लिए, एक नया Google Cloud प्रोजेक्ट बनाएं. यह प्रोजेक्ट किसी संगठन से जुड़ा नहीं होना चाहिए.

इस्तेमाल से जुड़े पेज पर मौजूद अनजान कुंजियां

Google AI Studio में इस्तेमाल पेज, उन अनुरोधों को ग्रुप करता है जो प्रोजेक्ट में मौजूद किसी एपीआई पासकोड से मैच नहीं होते. ये अनुरोध, (unknown keys) में दिखते हैं. इसमें 30 दिन से पहले मिटाई गई कुंजियां, बिना डिसप्ले नेम वाली कुंजियां, और OAuth जैसे अन्य क्रेडेंशियल के साथ किए गए अनुरोध शामिल हैं.

Google Cloud Console में कुंजियां बनाना

Google AI Studio में सिर्फ़ ऐसे पासकोड दिखते हैं जिन पर कोई पाबंदी नहीं है या जिन पर Gemini API के लिए पाबंदी लगाई गई है. अगर आपको AI Studio का इस्तेमाल करने में समस्या आ रही है या आपको अपने सभी एपीआई पासकोड एक ही जगह पर मैनेज करने हैं, तो एपीआई पासकोड बनाने के बारे में Cloud के दस्तावेज़ में दिए गए निर्देशों का पालन करें. Gemini API पासकोड बनाने के लिए, उसे किसी सेवा खाते से बाइंड करना ज़रूरी है.

अपना एनवायरमेंट सेट अप करना

कुंजी मिलने के बाद, अपने एनवायरमेंट को कॉन्फ़िगर करें, ताकि ऐप्लिकेशन में इसका इस्तेमाल सुरक्षित तरीके से किया जा सके.

पहला विकल्प: एनवायरमेंट वैरिएबल का इस्तेमाल करना (सुझाया गया)

एनवायरमेंट वैरिएबल GEMINI_API_KEY या GOOGLE_API_KEY सेट करें. Gemini API की क्लाइंट लाइब्रेरी, इन वैरिएबल का अपने-आप पता लगाती हैं और उनका इस्तेमाल करती हैं. अगर दोनों नीतियां सेट हैं, तो GOOGLE_API_KEY को प्राथमिकता दी जाती है.

वैरिएबल सेट करने के लिए, अपना ऑपरेटिंग सिस्टम चुनें:

~/.bashrc

touch ~/.bashrc && open ~/.bashrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.bashrc

~/.zshrc

touch ~/.zshrc && open ~/.zshrc

export GEMINI_API_KEY=<YOUR_API_KEY_HERE>

source ~/.zshrc

दूसरा विकल्प: कोड में एपीआई पासकोड साफ़ तौर पर दें

क्लाइंट को शुरू करते समय, एपीआई पासकोड को साफ़ तौर पर पास किया जा सकता है. ऐसा सिर्फ़ तब करें, जब एनवायरमेंट वैरिएबल का इस्तेमाल न किया जा सके.

from google import genai

client = genai.Client(api_key="YOUR_API_KEY")

interaction = client.interactions.create(
    model="gemini-3.8-flash",
    input="Explain how AI works in a few words"
)
print(interaction.output_text)

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({ apiKey: "YOUR_API_KEY" });

async function main() {
  const interaction = await ai.interactions.create({
    model: "gemini-3.8-flash",
    input: "Explain how AI works in a few words",
  });
  console.log(interaction.output_text);
}

main();

import com.google.genai.Client;
import com.google.genai.gaos.models.interactions.CreateModelInteraction;
import com.google.genai.gaos.models.interactions.Interaction;
import com.google.genai.gaos.models.interactions.InteractionsInput;
import com.google.genai.gaos.models.interactions.Model;
import com.google.genai.gaos.models.operations.CreateInteractionRequestBody;

Client client = Client.builder().apiKey("YOUR_API_KEY").build();

CreateModelInteraction params =
    CreateModelInteraction.builder()
        .model(Model.of("gemini-3.8-flash"))
        .input(InteractionsInput.of("Explain how AI works in a few sentences."))
        .build();

Interaction interaction =
    client.interactions.create(CreateInteractionRequestBody.of(params)).interaction().get();

System.out.println(interaction.outputText().orElse(""));

package main

import (
    "context"
    "fmt"
    "log"

    "google.golang.org/genai"
    "google.golang.org/genai/interactions/models/interactions"
    "google.golang.org/genai/interactions/models/operations"
)

func main() {
    ctx := context.Background()
    client, err := genai.NewClient(ctx, &genai.ClientConfig{
        APIKey: "YOUR_API_KEY",
    })
    if err != nil {
        log.Fatal(err)
    }

    res, err := client.Interactions.Create(ctx, operations.CreateInteractionRequest{
        Body: operations.NewCreateInteractionRequestBody(interactions.CreateModelInteraction{
            Model: interactions.Model("gemini-3.8-flash"),
            Input: interactions.NewInteractionsInput("Explain how AI works in a few sentences."),
        }),
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Interaction.OutputText != nil {
        fmt.Println(*res.Interaction.OutputText)
    }
}

curl "https://generativelanguage.googleapis.com/v1beta/interactions" \
  -H 'Content-Type: application/json' \
  -H "x-goog-api-key: YOUR_API_KEY" \
  -X POST \
  -d '{
    "model": "gemini-3.8-flash",
    "input": "Explain how AI works in a few words"
  }'

सुरक्षा और सीक्रेट मैनेजमेंट

अपने Gemini API पासकोड को पासवर्ड की तरह सुरक्षित रखें. अगर एपीआई पासकोड के साथ छेड़छाड़ की जाती है, तो अन्य लोग आपके प्रोजेक्ट के कोटे का इस्तेमाल कर सकते हैं. इससे आपको अनचाहे शुल्क चुकाने पड़ सकते हैं. साथ ही, वे आपके निजी संसाधनों को ऐक्सेस कर सकते हैं.

सुरक्षा से जुड़े अहम नियम

• पासकोड गोपनीय रखें: एपीआई पासकोड को Git जैसे सोर्स कंट्रोल सिस्टम में कभी भी सेव न करें.
• प्रोडक्शन में, क्लाइंट-साइड पर पासकोड कभी न दिखाएं: वेब या मोबाइल ऐप्लिकेशन में, एपीआई पासकोड को सीधे तौर पर हार्डकोड न करें. क्लाइंट-साइड कोड में कंपाइल की गई कुंजियों को उपयोगकर्ता निकाल सकते हैं. क्लाइंट-साइड ऐप्लिकेशन को सुरक्षित रखने के लिए, असल एपीआई कॉल करने के लिए बैकएंड प्रॉक्सी सर्वर चलाएं.

सीक्रेट मैनेज करने के सबसे सही तरीके

• एनवायरमेंट वैरिएबल: कॉन्फ़िगरेशन फ़ाइलों के बजाय, एनवायरमेंट वैरिएबल से कुंजियां पढ़ें.
• Secret Manager: प्रोडक्शन के लिए, अपनी कुंजियों को किसी सुरक्षित सीक्रेट स्टोर में सेव करें. जैसे, Google Cloud Secret Manager.
• बिलिंग से जुड़ी सूचनाएं: Google Cloud Console में बिलिंग से जुड़ी सूचनाएं सेट अप करें, ताकि इस्तेमाल या लागत बढ़ने पर आपको सूचना मिल सके.

लीक होने पर जवाब देने के लिए चेकलिस्ट

अगर आपको लगता है कि आपका एपीआई पासकोड लीक हो गया है, तो:

1. नया पासकोड जनरेट करें: Google AI Studio या Cloud Console में जाकर, नया पासकोड बनाएं.
2. अपना ऐप्लिकेशन अपडेट करें: नए पासकोड का इस्तेमाल करके अपना कोड डिप्लॉय करें.
3. लीक हुई कुंजी को बंद करना या मिटाना: नई कुंजी की पुष्टि होने के बाद, Cloud Console में लीक हुई कुंजी को बंद करें. ऐप्लिकेशन के डाउनटाइम से बचने के लिए, पुरानी कुंजी को तब तक न मिटाएं, जब तक नई कुंजी पूरी तरह से चालू न हो जाए.
4. इस्तेमाल का ऑडिट करना: Google Cloud Console में बिलिंग लॉग और एपीआई के इस्तेमाल की जानकारी देखें, ताकि बिना अनुमति वाली गतिविधि का पता लगाया जा सके.

कुंजियों पर पाबंदी लगाना और उन्हें सुरक्षित करना

एपीआई पासकोड पर पाबंदियां लगाने से, पासकोड के हैक होने पर होने वाले नुकसान को कम किया जा सकता है.

अनुरोध के ऑरिजिन पर पाबंदियां लागू करना

ऑरिजिन से जुड़ी पाबंदियों से यह तय होता है कि कौनसे आईपी पते, वेबसाइटें या ऐप्लिकेशन आपकी कुंजी का इस्तेमाल कर सकते हैं.

1. Google Cloud console के क्रेडेंशियल पेज पर जाएं.
2. अपना प्रोजेक्ट चुनें और उस एपीआई पासकोड के नाम पर क्लिक करें जिस पर आपको पाबंदी लगानी है.
3. ऐप्लिकेशन से जुड़ी पाबंदियां में जाकर, आईपी पते चुनें या अपने एनवायरमेंट के लिए पाबंदी का सही टाइप चुनें.
4. अनुमति वाले आईपी पते या रेंज डालें. इसके बाद, सेव करें पर क्लिक करें.

बिना पाबंदी वाली स्टैंडर्ड एपीआई कुंजियों को सुरक्षित करना

Gemini API का इस्तेमाल जारी रखने के लिए, आपको उन सभी कुंजियों को सुरक्षित करना होगा जिन पर कोई पाबंदी नहीं लगाई गई है.

पहला तरीका: पासकोड को सिर्फ़ Gemini API (AI Studio) तक सीमित करना

अगर आपको सिर्फ़ Gemini API के लिए पासकोड का इस्तेमाल करना है, तो उसे सीधे AI Studio में सुरक्षित करें:

1. Google AI Studio में एपीआई पासकोड पेज पर, बिना किसी पाबंदी के लेबल वाले पासकोड ढूंढें.
2. लेबल पर कर्सर घुमाएं और डायलॉग बॉक्स में, पाबंदियां जोड़ें पर क्लिक करें.
3. सिर्फ़ Gemini API के लिए इस्तेमाल करें को चुनें.
4. पुष्टि करने के लिए, कुंजी पर पाबंदी लगाएं पर क्लिक करें.

दूसरा तरीका: अन्य सेवाओं के लिए एपीआई पासकोड पर पाबंदी लगाना (Google Cloud Console)

अगर पासकोड को अन्य Google API के साथ शेयर किया गया है (इसका सुझाव नहीं दिया जाता), तो Cloud Console में जाकर इस पर पाबंदी लगाएं. ध्यान दें: ये पाबंदियां लागू होने के बाद, इस कुंजी का इस्तेमाल करके किए गए Gemini API अनुरोध पूरे नहीं होंगे.

1. Google Cloud console के क्रेडेंशियल पेज पर जाएं.
2. प्रोजेक्ट और एपीआई पासकोड चुनें.
3. एपीआई से जुड़ी पाबंदियां में जाकर, एपीआई से जुड़ी पाबंदियां चुनें ड्रॉप-डाउन का इस्तेमाल करके, वे एपीआई चुनें जिन्हें इस पासकोड से ऐक्सेस करना है. Generative Language API को न चुनें.
4. सेव करें पर क्लिक करें. Gemini API का इस्तेमाल जारी रखने के लिए, AI Studio में एक अलग और प्रतिबंधित पासकोड बनाएं.

ब्लॉक की गई ऐसी कुंजियां जो इस्तेमाल नहीं की जा रही हैं

Gemini API, 7 मई, 2026 से उन एपीआई पासकोड को ब्लॉक कर देगा जिन पर कोई पाबंदी नहीं लगी है और जिनका इस्तेमाल लंबे समय से नहीं किया गया है. इन कुंजियों के लिए, AI Studio में ब्लॉक किया गया टैग दिखता है. जारी रखने के लिए, आपको नई कुंजी जनरेट करनी होगी या किसी मौजूदा प्रतिबंधित कुंजी का इस्तेमाल करना होगा.

पुष्टि करने वाली कुंजी पर माइग्रेट करना

नया ऑथराइज़ेशन एपीआई पासकोड बनाने और अपने ऐप्लिकेशन अपडेट करने के लिए, यह तरीका अपनाएं:

1. AI Studio के एपीआई पासकोड वाले पेज पर जाएं.
2. कुंजी का टाइप कॉलम देखें, ताकि स्टैंडर्ड के तौर पर लिस्ट की गई कुंजियों की पहचान की जा सके.
3. नया पासकोड जनरेट करने के लिए, एपीआई पासकोड बनाएं पर क्लिक करें. AI Studio में बनाई गई सभी नई कुंजियां, अपने-आप ऑथराइज़ेशन कुंजी के तौर पर बन जाती हैं.
4. पुष्टि करने के लिए नया एपीआई पासकोड कॉपी करें.
5. नए ऑथराइज़ेशन एपीआई पासकोड का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन कोड, एनवायरमेंट वैरिएबल, और डिप्लॉयमेंट कॉन्फ़िगरेशन को अपडेट करें.
6. अपने ऐप्लिकेशन की जांच करके पक्का करें कि वह नई कुंजी के साथ सही तरीके से काम कर रहा है.
7. पुष्टि होने के बाद, ट्रैफ़िक की पुरानी कुंजी को मिटा दें या रद्द कर दें, ताकि उसका गलत इस्तेमाल न हो.

सीमाएं

Google AI Studio में प्रोजेक्ट और एपीआई पासकोड मैनेज करने से जुड़ी ये सीमाएं लागू होती हैं:

• Google AI Studio के प्रोजेक्ट पेज से, एक बार में ज़्यादा से ज़्यादा 10 प्रोजेक्ट बनाए जा सकते हैं.
• एपीआई पासकोड और प्रोजेक्ट पेजों पर, ज़्यादा से ज़्यादा 100 पासकोड और 50 प्रोजेक्ट दिखते हैं.
• सिर्फ़ वे एपीआई पासकोड दिखते हैं जिन पर कोई पाबंदी नहीं है या जिन पर सिर्फ़ Generative Language API (Gemini API) के लिए पाबंदी लगाई गई है.

प्रोजेक्ट को बेहतर तरीके से मैनेज करने या अन्य पाबंदियों के साथ कुंजियों में बदलाव करने के लिए, Google Cloud console के क्रेडेंशियल पेज का इस्तेमाल करें.