Gemini CLI
Coming soon

Install Gemini CLI and point it at Relayvia.

Coming soon

This feature is not available yet. The content below describes how it will work at launch.

Gemini CLI uses the native Gemini format.

Install

Install it with npm; it needs a recent Node.js.

Terminal

npm install -g @google/gemini-cli

Add this to ~/.gemini/.env; Gemini CLI loads it on startup.

~/.gemini/.env

GOOGLE_GEMINI_BASE_URL=https://api.relayvia.dev
GEMINI_API_KEY=sk-...

Replace sk-... with an API key from the console.

Or set the environment variables in a terminal before starting Gemini CLI.

Terminal

export GOOGLE_GEMINI_BASE_URL=https://api.relayvia.dev
export GEMINI_API_KEY=sk-...
gemini

Symptom	Cause	Fix
401 invalid_api_key	Wrong, disabled or expired API key	Check the key's status in the console and copy the full string starting with `sk-`; create a new key if needed.
402 insufficient_quota	The account's credits, the key's limit or the team member's limit is used up, or the account is frozen	Top up, or ask an admin to raise the limit. Retrying will not help.
403 forbidden	The key may not use the model, the source IP is not on the allowlist, or the account is disabled	Check the key's allowed models and IP allowlist; use official model names as listed by `/v1/models`.
429 rate_limited	Too many requests	Wait for `Retry-After` and retry; contact us if you regularly need more.
Cannot connect (timeout, DNS error or 404)	Wrong base URL or no network access	Make sure `GOOGLE_GEMINI_BASE_URL` is `https://api.relayvia.dev`, without /v1.