Gemini API Integration

Gemini powers Ayumi’s two optional cloud transcription engines: Gemini, which reshapes a recording with your prompt, and Gemini Transcribe, Google’s dedicated speech model with language, speaker and vocabulary options. Both use the same key. You bring your own API key (BYOK), so you have full control over costs and usage.

Tip

You do not need this to start. Ayumi transcribes on-device out of the box, with no key and no account — see Voice Recording. Set up Gemini when you want a recording reshaped into a summary, a meeting note, or a written-up journal entry, rather than transcribed word for word.

Getting a Gemini API Key

1. Visit Google AI Studio
2. Sign in with your Google account
3. Navigate to the API keys section
4. Create a new API key
5. Copy the key

Caution

Keep your API key private. Never share it publicly.

Configuring in Ayumi

macOS

1. Open Ayumi > Settings (or Cmd+,)
2. Go to the Transcription tab
3. Paste your Gemini API key under Gemini
4. Star a Gemini profile (such as Clean Transcript) to make it the default, or pick one per recording

iOS

1. Open the transcription settings
2. Enter your Gemini API key under Gemini
3. Star a Gemini profile to make it the default, or pick one per recording

The key under Gemini is the provider’s base key: every Gemini and Gemini Transcribe profile uses it unless the profile sets an Override API Key of its own, for example to bill one profile to a different project. The engine, model, prompt and transcript options belong to the profile.

Keys are stored securely in your device’s Keychain and saved as you type; there is no Save button.

Supported Models

Model	Description
gemini-3.8-flash	Latest stable Flash
gemini-3.7-flash	Previous stable Flash; the default for new setups
gemini-3.6-flash	Earlier stable Flash
gemini-3.5-flash-lite	Lighter model, faster and cheaper
gemini-2.5-flash	Long-standing stable Flash
gemini-2.5-flash-lite	Lighter model of the 2.5 generation
Custom	Enter any Gemini model ID (preview or soon-to-retire models keep working until Google shuts them down)

Gemini Transcribe

The built-in Gemini Transcribe profile uses Google’s dedicated speech model with automatic language detection and Smart style; star it to make it the default, or duplicate it to set the options above. It runs on the same API key and takes no prompt; its options appear in their own section:

Option	Values
Language	Automatic, or one of 85+ languages
Style	Smart (cleaned up) or Verbatim (word for word)
Label Speakers	Verbatim only; up to 8 speakers
Word Timestamps	Verbatim only; a [mm:ss–mm:ss] range per paragraph
Custom Vocabulary	A newline-separated Markdown file (for example in iCloud Drive), terms typed into the profile, or both

The model used is gemini-3.5-transcribe. See Voice Recording for how each option shapes the transcript.

Profiles

A profile bundles an engine with what it should do, so one name selects the whole configuration:

1. Go to Transcription settings
2. Tap Add Profile
3. Give it a name
4. Choose the Engine — On-device, Gemini, or Gemini Transcribe — and, for Gemini, the Model
5. Write your prompt instructions (Gemini), or set the language, style, speaker labels and extra vocabulary (Gemini Transcribe)
6. Save

Profiles appear in the recording view, and Shortcuts can pick them from a list. The starter profiles are ordinary profiles: edit, duplicate, reorder or delete them as you like.

Switching Back

Star the On-device profile to stop audio being sent to Google by default. Your Gemini key and profiles stay where they are, so a Gemini profile keeps working when you pick it and you can re-transcribe an entry with it at any time.

Data Privacy

When using either Gemini engine:

• Audio data is sent to Google’s servers for processing
• Ayumi shows a consent dialog before the first API call
• No data is stored on Ayumi’s servers — the API call goes directly from your device to Google
• See Google’s AI terms for details on how Google handles API data