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

Gemini API का इस्तेमाल करने के लिए, एपीआई पासकोड की ज़रूरत होती है. इस पेज पर, Google AI Studio में पासकोड बनाने और मैनेज करने का तरीका बताया गया है. साथ ही, यह भी बताया गया है कि अपने कोड में पासकोड का इस्तेमाल करने के लिए, एनवायरमेंट को कैसे सेट अप किया जाए.

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

एपीआई पासकोड

Google AI Studio के एपीआई पासकोड एपीआई पासकोड पेज से, Gemini API के सभी पासकोड बनाए और मैनेज किए जा सकते हैं.

एपीआई पासकोड मिलने के बाद, Gemini API से कनेक्ट करने के लिए आपके पास ये विकल्प होते हैं:

• एपीआई पासकोड को एनवायरमेंट वैरिएबल के तौर पर सेट करना
• एपीआई पासकोड साफ़ तौर पर देना

शुरुआती टेस्टिंग के लिए, एपीआई पासकोड को हार्ड कोड किया जा सकता है. हालांकि, यह सिर्फ़ अस्थायी तौर पर किया जाना चाहिए, क्योंकि यह सुरक्षित नहीं है. एपीआई पासकोड को हार्ड कोड करने के उदाहरण, साफ़ तौर पर एपीआई पासकोड देना सेक्शन में देखे जा सकते हैं.

Google Cloud प्रोजेक्ट

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

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

डिफ़ॉल्ट प्रोजेक्ट

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

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

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

अगर आपने अब तक कोई प्रोजेक्ट इंपोर्ट नहीं किया है, तो Google Cloud प्रोजेक्ट इंपोर्ट करने और पासकोड बनाने के लिए, यह तरीका अपनाएं:

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

किसी प्रोजेक्ट को इंपोर्ट करने के बाद, डैशबोर्ड मेन्यू से एपीआई पासकोड पेज पर जाएं और उस प्रोजेक्ट में एक एपीआई पासकोड बनाएं जिसे आपने अभी इंपोर्ट किया है.

सीमाएं

Google AI Studio में, एपीआई पासकोड और Google Cloud प्रोजेक्ट मैनेज करने की ये सीमाएं हैं.

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

अपने प्रोजेक्ट के लिए, मैनेजमेंट का अतिरिक्त ऐक्सेस पाने के लिए, Google Cloud Console के क्रेडेंशियल पेज पर जाएं. यहां एपीआई पासकोड में बदलाव किया जा सकता है और उन पर पाबंदियां लगाई जा सकती हैं. Cloud Console में, अपना प्रोजेक्ट चुनें. इसके बाद, किसी मौजूदा एपीआई पासकोड पर क्लिक करें और उसे Generative Language API के इस्तेमाल तक सीमित करें.

एपीआई पासकोड को एनवायरमेंट वैरिएबल के तौर पर सेट करना

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

अगर REST API या ब्राउज़र पर JavaScript का इस्तेमाल किया जा रहा है, तो आपको एपीआई पासकोड साफ़ तौर पर देना होगा.

यहां बताया गया है कि अलग-अलग ऑपरेटिंग सिस्टम के साथ, एपीआई पासकोड को स्थानीय तौर पर एनवायरमेंट वैरिएबल GEMINI_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

एपीआई पासकोड साफ़ तौर पर देना

कुछ मामलों में, आपको एपीआई पासकोड साफ़ तौर पर देना पड़ सकता है. उदाहरण के लिए:

• आपको एपीआई का कोई सामान्य कॉल करना है और एपीआई पासकोड को हार्ड कोड करना है.
• आपको साफ़ तौर पर कंट्रोल चाहिए. इसके लिए, Gemini API की लाइब्रेरी से एनवायरमेंट वैरिएबल की अपने-आप खोज होने पर निर्भर नहीं रहना है
• आपको ऐसे एनवायरमेंट का इस्तेमाल करना है जहां एनवायरमेंट वैरिएबल काम नहीं करते (जैसे, वेब) या आपको REST कॉल करने हैं.

यहां कुछ उदाहरण दिए गए हैं, जिनसे पता चलता है कि एपीआई पासकोड साफ़ तौर पर कैसे दिया जा सकता है:

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 पासकोड को पासवर्ड की तरह इस्तेमाल करें. अगर यह पासकोड किसी और के हाथ लग जाता है, तो वे आपके प्रोजेक्ट के कोटे का इस्तेमाल कर सकते हैं, शुल्क चुका सकते हैं (अगर बिलिंग की सुविधा चालू है), और आपका निजी डेटा ऐक्सेस कर सकते हैं. जैसे, फ़ाइलें.

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

• पासकोड को गोपनीय रखें: Gemini के एपीआई पासकोड से, संवेदनशील डेटा को ऐक्सेस किया जा सकता है. इस डेटा पर आपका ऐप्लिकेशन निर्भर करता है.

  • एपीआई पासकोड को सोर्स कंट्रोल में कभी सबमिट न करें. अपने एपीआई पासकोड को Git जैसे वर्शन कंट्रोल सिस्टम में कभी सबमिट न करें.

  • एपीआई पासकोड को क्लाइंट-साइड पर कभी न दिखाएं. अपने एपीआई पासकोड का इस्तेमाल, प्रोडक्शन में वेब या मोबाइल ऐप्लिकेशन में सीधे तौर पर न करें. क्लाइंट-साइड कोड (इसमें हमारी JavaScript/TypeScript लाइब्रेरी और REST कॉल शामिल हैं) में मौजूद पासकोड को एक्सट्रैक्ट किया जा सकता है.

• ऐक्सेस सीमित करें: जहां भी मुमकिन हो, एपीआई पासकोड के इस्तेमाल को खास आईपी पतों, एचटीटीपी रेफ़रर या Android/iOS ऐप्लिकेशन तक सीमित करें.

• इस्तेमाल सीमित करें: हर पासकोड के लिए, सिर्फ़ ज़रूरी एपीआई चालू करें.

• समय-समय पर ऑडिट करें: अपने एपीआई पासकोड का समय-समय पर ऑडिट करें और उन्हें समय-समय पर रोटेट करें.

सबसे सही तरीके

• एपीआई पासकोड के साथ सर्वर-साइड कॉल का इस्तेमाल करें एपीआई पासकोड का इस्तेमाल करने का सबसे सुरक्षित तरीका यह है कि Gemini API को सर्वर-साइड ऐप्लिकेशन से कॉल किया जाए. इससे पासकोड को गोपनीय रखा जा सकता है.

• क्लाइंट-साइड ऐक्सेस के लिए, कुछ समय के लिए मान्य टोकन का इस्तेमाल करें (सिर्फ़ Live API के लिए): Live API को क्लाइंट-साइड से सीधे ऐक्सेस करने के लिए, कुछ समय के लिए मान्य टोकन का इस्तेमाल किया जा सकता है. इनसे सुरक्षा से जुड़े जोखिम कम होते हैं और इनका इस्तेमाल प्रोडक्शन के लिए किया जा सकता है. ज़्यादा जानकारी के लिए, कुछ समय के लिए मान्य टोकन की गाइड देखें.

• अपनी कुंजी में पाबंदियां जोड़ने पर विचार करें: आप एपीआई कुंजी पाबंदियां जोड़कर किसी कुंजी की अनुमतियों को सीमित कर सकते हैं. इससे, पासकोड लीक होने पर होने वाले संभावित नुकसान को कम किया जा सकता है.

कुछ सामान्य सबसे सही तरीकों के बारे में जानने के लिए, सहायता से जुड़ा यह लेख भी पढ़ें.

बिना पाबंदी वाले एपीआई पासकोड को सुरक्षित रखना

बिना पाबंदी वाले एपीआई पासकोड, गलत लोगों और अनधिकृत इस्तेमाल के लिए संवेदनशील होते हैं. सुरक्षा को बेहतर बनाने के लिए, Gemini API, 19 जून, 2026 से बिना पाबंदी वाले ट्रैफ़िक पासकोड के लिए सहायता बंद कर देगा.

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

Gemini API का इस्तेमाल बिना किसी रुकावट के जारी रखने के लिए, AI Studio में पाबंदियां जोड़कर, अपने ट्रैफ़िक पासकोड को सुरक्षित रखें.

aistudio.google.com/api-keys पर, आपको एक बैनर दिखेगा. इससे आपको यह सूचना मिलेगी कि एपीआई पासकोड पर कोई पाबंदी नहीं है. यहां यह देखा जा सकता है कि किन पासकोड पर कोई पाबंदी नहीं है. साथ ही, पिछले 90 दिनों में सेवा का कितना इस्तेमाल किया गया है.

बिना पाबंदी वाले पासकोड के लिए, आपको इनमें से कोई एक विकल्प चुनना होगा:

• सिर्फ़ Gemini API के लिए पासकोड का इस्तेमाल करें.
• Gemini API के अलावा किसी अन्य एपीआई के लिए पासकोड का इस्तेमाल करें.

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

अगर आपको पासकोड को सिर्फ़ Gemini API के इस्तेमाल तक सीमित करना है, तो AI Studio में सिर्फ़ Gemini API के इस्तेमाल तक सीमित करें बटन पर क्लिक करके, अपने पासकोड को सुरक्षित रखें.

पासकोड को Gemini API के अलावा किसी अन्य एपीआई के इस्तेमाल तक सीमित करना

अगर आपको पासकोड को Gemini API के अलावा किसी अन्य एपीआई के इस्तेमाल तक सीमित करना है, तो:

1. Google Cloud Console के क्रेडेंशियल पेज पर जाएं .
2. पक्का करें कि सही प्रोजेक्ट चुना गया हो.
3. कोई एपीआई पासकोड चुनें.
4. एपीआई की पाबंदियां ड्रॉपडाउन को बड़ा करें और एपीआई पासकोड पर सेवा की पाबंदियां लागू करें.

अगर आपको मौजूदा या नई जोड़ी गई पाबंदियों वाले पासकोड में बदलाव करना है, तो Google Cloud Console पर जाएं.

ब्लॉक किए गए पासकोड

Gemini API, 7 मई, 2026 से बिना पाबंदी वाले उन एपीआई पासकोड को ब्लॉक कर देगा जो लंबे समय से इस्तेमाल नहीं किए गए हैं. ऐसे उपयोगकर्ताओं को aistudio.google.com/api-keys पर अपने पासकोड के लिए, ब्लॉक किया गया टैग दिखेगा. Gemini API का इस्तेमाल जारी रखने के लिए, उन्हें एक नया पासकोड जनरेट करना होगा या पाबंदी वाले किसी दूसरे पासकोड का इस्तेमाल करना होगा.

एपीआई पासकोड बनाने में आने वाली समस्याएं हल करना

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

ऐसा तब होता है, जब आपके पास नया पासकोड जनरेट करने के लिए, प्रोजेक्ट में ज़रूरी अनुमतियां नहीं होती हैं:

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

अपनी अनुमतियों से जुड़ी समस्या को हल करने के लिए, अपने प्रोजेक्ट के एडमिन से संपर्क करें. अगर प्रोजेक्ट किसी संगठन का है, तो संगठन के एडमिन से संपर्क करें. उनसे ऊपर बताई गई अनुमतियों वाली भूमिका (जैसे, प्रोजेक्ट एडिटर या कोई कस्टम भूमिका) देने के लिए कहें.

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

Google AI Studio की सभी सुविधाओं (जैसे, इस्तेमाल, दर की सीमाएं या बिलिंग देखना) के लिए ज़रूरी आईएएम अनुमतियों की पूरी सूची देखने के लिए, AI Studio की समस्या हल करने की गाइड देखें.