Menggunakan GccAi dengan Gemini CLI

Pendahuluan

Gemini CLI adalah alat baris perintah resmi Google yang memungkinkan developer berinteraksi dengan model AI Gemini dari terminal. Setelah mengonfigurasi API APIMart, Anda dapat menggunakan model canggih APIMart, seperti GPT, Claude, dan Gemini, di Gemini CLI.

Prasyarat

Sebelum memulai:

Node.js dan npm sudah terinstal
Unduh dan instal dari situs Node.js (disarankan v16 atau lebih baru)
APIMart API key
Masuk ke Konsol APIMart dan salin API key Anda (diawali dengan sk-)

Tips: Jika Anda belum memiliki akun APIMart, daftar terlebih dahulu di APIMart dan buat API key.

Langkah 1: Instal Gemini CLI

1.1 Instalasi global

Instal Gemini CLI secara global dengan npm:

npm install -g @google/gemini-cli

1.2 Verifikasi instalasi

Pastikan CLI tersedia:

gemini --version

Jika nomor versi ditampilkan, instalasi berhasil.

Tips: Jika perintah tidak ditemukan, mulai ulang terminal atau periksa konfigurasi PATH global npm Anda.

Langkah 2: Konfigurasikan API APIMart

2.1 Environment variable sementara

Untuk pengujian atau penggunaan sekali jalan; nilai akan hilang saat terminal ditutup. Windows (PowerShell):

$env:GEMINI_API_KEY = "sk-xxxxxxxxxxxx"
$env:GEMINI_BASE_URL = "https://api.apimart.ai/v1"

macOS/Linux (Bash):

export GEMINI_API_KEY="sk-xxxxxxxxxxxx"
export GEMINI_BASE_URL="https://api.apimart.ai/v1"

2.2 Environment variable permanen (direkomendasikan)

Konfigurasi yang persisten agar shell baru memuatnya secara otomatis. Windows (PowerShell):

Jalankan PowerShell sebagai Administrator
Atur environment variable di tingkat pengguna:

[System.Environment]::SetEnvironmentVariable('GEMINI_API_KEY', 'sk-xxxxxxxxxxxx', 'User')
[System.Environment]::SetEnvironmentVariable('GEMINI_BASE_URL', 'https://api.apimart.ai/v1', 'User')

Mulai ulang PowerShell, atau muat ulang variabel:

$env:GEMINI_API_KEY = [System.Environment]::GetEnvironmentVariable('GEMINI_API_KEY', 'User')
$env:GEMINI_BASE_URL = [System.Environment]::GetEnvironmentVariable('GEMINI_BASE_URL', 'User')

macOS/Linux (Bash):

Edit file rc shell Anda:

# Bash
nano ~/.bashrc

# Zsh (default on macOS)
nano ~/.zshrc

Tambahkan:

# APIMart Gemini CLI
export GEMINI_API_KEY="sk-xxxxxxxxxxxx"
export GEMINI_BASE_URL="https://api.apimart.ai/v1"

Muat ulang:

source ~/.bashrc   # Bash
source ~/.zshrc    # Zsh

2.3 Menggunakan file `.env`

Buat .env di proyek Anda:

# .env
GEMINI_API_KEY=sk-xxxxxxxxxxxx
GEMINI_BASE_URL=https://api.apimart.ai/v1

Muat variabel sebelum menjalankan Gemini: macOS/Linux:

export $(cat .env | xargs) && gemini chat

Windows (PowerShell):

Get-Content .env | ForEach-Object {
    $name, $value = $_.split('=')
    Set-Content env:\$name $value
}
gemini chat

Penting: - Ganti sk-xxxxxxxxxxxx dengan key asli dari Konsol APIMart - Atur GEMINI_BASE_URL ke https://api.apimart.ai/v1 agar Gemini CLI terhubung ke APIMart - Tambahkan .env ke .gitignore agar key tidak ikut ter-commit

2.4 Verifikasi konfigurasi

macOS/Linux:

echo $GEMINI_API_KEY
echo $GEMINI_BASE_URL

Windows (PowerShell):

echo $env:GEMINI_API_KEY
echo $env:GEMINI_BASE_URL

Jika nilainya terlihat benar, konfigurasi berhasil.

Langkah 3: Gunakan Gemini CLI

3.1 Chat dasar

Sesi interaktif:

gemini chat

Prompt sekali jalan:

gemini "Give a short overview of the history of artificial intelligence"

3.2 Pilih model

gemini chat --model gpt-4o

Atau:

gemini "Write a Python quicksort implementation" --model claude-sonnet-4-5-20250929

3.3 Baca prompt dari file

gemini --input prompt.txt

Atau gunakan pipe:

cat prompt.txt | gemini

3.4 Simpan output ke file

gemini "Generate a React component" --output component.jsx

Langkah 4: Panggil APIMart dari kode Anda

4.1 Python SDK

import openai

# APIMart
openai.api_key = "sk-xxxxxxxxxxxx"  # Your APIMart API key
openai.api_base = "https://api.apimart.ai/v1"

response = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[
        {"role": "user", "content": "Hi—please introduce yourself"}
    ]
)

print(response.choices[0].message.content)

4.2 JavaScript / TypeScript

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-xxxxxxxxxxxx",
  baseURL: "https://api.apimart.ai/v1",
});

async function main() {
  const completion = await client.chat.completions.create({
    model: "gemini-2.0-flash-exp",
    messages: [{ role: "user", content: "Hi—please introduce yourself" }],
  });

  console.log(completion.choices[0].message.content);
}

main();

4.3 cURL

curl https://api.apimart.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xxxxxxxxxxxx" \
  -d '{
    "model": "gemini-2.0-flash-exp",
    "messages": [
      {"role": "user", "content": "Hi—please introduce yourself"}
    ]
  }'

Langkah 5: Pilih model

Model yang direkomendasikan

APIMart mendukung banyak model; pilih berdasarkan tugas dan anggaran. Gemini

Nama model	ID Model	Karakteristik	Cocok untuk
Gemini 2.0 Flash	`gemini-2.0-flash-exp`	Cepat, multimodal	Jawaban cepat, visi + teks
Gemini 2.5 Pro	`gemini-2.5-pro`	Kemampuan kuat	Masalah sulit, analisis
Gemini 2.5 Flash	`gemini-2.5-flash`	Sangat responsif	Chat real-time, pekerjaan batch

GPT

Nama model	ID Model	Karakteristik	Cocok untuk
GPT-5	`gpt-5`	Tingkat teratas	Penalaran, penulisan kreatif
GPT-4o	`gpt-4o`	Kualitas tinggi	Chat umum, konten
GPT-4o Mini	`gpt-4o-mini`	Hemat biaya	Tugas sederhana, volume tinggi

Claude

Nama model	ID Model	Karakteristik	Cocok untuk
Claude Sonnet 4.5	`claude-sonnet-4-5-20250929`	Penalaran kuat	Kode, logika
Claude Haiku 4.5	`claude-haiku-4-5-20251001`	Sangat cepat	Tanya jawab, chat berlatensi rendah

Pilihan cepat: - 🚀 Stack ala Google: gemini-2.0-flash-exp, gemini-2.5-pro - 💡 Coding: claude-sonnet-4-5-20250929, gpt-5 - 💰 Biaya: gpt-4o-mini, claude-haiku-4-5-20251001 - ⚡ Kecepatan: gemini-2.0-flash-exp, gpt-4o-mini

Fitur lanjutan

Multimodal (gambar)

Dengan model multimodal seperti Gemini 2.0 Flash:

response = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "What’s in this image?"},
                {
                    "type": "image_url",
                    "image_url": {
                        "url": "https://example.com/image.jpg"
                    }
                }
            ]
        }
    ]
)

Streaming

Streaming token saat tiba:

stream = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[{"role": "user", "content": "Write a short poem about spring"}],
    stream=True
)

for chunk in stream:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end='')

Parameter penyetelan

Atur keacakan dan panjang:

response = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[{"role": "user", "content": "Your question"}],
    temperature=0.7,        # randomness (0–2)
    max_tokens=2000,        # max output length
    top_p=0.9,              # nucleus sampling
    presence_penalty=0,     # topic diversity
    frequency_penalty=0     # repetition penalty
)

FAQ

Q1: Error “Invalid API key” atau autentikasi

Format key
- Harus diawali dengan sk-
- Tidak boleh ada spasi tambahan saat menempel

Environment variable

# macOS / Linux
echo $GEMINI_API_KEY
echo $GEMINI_BASE_URL

# Windows PowerShell
echo $env:GEMINI_API_KEY
echo $env:GEMINI_BASE_URL

Status key
- Periksa key di Konsol APIMart
- Pastikan akun Anda memiliki saldo

Q2: Bagaimana memverifikasi setup API?

import openai

openai.api_key = "sk-xxxxxxxxxxxx"
openai.api_base = "https://api.apimart.ai/v1"

try:
    response = openai.ChatCompletion.create(
        model="gemini-2.0-flash-exp",
        messages=[{"role": "user", "content": "test"}],
        max_tokens=10
    )
    print("✅ API configuration OK")
    print(f"Reply: {response.choices[0].message.content}")
except Exception as e:
    print(f"❌ API configuration failed: {e}")

Q3: Bahasa apa saja yang didukung?

Bahasa apa pun yang dapat mengirim permintaan HTTP dapat digunakan dengan APIMart:

✅ Python — SDK OpenAI direkomendasikan
✅ JavaScript / TypeScript — Node atau browser
✅ Java — klien HTTP
✅ Go — stdlib atau pustaka
✅ PHP — cURL atau Guzzle
✅ Ruby — gem HTTP
✅ C# / .NET — HttpClient
✅ Swift — URLSession
✅ Lainnya — apa pun yang mendukung HTTP

Q4: Di mana saya dapat melihat penggunaan dan penagihan?

Di Konsol APIMart:

📊 Statistik panggilan langsung
💰 Biaya dan faktur
📈 Tren penggunaan
🔍 Log permintaan
⚙️ Manajemen API key

Q5: Error API umum

Error	Kemungkinan penyebab	Tindakan
`401 Unauthorized`	Key salah atau dicabut	Perbaiki key di env / konsol
`429 Too Many Requests`	Batas laju	Perlambat atau tingkatkan paket
`500 Internal Server Error`	Masalah server sementara	Coba lagi nanti; hubungi dukungan jika berlanjut
`insufficient_quota`	Saldo rendah	Isi ulang di konsol

Praktik terbaik

1. Percobaan ulang dan backoff

import openai
import time

def call_with_retry(max_retries=3):
    for i in range(max_retries):
        try:
            response = openai.ChatCompletion.create(
                model="gemini-2.0-flash-exp",
                messages=[{"role": "user", "content": "Your question"}]
            )
            return response
        except openai.error.RateLimitError:
            if i < max_retries - 1:
                time.sleep(2 ** i)
                continue
            raise
        except Exception as e:
            print(f"Error: {e}")
            raise

response = call_with_retry()

2. Kontrol biaya

def choose_model(complexity):
    if complexity == "simple":
        return "gpt-4o-mini"
    elif complexity == "medium":
        return "gemini-2.0-flash-exp"
    return "gpt-5"

model = choose_model("simple")
response = openai.ChatCompletion.create(
    model=model,
    messages=[{"role": "user", "content": "Your question"}],
    max_tokens=500
)

3. Prompt sistem

response = openai.ChatCompletion.create(
    model="gemini-2.0-flash-exp",
    messages=[
        {
            "role": "system",
            "content": "You are an expert Python assistant who writes clear, efficient code."
        },
        {
            "role": "user",
            "content": "Implement quicksort for me"
        }
    ]
)

Fitur

Dengan Google AI Studio dan APIMart, Anda mendapatkan:

🤖 Banyak model — GPT, Claude, Gemini, dan lainnya
🌍 kompatibel dengan OpenAI — format request / response yang familier
⚡ Performa — latensi rendah, konkurensi tinggi
💰 Harga jelas — bayar sesuai pemakaian
📊 Observabilitas — pantau panggilan secara real time
🔒 Keamanan — pengamanan berorientasi enterprise
🚀 Integrasi cepat — panggilan HTTP / SDK sederhana
📚 Dokumentasi — panduan dan contoh

Dukungan

Mulai dengan APIMart

Buat akun, ambil API key, dan gunakan beberapa model AI dari alur kerja Google AI Studio dan lainnya.

Documentation Index

​Pendahuluan

​Prasyarat

​Langkah 1: Instal Gemini CLI

​1.1 Instalasi global

​1.2 Verifikasi instalasi

​Langkah 2: Konfigurasikan API APIMart

​2.1 Environment variable sementara

​2.2 Environment variable permanen (direkomendasikan)

​2.3 Menggunakan file .env

​2.4 Verifikasi konfigurasi

​Langkah 3: Gunakan Gemini CLI

​3.1 Chat dasar

​3.2 Pilih model

​3.3 Baca prompt dari file

​3.4 Simpan output ke file

​Langkah 4: Panggil APIMart dari kode Anda

​4.1 Python SDK

​4.2 JavaScript / TypeScript

​4.3 cURL

​Langkah 5: Pilih model

​Model yang direkomendasikan

​Fitur lanjutan

​Multimodal (gambar)

​Streaming

​Parameter penyetelan

​FAQ

​Q1: Error “Invalid API key” atau autentikasi

​Q2: Bagaimana memverifikasi setup API?

​Q3: Bahasa apa saja yang didukung?

​Q4: Di mana saya dapat melihat penggunaan dan penagihan?

​Q5: Error API umum

​Praktik terbaik

​1. Percobaan ulang dan backoff

​2. Kontrol biaya

​3. Prompt sistem

​Fitur

​Dukungan

Mulai dengan APIMart

Pendahuluan

Prasyarat

Langkah 1: Instal Gemini CLI

1.1 Instalasi global

1.2 Verifikasi instalasi

Langkah 2: Konfigurasikan API APIMart

2.1 Environment variable sementara

2.2 Environment variable permanen (direkomendasikan)

2.3 Menggunakan file `.env`

2.4 Verifikasi konfigurasi

Langkah 3: Gunakan Gemini CLI

3.1 Chat dasar

3.2 Pilih model

3.3 Baca prompt dari file

3.4 Simpan output ke file

Langkah 4: Panggil APIMart dari kode Anda

4.1 Python SDK

4.2 JavaScript / TypeScript

4.3 cURL

Langkah 5: Pilih model

Model yang direkomendasikan

Fitur lanjutan

Multimodal (gambar)

Streaming

Parameter penyetelan

FAQ

Q1: Error “Invalid API key” atau autentikasi

Q2: Bagaimana memverifikasi setup API?

Q3: Bahasa apa saja yang didukung?

Q4: Di mana saya dapat melihat penggunaan dan penagihan?

Q5: Error API umum

Praktik terbaik

1. Percobaan ulang dan backoff

2. Kontrol biaya

3. Prompt sistem

Fitur

Dukungan