Error 401: apa yang harus dilakukan saat gemini-2.5-flash-lite gagal

Kode 401 berarti autentikasi gagal: permintaan tidak membawa API Key, atau kuncinya tidak valid, sudah dihapus, atau kedaluwarsa.

401 Unauthorized berarti permintaan tidak membawa kredensial yang valid. Gateway tidak dapat mengenali pemanggil, jadi permintaan tidak pernah sampai ke model upstream. Memeriksa header Authorization dan status key adalah satu-satunya jalan.

gemini-2.5-flash-lite disediakan oleh Google. Semua di halaman ini — penyebab, solusi, dan data terukur — disusun dari perilaku runtime nyata model ini di lapisan gateway.

Di gateway ini, pemicu yang paling umum adalah: Header Authorization tidak ada. Tindakan pertama yang disarankan: Kirim header sebagai Authorization: Bearer diikuti kunci Anda.

Penyebab umum

  • Header Authorization tidak ada
  • Kunci salah ketik atau ada spasi berlebih
  • Kunci dihapus atau dinonaktifkan di halaman Token
  • Kunci dari platform lain terpakai secara tidak sengaja

Cara mengatasi

  • Kirim header sebagai Authorization: Bearer diikuti kunci Anda
  • Buat kunci baru di halaman Token
  • Pastikan Anda tidak memakai kunci dari layanan lain
  • Verifikasi kunci dengan permintaan curl minimal

Contoh percobaan ulang dengan exponential backoff

Kode di bawah mencoba ulang ketika gemini-2.5-flash-lite mengembalikan 401, maksimal 5 kali, dengan waktu tunggu yang meningkat plus jitter acak agar permintaan paralel tidak mengulang bersamaan. Baca base URL dan API key dari environment variable, jangan hardcode.

import os, time, random
import requests

BASE  = os.getenv("OPENAI_BASE_URL")   # e.g. https://<your-gateway>/v1
KEY   = os.getenv("OPENAI_API_KEY")
MODEL = 'gemini-2.5-flash-lite'


def chat(messages, retries=5):
    """Retry with exponential backoff + jitter."""
    for i in range(retries):
        try:
            r = requests.post(
                BASE + "/chat/completions",
                headers={"Authorization": "Bearer " + KEY},
                json={"model": MODEL, "messages": messages, "stream": True},
                timeout=60,
            )
            if r.status_code == 429 or r.status_code >= 500:
                time.sleep(min(2 ** i + random.uniform(0, 1), 30))
                continue
            r.raise_for_status()
            return r.json()
        except requests.exceptions.Timeout:
            time.sleep(min(2 ** i + random.uniform(0, 1), 30))
    raise RuntimeError("gave up after " + str(retries) + " retries")


print(chat([{"role": "user", "content": "hello"}]))

Data penting model ini

TPS380.8
Latensi rata-rata1486 ms
Tingkat sukses100%
Endpoint APIhttps://api.airai.cc/v1
Kompatibel OpenAIOpenAI-compatible
VendorGoogle
Konteks1M
KemampuanReasoning, Tools, Files, Vision, Audio
Format APIopenai, openai-response, openai-response-compact, anthropic, gemini, openai-alpha-search
Rumus penagihanp * 0.1 + cr * 0.01 + ai * 0.3 + c * 0.4

FAQ

Apakah 401 memengaruhi request yang sudah dikirim ke gemini-2.5-flash-lite?

Error ini tidak terkait kemampuan model, melainkan level gateway. Biasanya bersifat sementara dan pulih sendiri. Tag kapabilitas model ini adalah Reasoning, Tools, Files, Vision, Audio. Jika berlangsung beberapa menit, hubungi dukungan platform untuk memastikan status upstream. Tentukan dulu apakah ini level akun atau level model; penanganannya benar-benar berbeda.

Bagaimana menjadwalkan batch saat gemini-2.5-flash-lite mengembalikan 401?

Variabel sebenarnya di sini adalah konkurensi dan timeout, bukan modelnya. Turunkan konkurensi terlebih dahulu — sebagian besar masalah throughput akan hilang. Konteks 1M berarti input panjang menambah latensi token pertama secara nyata. Untuk keluaran panjang, naikkan timeout ke 60 detik atau lebih. Mulai dari konkurensi rendah, amati beberapa menit, lalu tingkatkan.

Apakah 401 terkait cara penagihan gemini-2.5-flash-lite?

Tidak ada tagihan, hanya output yang benar-benar dihasilkan yang dihitung. Hanya output yang sudah dihasilkan yang ditagihkan; bagian yang gagal tidak. Penagihan mengikuti p * 0.1 + cr * 0.01 + ai * 0.3 + c * 0.4, tanpa output berarti tanpa tagihan. Harga input sekitar $0.10 per juta token. Periksa saldo dan batas laju di konsol dulu, baru periksa kodenya. Saat memperkirakan biaya dari p * 0.1 + cr * 0.01 + ai * 0.3 + c * 0.4, sertakan juga anggaran percobaan ulang.

Apakah 401 di gemini-2.5-flash-lite bergantung pada region atau node?

Simpan request ID dan isi respons mentahnya, kalau tidak tidak ada yang bisa dilacak. Jika hanya terjadi di produksi, biasanya itu perbedaan lingkungan, bukan modelnya. Model ini dilayani oleh Google, sehingga status upstream mengikuti pengumuman penyedia. Catat request ID pada setiap kegagalan — lebih berguna daripada kode status.

Error lain pada model ini

Model lain dengan error yang sama

Kembali ke halaman model

Data diperbarui: 2026-10-10 15:40

Dukungan teknisDukungan langsung
Kembali ke atas