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

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

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

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

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

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

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

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

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 प्रोजेक्ट बनाया जा सकता है. यह प्रोजेक्ट किसी संगठन से जुड़ा नहीं होना चाहिए.

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

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

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

एनवायरमेंट वैरिएबल 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")

response = client.models.generate_content(
    model="gemini-3.5-flash",
    contents="Explain how AI works in a few words"
)
print(response.text)

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

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

async function main() {
  const response = await ai.models.generateContent({
    model: "gemini-3.5-flash",
    contents: "Explain how AI works in a few words",
  });
  console.log(response.text);
}

main();

package main

import (
    "context"
    "fmt"
    "log"
    "google.golang.org/genai"
)

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

    result, err := client.Models.GenerateContent(
        ctx,
        "gemini-3.5-flash",
        genai.Text("Explain how AI works in a few words"),
        nil,
    )
    if err != nil {
        log.Fatal(err)
    }
    fmt.Println(result.Text())
}

package com.example;

import com.google.genai.Client;
import com.google.genai.types.GenerateContentResponse;

public class GenerateTextFromTextInput {
  public static void main(String[] args) {
    Client client = Client.builder().apiKey("YOUR_API_KEY").build();

    GenerateContentResponse response =
        client.models.generateContent(
            "gemini-3.5-flash",
            "Explain how AI works in a few words",
            null);

    System.out.println(response.text());
  }
}

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-3.5-flash:generateContent"       -H 'Content-Type: application/json'       -H "x-goog-api-key: YOUR_API_KEY"       -X POST       -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "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. अनुमति वाले आईपी पते या रेंज डालें. इसके बाद, सेव करें पर क्लिक करें.

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

19 जून, 2026 के बाद भी Gemini API का इस्तेमाल जारी रखने के लिए, आपको बिना किसी पाबंदी वाले सभी पासकोड सुरक्षित करने होंगे.

AI Studio के ज़रिए, पासकोड को सिर्फ़ Gemini API के लिए सीमित करें

अगर आपको सिर्फ़ 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. एपीआई से जुड़ी पाबंदियां में जाकर, कुंजी को सीमित करें को चुनें.
4. ड्रॉप-डाउन से, वे एपीआई चुनें जिन्हें इस पासकोड से ऐक्सेस करना है. Generative Language API को न चुनें.
5. सेव करें पर क्लिक करें. 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 के क्रेडेंशियल पेज का इस्तेमाल करें.