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

Gemini API का इस्तेमाल करने के लिए, आपके पास एपीआई पासकोड होना चाहिए. Google AI Studio में जाकर, कुछ क्लिक में बिना किसी शुल्क के पासकोड बनाया जा सकता है.

एपीआई पासकोड मिलने के बाद, Gemini 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-2.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-2.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-2.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-2.5-flash",
            "Explain how AI works in a few words",
            null);

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

curl "https://generativelanguage.googleapis.com/v1beta/models/gemini-2.5-flash:generateContent?key=$YOUR_API_KEY" \
  -H 'Content-Type: application/json' \
  -X POST \
  -d '{
    "contents": [
      {
        "parts": [
          {
            "text": "Explain how AI works in a few words"
          }
        ]
      }
    ]
  }'

अपनी एपीआई पासकोड को सुरक्षित रखना

अपने Gemini API पासकोड को सुरक्षित रखना ज़रूरी है. Gemini API पासकोड का इस्तेमाल करते समय, इन बातों का ध्यान रखें:

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

• एपीआई पासकोड पर पाबंदियां जोड़ने से, हर एपीआई पासकोड के ज़रिए इस्तेमाल किए जा सकने वाले प्लैटफ़ॉर्म को सीमित किया जा सकता है.

• Gemini API पासकोड को सुरक्षित रखने की ज़िम्मेदारी आपकी है.

  • सोर्स कंट्रोल में Gemini API पासकोड शामिल न करें.
  • क्लाइंट-साइड ऐप्लिकेशन (वेब और Dart/Flutter) में, एपीआई पासकोड को एक्सपोज़ होने का खतरा होता है. हमारा सुझाव है कि सीधे अपने वेब ऐप्लिकेशन से Google एआई Gemini API को कॉल करने के लिए, प्रोडक्शन ऐप्लिकेशन में Google एआई क्लाइंट SDK का इस्तेमाल न करें.

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