Gemini API FAILED_PRECONDITION Error: diagnosis देखि समाधानसम्म
FAILED_PRECONDITION HTTP 400-family error हो। Request सही भए पनि account, project, region वा environment precondition पूरा नहुन सक्छ। सामान्य कारण unsupported region/free tier, billing disabled र Gemini CLI environment conflict हुन्। यो 429 rate limit वा 403 permission error होइन।
30-second diagnosis
- Full
error.messageपढ्नुहोस्। - “User location is not supported” ⇒ region; “enable billing” ⇒ billing; CLI मा “Precondition check failed” ⇒ environment conflict।
- Egress IP/region, exact model ID, project billing र key context verify गर्नुहोस्। Supported regions हेर्नुहोस्।
Region restriction का पाँच routes
- Unified gateway: OpenAI-compatible gateway मा
base_urlर key बदल्नुहोस्। - VPN: supported egress region, DNS-over-VPN र actual geolocation जाँच्नुहोस्।
- Cloud server: supported AWS/GCP/Azure region मा deploy गरी source IP verify गर्नुहोस्।
- Cloudflare Workers: edge proxy, secret, data boundary, latency र billing जाँच्नुहोस्।
- Vertex AI: GCP project, Vertex API र service account भएको official enterprise route; वास्तविक Cloud governance चाहिँदा मात्र।
from openai import OpenAI
client = OpenAI(api_key="YOUR_GPT88_API_KEY", base_url="https://gpt88.cc/v1")
response = client.chat.completions.create(
model="gemini-2.5-flash",
messages=[{"role": "user", "content": "Hello, Gemini!"}],
)
GPT88 charge official usage × selected group multiplier अनुसार हुन्छ; current price/quota console मा हेर्नुहोस्। यो development candidate हो, official enterprise replacement होइन।
Billing र CLI fix
AI Studio Dashboard → Usage and Billing → Set up Billing खोल्नुहोस् र key को account/project मिलेको जाँच्नुहोस्। Payment, balance, plan र limits account/region मा निर्भर हुन्छन्; billing ले हरेक unsupported region ठीक गर्दैन। पुराना RPM numbers hard-code नगर्नुहोस्।
unset GOOGLE_CLOUD_PROJECT
unset GOOGLE_APPLICATION_CREDENTIALS
unset CLOUDSDK_CORE_PROJECT
gemini
आवश्यक भए personal OAuth फेरि गर्नुहोस्; production credentials गल्तीले unset नगर्नुहोस्।
Prevention र FAQ
Error message, request ID, entry point, project, model र egress region log गर्नुहोस्; key होइन। 400, 403 र 429 अलग handle गर्नुहोस्। Precondition error मा blind retry नगर्नुहोस्। नयाँ key ले region वा same-project quota बदल्दैन।
Further Reading
सम्बन्धित गाइड
API Error Codes