Sebagian atau seluruh informasi di halaman ini mungkin tidak berlaku untuk Cloud de Confiance dari S3NS. Lihat Perbedaan dengan Google Cloud untuk mengetahui detail selengkapnya.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Grounding dengan Penelusuran Web Paralel

Parallel Web Systems menawarkan API penelusuran yang menyediakan akses ke data web yang tersedia secara publik dan dioptimalkan untuk digunakan oleh model bahasa besar (LLM) untuk grounding. Halaman ini menjelaskan cara melakukan grounding pada respons Gemini menggunakan Parallel.

Grounding dengan Parallel di Gemini Enterprise Agent Platform adalah Penawaran Terpisah (sebagaimana didefinisikan dalam Cloud de Confiance by S3NS Perjanjian Anda) yang menghubungkan model Gemini ke data web publik yang disediakan oleh API penelusuran Parallel Web Systems. Layanan ini memberi Gemini akses ke informasi langsung dari miliaran halaman web untuk memastikan respons yang lebih terbaru dan faktual.

Kasus penggunaan

Perujukan dengan Paralel cocok untuk kasus penggunaan seperti berikut:

Menggunakan data web untuk tujuan pelengkapan atau peningkatan kualitas informasi.
Agen multi-hop yang memerlukan penelusuran web lebih mendalam untuk pertanyaan yang lebih kompleks.
Membangun API yang mengintegrasikan data penelusuran web.
Asisten yang ditampilkan kepada karyawan yang memungkinkan pengguna akhir mengajukan pertanyaan dan membuat laporan kompleks menggunakan informasi web terbaru.
Aplikasi yang ditujukan untuk konsumen, seperti retail dan perjalanan, yang memungkinkan pengguna membuat keputusan pembelian yang tepat.
Agen otomatis yang berjalan secara mandiri untuk melakukan tugas otomatis, seperti analisis berita dan pemeriksaan KYC.
Agen vertikal (agen penjualan, agen coding, agen keuangan) mendapatkan konteks terbaru dari web.

Contoh

Siapa yang memenangkan Las Vegas F1 Grand Prix 2025?

Tanpa Grounding	Dengan Grounding
Grand Prix Las Vegas 2025 belum berlangsung. Balapan dijadwalkan berlangsung pada akhir pekan 20-22 November 2025. Oleh karena itu, pemenangnya tidak diketahui.	Pemenang Las Vegas F1 Grand Prix 2025 adalah Max Verstappen dari Red Bull Racing. Balapan berlangsung pada 22 November 2025. Sumber: domain1.com, domain2.com, ...

Model yang didukung

Bagian ini mencantumkan model yang mendukung grounding dengan Penelusuran web paralel.

Klik untuk meluaskan model yang didukung

Sebelum memulai

Untuk menggunakan Grounding dengan Penelusuran Web Paralel, Anda harus menyiapkan akses Anda. Anda memiliki dua opsi:

Berlangganan langsung ke Grounding dengan Penelusuran Web Paralel di Google Cloud Marketplace untuk integrasi yang efisien dalam lingkungan cloud yang ada. Penawaran Retensi Data Nol juga tersedia untuk workload sensitif. Untuk menggunakan ZDR, Anda harus berlangganan penawaran ZDR dan menetapkan flag enable_zero_data_retention yang sesuai dalam permintaan API Anda.
Menggunakan kunci API Parallel yang ada.

Dengan mengintegrasikan melalui Google Cloud Marketplace, Anda dapat mengelola layanan Grounding dengan Penelusuran Web Paralel langsung di dalam Cloud de Confiance by S3NS. Untuk memulai, berlangganan layanan Perujukan dengan Penelusuran Web Paralel di Google Cloud Marketplace, setujui persyaratan layanan, dan tinjau harga.

Membawa kunci API Anda sendiri

Jika Anda lebih suka mengelola penagihan dan akses API Parallel secara terpisah, Anda dapat memberikan kunci API Anda sendiri. Untuk menggunakan metode ini, Anda perlu mendapatkan kunci API dari platform developer Parallel. Kunci API ini digunakan langsung dalam permintaan REST API Anda ke Gemini.

Menyertakan informasi dari Parallel dalam respons Gemini

Minta respons yang memiliki rujukan dari Gemini menggunakan Agent Studio di Cloud de Confiance konsol, Google Gen AI SDK, atau REST API. Untuk performa terbaik, sebaiknya gunakan setelan default untuk parameter opsional, kecuali jika Anda benar-benar memerlukan nilai non-default.

Jika Anda berlangganan Grounding dengan Penelusuran Web Paralel di Google Cloud Marketplace , pastikan akun penagihan yang digunakan untuk langganan Anda aktif di projectCloud de Confiance by S3NS Anda.

Sebelum menjalankan contoh, selesaikan prasyarat, termasuk berlangganan di Google Cloud Marketplace atau memberikan kunci API Parallel.

Konsol

Untuk melakukan grounding pada respons Gemini dengan Penelusuran Web Paralel menggunakan Agent Studio di Gemini Enterprise Agent Platform, ikuti langkah-langkah berikut:

Di konsol Cloud de Confiance , buka halaman Agent Studio.

Buka Agent Studio
Di panel samping, di bagian Model settings, di bagian Grounding, aktifkan tombol Partners (Hasil penelusuran dari grounding partners).
Pilih Penelusuran Web Paralel sebagai partner grounding, lalu klik Apply. Untuk menggunakan Penelusuran Web Paralel, Anda harus berlangganan terlebih dahulu di Google Cloud Marketplace.
Masukkan perintah Anda di kotak teks dan kirimkan.

Respons perintah Anda kini menggunakan Grounding dengan Penelusuran Web Paralel.

Python

Instal

pip install --upgrade google-genai

Untuk mempelajari lebih lanjut, lihat dokumentasi referensi SDK.

Tetapkan variabel lingkungan untuk menggunakan Google Gen AI SDK dengan Vertex AI:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

Sebelum menjalankan sampel, lakukan penggantian berikut:

MODEL_ID: ID model yang didukung untuk digunakan, seperti gemini-2.5-flash.
TEXT: Perintah teks yang akan dikirim ke model.
API_KEY: Kunci API Anda untuk Penelusuran Web Paralel. Hapus parameter ini jika Anda berlangganan di Google Cloud Marketplace; jika keduanya diberikan, kunci API akan diprioritaskan.
EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari sumber perujukan. Jika ditentukan, sumber dari domain ini akan dikecualikan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam sumber perujukan. Jika ditentukan, sumber dari domain ini akan disertakan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
MAX_CHARS_PER_RESULT: Opsional: Jumlah maksimum karakter yang akan disertakan dalam setiap kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 30000. Rentang yang diizinkan adalah [1000, 100000].
MAX_CHARS_TOTAL: Opsional: Jumlah total maksimum karakter dari semua kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 100000. Rentang yang diizinkan adalah [1000, 1000000].
MAX_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk perujukan. Jika tidak ditentukan, setelan defaultnya adalah 10. Rentang yang diizinkan adalah [1, 20].
MODE: Opsional: Mode yang akan digunakan untuk permintaan, yaitu basic atau advanced. Defaultnya adalah basic. Pertimbangkan mode advanced jika Anda menginginkan hasil penelusuran yang lebih menyeluruh dengan mengorbankan latensi yang lebih tinggi.
SEARCH_LOCATION: Opsional: Kode negara ISO 3166-1 alpha-2 untuk hasil penelusuran yang ditargetkan secara geografis. Contoh: "us".

from google import genai
from google.genai import types

client = genai.Client()

response = client.models.generate_content(
    model="MODEL_ID",
    contents="TEXT",
    config=types.GenerateContentConfig(
        tools=[
            types.Tool(
                parallel_ai_search=types.ToolParallelAiSearch(
                    # Optional. Omit api_key if you subscribed to Grounding with
                    # Parallel Web Search on Google Cloud Marketplace.
                    api_key="API_KEY",
                    # Optional. Set to True to use Zero Data Retention (ZDR) for
                    # sensitive workloads. Requires a separate ZDR Marketplace
                    # subscription; defaults to the standard subscription.
                    enable_zero_data_retention=True,
                    # Optional. Customize the search. Click a placeholder to
                    # enter a value, or remove the line to accept the default.
                    custom_configs={
                        "mode": "MODE",
                        "location": "SEARCH_LOCATION",
                        "max_results": MAX_RESULTS,
                        "source_policy": {
                            "exclude_domains": ["EXCLUDE_DOMAINS"],
                            "include_domains": ["INCLUDE_DOMAINS"],
                        },
                        "excerpts": {
                            "max_chars_per_result": MAX_CHARS_PER_RESULT,
                            "max_chars_total": MAX_CHARS_TOTAL,
                        },
                    },
                )
            )
        ],
    ),
)

print(response.text)
# Example response:
# Max Verstappen won the 2025 Las Vegas F1 Grand Prix ...

# The grounding metadata contains the web sources used to ground the response.
print(response.candidates[0].grounding_metadata.grounding_chunks)

Java

Pelajari cara menginstal atau mengupdate Java.

Untuk mempelajari lebih lanjut, lihat dokumentasi referensi SDK.

Tetapkan variabel lingkungan untuk menggunakan Google Gen AI SDK dengan Vertex AI:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

Sebelum menjalankan contoh, lakukan penggantian berikut:

MODEL_ID: ID model yang didukung untuk digunakan, seperti gemini-2.5-flash.
TEXT: Perintah teks yang akan dikirim ke model.
API_KEY: Kunci API Anda untuk Penelusuran Web Paralel. Hapus parameter ini jika Anda berlangganan di Google Cloud Marketplace; jika keduanya diberikan, kunci API akan diprioritaskan.
EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari sumber perujukan. Jika ditentukan, sumber dari domain ini akan dikecualikan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam sumber perujukan. Jika ditentukan, sumber dari domain ini akan disertakan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
MAX_CHARS_PER_RESULT: Opsional: Jumlah maksimum karakter yang akan disertakan dalam setiap kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 30000. Rentang yang diizinkan adalah [1000, 100000].
MAX_CHARS_TOTAL: Opsional: Jumlah total maksimum karakter dari semua kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 100000. Rentang yang diizinkan adalah [1000, 1000000].
MAX_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk perujukan. Jika tidak ditentukan, setelan defaultnya adalah 10. Rentang yang diizinkan adalah [1, 20].
MODE: Opsional: Mode yang akan digunakan untuk permintaan, yaitu basic atau advanced. Defaultnya adalah basic. Pertimbangkan mode advanced jika Anda menginginkan hasil penelusuran yang lebih menyeluruh dengan mengorbankan latensi yang lebih tinggi.
SEARCH_LOCATION: Opsional: Kode negara ISO 3166-1 alpha-2 untuk hasil penelusuran yang ditargetkan secara geografis. Contoh: "us".

import com.google.genai.Client;
import com.google.genai.types.GenerateContentConfig;
import com.google.genai.types.GenerateContentResponse;
import com.google.genai.types.Tool;
import com.google.genai.types.ToolParallelAiSearch;
import java.util.List;
import java.util.Map;

public class ParallelGroundingSample {
  public static void main(String[] args) {
    try (Client client = Client.builder().build()) {

      GenerateContentConfig config =
          GenerateContentConfig.builder()
              .tools(
                  Tool.builder()
                      .parallelAiSearch(
                          ToolParallelAiSearch.builder()
                              // Optional. Omit apiKey if you subscribed to
                              // Grounding with Parallel Web Search on Google
                              // Cloud Marketplace.
                              .apiKey("API_KEY")
                              // Optional. Set to true to use Zero Data
                              // Retention (ZDR) for sensitive workloads.
                              // Requires a separate ZDR Marketplace
                              // subscription; defaults to the standard
                              // subscription.
                              .enableZeroDataRetention(true)
                              // Optional. Customize the search. Click a
                              // placeholder to enter a value, or remove the
                              // entry to accept the default.
                              .customConfigs(
                                  Map.of(
                                      "mode", "MODE",
                                      "location", "SEARCH_LOCATION",
                                      "max_results", MAX_RESULTS,
                                      "source_policy",
                                      Map.of(
                                          "exclude_domains",
                                          List.of("EXCLUDE_DOMAINS"),
                                          "include_domains",
                                          List.of("INCLUDE_DOMAINS")),
                                      "excerpts",
                                      Map.of(
                                          "max_chars_per_result",
                                          MAX_CHARS_PER_RESULT,
                                          "max_chars_total",
                                          MAX_CHARS_TOTAL)))
                              .build())
                      .build())
              .build();

      GenerateContentResponse response =
          client.models.generateContent(
              "MODEL_ID", "TEXT", config);

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

Node.js

Instal

npm install @google/genai

Untuk mempelajari lebih lanjut, lihat dokumentasi referensi SDK.

Tetapkan variabel lingkungan untuk menggunakan Google Gen AI SDK dengan Vertex AI:

# Replace the `GOOGLE_CLOUD_PROJECT` and `GOOGLE_CLOUD_LOCATION` values
# with appropriate values for your project.
export GOOGLE_CLOUD_PROJECT=GOOGLE_CLOUD_PROJECT
export GOOGLE_CLOUD_LOCATION=global
export GOOGLE_GENAI_USE_ENTERPRISE=True

Sebelum menjalankan sampel, lakukan penggantian berikut:

MODEL_ID: ID model yang didukung untuk digunakan, seperti gemini-2.5-flash.
TEXT: Perintah teks yang akan dikirim ke model.
API_KEY: Kunci API Anda untuk Penelusuran Web Paralel. Hapus parameter ini jika Anda berlangganan di Google Cloud Marketplace; jika keduanya diberikan, kunci API akan diprioritaskan.
EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari sumber perujukan. Jika ditentukan, sumber dari domain ini akan dikecualikan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam sumber perujukan. Jika ditentukan, sumber dari domain ini akan disertakan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
MAX_CHARS_PER_RESULT: Opsional: Jumlah maksimum karakter yang akan disertakan dalam setiap kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 30000. Rentang yang diizinkan adalah [1000, 100000].
MAX_CHARS_TOTAL: Opsional: Jumlah total maksimum karakter dari semua kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 100000. Rentang yang diizinkan adalah [1000, 1000000].
MAX_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk perujukan. Jika tidak ditentukan, setelan defaultnya adalah 10. Rentang yang diizinkan adalah [1, 20].
MODE: Opsional: Mode yang akan digunakan untuk permintaan, baik basic atau advanced. Defaultnya adalah basic. Pertimbangkan mode advanced jika Anda menginginkan hasil penelusuran yang lebih menyeluruh dengan mengorbankan latensi yang lebih tinggi.
SEARCH_LOCATION: Opsional: Kode negara ISO 3166-1 alpha-2 untuk hasil penelusuran yang ditargetkan secara geografis. Contoh: "us".

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

const ai = new GoogleGenAI({});

const response = await ai.models.generateContent({
  model: 'MODEL_ID',
  contents: 'TEXT',
  config: {
    tools: [
      {
        parallelAiSearch: {
          // Optional. Omit apiKey if you subscribed to Grounding with Parallel
          // Web Search on Google Cloud Marketplace.
          apiKey: 'API_KEY',
          // Optional. Set to true to use Zero Data Retention (ZDR) for
          // sensitive workloads. Requires a separate ZDR Marketplace
          // subscription; defaults to the standard subscription.
          enableZeroDataRetention: true,
          // Optional. Customize the search. Click a placeholder to enter a
          // value, or remove the line to accept the default.
          customConfigs: {
            mode: 'MODE',
            location: 'SEARCH_LOCATION',
            max_results: MAX_RESULTS,
            source_policy: {
              exclude_domains: ['EXCLUDE_DOMAINS'],
              include_domains: ['INCLUDE_DOMAINS'],
            },
            excerpts: {
              max_chars_per_result: MAX_CHARS_PER_RESULT,
              max_chars_total: MAX_CHARS_TOTAL,
            },
          },
        },
      },
    ],
  },
});

console.log(response.text);

REST

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

LOCATION: Region untuk memproses permintaan. Untuk menggunakan endpoint global, kecualikan lokasi dari nama endpoint dan konfigurasikan lokasi resource ke `global`.
PROJECT_ID: Project ID Cloud de Confiance by S3NS Anda.
MODEL_ID: ID model yang didukung untuk digunakan, seperti gemini-2.5-flash.
TEXT: Perintah teks yang akan dikirim ke model.
API_KEY: Kunci API Anda untuk Penelusuran Web Paralel. Hapus parameter ini jika Anda berlangganan di Google Cloud Marketplace; jika keduanya diberikan, kunci API akan diprioritaskan.
EXCLUDE_DOMAINS: Opsional: Daftar domain yang akan dikecualikan dari sumber perujukan. Jika ditentukan, sumber dari domain ini akan dikecualikan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
INCLUDE_DOMAINS: Opsional: Daftar domain yang akan disertakan dalam sumber perujukan. Jika ditentukan, sumber dari domain ini akan disertakan. Nilai yang dapat diterima adalah domain (www.example.com) atau ekstensi domain yang diawali dengan titik ( .gov, .edu, .co.uk). Anda dapat menentukan hingga 200 domain.
MAX_CHARS_PER_RESULT: Opsional: Jumlah maksimum karakter yang akan disertakan dalam setiap kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 30000. Rentang yang diizinkan adalah [1000, 100000].
MAX_CHARS_TOTAL: Opsional: Jumlah total maksimum karakter dari semua kutipan hasil penelusuran. Jika tidak ditentukan, setelan defaultnya adalah 100000. Rentang yang diizinkan adalah [1000, 1000000].
MAX_RESULTS: Opsional: Jumlah maksimum hasil penelusuran yang akan digunakan untuk perujukan. Jika tidak ditentukan, setelan defaultnya adalah 10. Rentang yang diizinkan adalah [1, 20].
MODE: Opsional: Mode yang akan digunakan untuk permintaan, yaitu basic atau advanced. Defaultnya adalah basic. Pertimbangkan mode advanced jika Anda menginginkan hasil penelusuran yang lebih menyeluruh dengan mengorbankan latensi yang lebih tinggi.
SEARCH_LOCATION: Opsional: Kode negara ISO 3166-1 alpha-2 untuk hasil penelusuran yang ditargetkan secara geografis. Contoh: "us".
ENABLE_ZERO_DATA_RETENTION: Opsional: Beralih ke Penelusuran Web Paralel versi ZDR untuk mengaktifkan Zero Data Retention pada workload sensitif. Tetapkan ke true untuk menggunakan penawaran ZDR untuk permintaan Anda. Anda harus berlangganan penawaran khusus ZDR agar permintaan ini berhasil. Jika tidak ditentukan, nilai defaultnya adalah versi standar. Versi ZDR hanya tersedia melalui Google Cloud Marketplace.

Metode HTTP dan URL:

POST https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent

Meminta isi JSON:

{
  "contents": [{
    "role": "user",
    "parts": [{
      "text": "TEXT"
    }]
  }],
  "tools": [{
    "parallelAiSearch": {
        "api_key": "API_KEY",
        "enable_zero_data_retention": ENABLE_ZERO_DATA_RETENTION,
        "customConfigs": {
            "mode": "MODE",
            "location": "SEARCH_LOCATION",
            "max_results": MAX_RESULTS,
            "source_policy": {
                "exclude_domains": ["EXCLUDE_DOMAINS"],
                "include_domains": ["INCLUDE_DOMAINS"]
            },
            "excerpts": {
                "max_chars_per_result": MAX_CHARS_PER_RESULT,
                "max_chars_total": MAX_CHARS_TOTAL
            }
        }
    }
}],
  "model": "projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID"
}

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

curl (Linux, macOS, atau Cloud Shell)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login, atau dengan menggunakan Cloud Shell, yang secara otomatis membuat Anda login ke gcloud CLI. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent"

PowerShell (Windows)

Catatan: Perintah berikut mengasumsikan bahwa Anda telah login ke gcloud CLI menggunakan akun pengguna Anda dengan menjalankan gcloud init atau gcloud auth login. Anda dapat memeriksa akun yang saat ini aktif dengan menjalankan gcloud auth list.

Simpan isi permintaan dalam file bernama request.json, dan jalankan perintah berikut:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://LOCATION-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/publishers/google/models/MODEL_ID:generateContent" | Select-Object -Expand Content

Anda akan melihat respons JSON yang mirip seperti berikut:

Respons

{
  "candidates": [
    {
      "content": {
        "role": "model",
        "parts": [
          {
            "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025. The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
          }
        ]
      },
      "finishReason": "STOP",
      "groundingMetadata": {
        "webSearchQueries": [
          "who won the last super bowl"
        ],
        "groundingChunks": [
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX",
              "domain": "domain.com"
            }
          },
          {
            "web": {
              "uri": "https://...",
              "title": "Super Bowl LIX Results",
              "domain": "domain.com"
            }
          }
        ],
        "groundingSupports": [
          {
            "segment": {
              "endIndex": 77,
              "text": "The most recent Super Bowl was Super Bowl LIX (59), which was played in 2025."
            },
            "groundingChunkIndices": [
              0,
              1
            ]
          },
          {
            "segment": {
              "startIndex": 78,
              "endIndex": 198,
              "text": "The winner of Super Bowl LIX was the **Philadelphia Eagles**, who defeated the Kansas City Chiefs with a score of 40-22."
            },
            "groundingChunkIndices": [
              0
            ]
          },
        ]
      }
    }
  ],
  "usageMetadata": {
    "promptTokenCount": 33,
    "candidatesTokenCount": 106,
    "totalTokenCount": 284,
    "billablePromptUsage": {
      "textCount": 142
    },
    "trafficType": "ON_DEMAND",
    "promptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 33
      }
    ],
    "candidatesTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 106
      }
    ],
    "toolUsePromptTokensDetails": [
      {
        "modality": "TEXT",
        "tokenCount": 39
      }
    ],
    "toolUsePromptTokenCount": 39,
    "thoughtsTokenCount": 106
  },
  "modelVersion": "MODEL_VERSION",
  "createTime": "CREATE_TIME",
  "responseId": "RESPONSE_ID"
}

Kuota

Kuota default adalah 200 perintah per menit. Untuk meminta peningkatan batas kapasitas, berikan kasus penggunaan dan persyaratan Anda kepada kontak yang sesuai:

Jika Anda berlangganan Grounding dengan Penelusuran Web Paralel di Google Cloud Marketplace: Hubungi tim akun Google Anda.
Jika Anda memberikan kunci API Anda sendiri: Hubungi support@parallel.ai dan tim akun Google Anda.

Penagihan

Penggunaan Grounding dengan Penelusuran Web Paralel akan dikenai biaya berikut:

Penggunaan token Gemini: Anda dapat ditagih untuk:
- Token perintah
- Token penalaran
- Token output
Untuk informasi selengkapnya, buka Harga.
Perujukan Gemini dengan data Anda: Untuk mengetahui informasi selengkapnya, lihat Harga.
Harga untuk penggunaan Parallel Web Search API:
- Jika Anda berlangganan Grounding dengan Penelusuran Web Paralel di Google Cloud Marketplace, lihat bagian Harga paralel di Google Cloud Marketplace untuk mengetahui informasi selengkapnya.
- Jika Anda memberikan kunci API Anda sendiri, lihat situs Parallel untuk mengetahui informasi selengkapnya.

Grounding dengan Penelusuran Web Paralel

Kasus penggunaan

Model yang didukung

Klik untuk meluaskan model yang didukung

Sebelum memulai

Berlangganan di Google Cloud Marketplace (direkomendasikan)

Membawa kunci API Anda sendiri

Menyertakan informasi dari Parallel dalam respons Gemini

Konsol

Python

Instal

Java

Node.js

Instal

REST

curl (Linux, macOS, atau Cloud Shell)

PowerShell (Windows)

Respons

Kuota

Penagihan