# Google AI (g.ai) — Zapi reference

> Asisten penelusuran AI dari Google (AI Mode / g.ai) — jawaban grounded ke web realtime dengan sitasi. OpenAI-compatible chat completions.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ status, message, content }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/ai/google-aimode
- Endpoint catalog: https://zpi.web.id/category/ai
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## Google AI (g.ai)

**Category:** ai · **Slug:** `google-aimode`
**Detail page:** https://zpi.web.id/api/ai/google-aimode

Asisten penelusuran AI dari Google (AI Mode / g.ai) — jawaban grounded ke web realtime dengan sitasi. OpenAI-compatible chat completions.

**Tags:** ai, chat, search, google, gemini, realtime

### Chat Completion

OpenAI-compatible chat via Google AI Mode. Stateless: pertanyaan user terakhir jadi query, jawaban grounded realtime. Dukung stream SSE.

- **Method:** `POST`
- **Endpoint:** `https://api.zpi.web.id/v1/ai:google-aimode/chat`

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `messages` | array | body | yes | OpenAI-format messages. AI Mode = asisten penelusuran (grounded ke web realtime). Stateless: pertanyaan user terakhir jadi query utama, system + prior turns jadi konteks ringkas. |
| `hl` | enum(id|en) | query | no | Bahasa jawaban AI Mode. Default id. |
| `stream` | boolean | query | no | Stream via SSE delta. Default false (pseudo-stream: jawaban di-buffer lalu di-chunk). |

**cURL:**
```bash
curl -X POST "https://api.zpi.web.id/v1/ai:google-aimode/chat" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "messages": [
    {
      "role": "system",
      "content": "Jawab ringkas dalam bahasa Indonesia."
    },
    {
      "role": "user",
      "content": "apa ibukota indonesia dan berapa populasinya?"
    }
  ]
}'
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/ai:google-aimode/chat", {
  method: "POST",
  headers: { "x-api-key": process.env.ZAPI_KEY, "Content-Type": "application/json" },
  body: JSON.stringify({
  "messages": [
    {
      "role": "system",
      "content": "Jawab ringkas dalam bahasa Indonesia."
    },
    {
      "role": "user",
      "content": "apa ibukota indonesia dan berapa populasinya?"
    }
  ]
})
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.post("https://api.zpi.web.id/v1/ai:google-aimode/chat",
  headers={"x-api-key": "YOUR_API_KEY"},
  json={
  "messages": [
    {
      "role": "system",
      "content": "Jawab ringkas dalam bahasa Indonesia."
    },
    {
      "role": "user",
      "content": "apa ibukota indonesia dan berapa populasinya?"
    }
  ]
})
data = r.json()
```

**Example response:**
```json
{
  "id": "chatcmpl-Wsa932kQaUCgzyn3hDVmWvGD",
  "model": "google-aimode",
  "usage": {
    "total_tokens": 118,
    "prompt_tokens": 21,
    "completion_tokens": 97
  },
  "object": "chat.completion",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Ibukota Indonesia saat ini adalah Jakarta. Universitas Teknokrat IndonesiaMenurut data Badan Pusat Statistik (BPS) yang dilaporkan pada tahun 2025, populasi Jakarta mencapai sekitar 10,72 juta jiwa. InstagramCatatan: Saat ini proses pemindahan ibukota ke Nusantara (IKN) sedang berlangsung. Universitas Teknokrat IndonesiaJika Anda ingin saya mencari tahu informasi lain, beri tahu saya!"
      },
      "finish_reason": "stop"
    }
  ],
  "created": 1781069007
}
```

---


_Generated: 2026-08-02T14:22:05.599Z_