appnz-provider-google

name	appnz-provider-google
description	Use this skill when the user asks to use Google Gemini, provider google, or any google model through app.nz; covers model selection when present, BYOK setup, OpenAI-compatible routing, provider-specific endpoints, aliases, and debugging gateway headers.

Google Gemini on app.nz

Route Google Gemini through app.nz with one app.nz key. Use this skill when a user asks for Google Gemini, google, one of its model ids, aliases, product integrations, or BYOK setup for this provider.

Workflow

1. Use /api/gateway/models?provider=google to confirm the current public model list if exact availability matters.
2. Call app.nz at https://app.nz/v1 with Authorization: Bearer pk_live_...; do not call https://generativelanguage.googleapis.com directly unless the user explicitly asks to bypass app.nz.
3. Store a user-owned upstream key with POST /api/gateway/provider-keys using provider google when BYOK is required. The upstream secret is never returned by app.nz.
4. Prefer a model matching the task modality. If unsure, start with openpaths/auto or app/auto.
5. Read X-Gateway-Provider and X-Gateway-Model response headers when debugging routing.

BYOK

curl -sX POST https://app.nz/api/gateway/provider-keys \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"provider":"google","api_key":"REDACTED_UPSTREAM_KEY"}'

Chat Example

curl -s https://app.nz/v1/chat/completions \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"model":"openpaths/auto","messages":[{"role":"user","content":"Give me one practical idea."}]}'

Models

Model	Modality	Aliases	Caps
gemini-2.5-flash	chat	gemini-flash	stream, tools, vision
gemini-2.5-pro	chat	-	stream, tools, vision
gemini-3.1-flash-lite	chat	gemini-flash-lite, flash-lite, gemini-lite	stream, tools, vision
gemini-3.1-flash-tts-preview	speech	gemini-flash-tts, google-tts, gemini-tts	-
gemini-3.5-flash	chat	gemini-3.5, gemini-flash-frontier	stream, tools, vision
gemini-embedding-001	embeddings	google-embed, gemini-embed-001	-
gemini-embedding-2-preview	embeddings	gemini-embedding-2, google-embed-2	-
gemini-latest	chat	google-latest, google-gemini-latest	stream, tools, vision
lyria-3-clip-preview	music	lyria-clip, google-lyria-clip	-
lyria-3-pro-preview	music	lyria-pro, google-lyria-pro	-
openpaths/auto	chat	auto, auto-chat, auto-text, openpaths-auto	stream, tools, vision
openpaths/auto-vision	chat	auto-vision, openpaths-auto-vision	stream, tools, vision