google-ai

Google Gemini stills and narration

Google's own Gemini image generation (publicly nicknamed “Nano Banana”) and Gemini TTS are reached directly through Google's Gemini API, not through fal.ai. In Video Studio, use this skill only for optional still-image work or off-camera narration. Never generate footage with Veo, Gemini Omni, or any other Google video model: all paid video uses MiniMax H3 through fal-ai.

This skill owns the client call after the still-image or narration direction is decided. Read video-look-sound for narration choices and video-cinematography for an optional reference-image brief.

Never invent a model ID

Google image and TTS product names are not API model identifiers. Do not guess the exact model string from memory. Before the first still-image or narration call in a new production:

1. Resolve the current Google model ID and required request shape from Google's own Gemini API reference -- not from this skill, which is deliberately silent on exact IDs and changes on Google's own schedule.
2. Record the resolved model ID and exact request in the production record so a revision reuses the same asset setup rather than whatever is current later.

A run whose model ID cannot be confirmed is a blocker to report, not a guess to make.

Authentication

The user stores the key as a workflow secret named GEMINI_API_KEY (via set_workflow_secret) -- the same env var name this platform's own LLM provider configuration already uses for Gemini, kept consistent rather than introducing a second name for the same kind of credential. The secret-injection mechanism prefixes every secret name with SECRET_ in the shell environment, so the variable actually present is $SECRET_GEMINI_API_KEY, not $GEMINI_API_KEY. Bridge the two explicitly:

export GEMINI_API_KEY="$SECRET_GEMINI_API_KEY"
node generate.mjs

or pass it directly to the client instead of relying on ambient env:

import { GoogleGenAI } from "@google/genai";

const ai = new GoogleGenAI({
  apiKey: process.env.SECRET_GEMINI_API_KEY ?? process.env.GEMINI_API_KEY,
});