Spiral gives your agent every tool with one account. Browse the tools →

Gemini CLI · AudioReleased 2026-02-18

How to Use Lyria 3 in Gemini CLI

Lyria 3 makes 30-second music clips for short videos, podcast intros, and song sketches, with vocals or instrumental arrangements. Choose it for a compact musical idea; Lyria 3 Pro supports songs up to three minutes.

Prompts to try with Lyria 3 in Gemini CLI

Copy an example into Gemini CLI, or ask in your own words.

Read the game's village scene notes and use Lyria 3 to generate a 30-second instrumental sketch. Use acoustic guitar, wooden flute, and light hand percussion at a relaxed walking pace.

Lyria 3Gemini CLI
Try asking
  • Use the product demo script in this project to brief Lyria 3 for a 30-second instrumental cue. Ask for muted synth plucks, soft bass, a steady moderate beat, and a curious mood.

  • Read the podcast brief and use Lyria 3 to create a 30-second opening theme with upright bass, brushed drums, and warm piano. Make it instrumental with a relaxed jazz feel.

  • Compose a 30-second upbeat lo-fi track with Lyria 3 for a product video. Save the result in ./assets.

  • Make a calm piano loop with Lyria 3 for a meditation app.

How to set up Lyria 3 in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

Use Spiral's MCP server

  1. Add the server

    Or add it to ~/.gemini/settings.json yourself:

    gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
  2. Sign in

    Start gemini and run:

    /mcp auth spiral
  3. Check it

    In Gemini CLI, run /mcp. From your shell:

    gemini mcp list

Use the Spiral skill

  1. Send Gemini CLI this message

    Your agent reads Spiral's skill and sets itself up.

    set up https://spiral.ai/SKILL.md
  2. Sign in or paste a key

    Approve Spiral in the browser, or give the agent a key from the console.

Use the Spiral CLI

  1. Install and sign in

    Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

    npx -y spiral-cli@latest init

Call the Spiral API

  1. Create an API key

    In the console, under API keys.

  2. Run Lyria 3

    One request; the result comes back by polling or a webhook.

    curl https://api.spiral.ai/v1/runs \
      -H "Authorization: Bearer $SPIRAL_API_KEY" \
      -H "Content-Type: application/json" \
      -H "Idempotency-Key: $(uuidgen)" \
      -d '{
        "provider": "fal",
        "model": "fal-ai/lyria3",
        "input": {
          "prompt": "An energetic electronic dance track with soaring synth leads, punchy four-on-the-floor kick drums, and a catchy vocal hook singing '\''Feel the rhythm, feel the…"
        }
      }'

Then paste one of the prompts above: Gemini CLI finds Lyria 3 on Spiral, shows the price and runs it.

Lyria 3 providers and prices

Spiral runs Lyria 3 through fal. Open a card for today's price, with every fee included.

falAudio
Lyria 3
fal-ai/lyria3

Settings you can ask for

Lyria 3 works from your prompt and image URL. Ask Gemini CLI for any of these in your prompt.

SettingAllowed valuesDefaultDescription
Negative promptwhat to leave out, in words

Negative prompting is not supported by Lyria 3.

Every API field of Lyria 3 is on its tool page: open its card above.

What can you do with Lyria 3 in Gemini CLI?

Turn a game's scene notes or a video's project brief into music you can audition alongside the work. Have the coding agent translate those notes into a clear description of mood, instruments, pace, and vocals.

Short video music

Draft a soundtrack for a 30-second cooking, travel, or product video. Describe the scene's energy, the main instruments, and whether the music should include singing.

Podcast opening themes

Create an instrumental opening theme with a clear musical identity, such as brushed drums and upright bass for a conversational interview show.

Tutorial backing music

Draft a restrained instrumental cue for a tutorial opening or demonstration segment. Ask for sparse piano, a gentle pulse, and subdued dynamics.

Game scene music

Explore music for a game menu, village scene, or victory sequence. Define the setting through instrumentation, pace, and mood.

Songwriting sketches

Hear how a lyrical idea might work as acoustic pop, jazz, or electronic music. Supply a short original lyric and describe the singer's delivery.

Personal musical greetings

Make a birthday or thank-you song around a specific memory. Choose a supported singing language and describe the recipient's preferred musical style.

Music inspired by artwork

Use an illustration or photograph as inspiration for an instrumental track. Add musical directions that connect its setting and mood to particular instruments.

Questions about Lyria 3 in Gemini CLI

Can Gemini CLI use Lyria 3?

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Lyria 3 like any built-in tool.

How much does Lyria 3 cost in Gemini CLI?

$0.052 per run at the default inputs. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

Do I need a fal account to use Lyria 3 in Gemini CLI?

No. Spiral runs Lyria 3 on its own fal account. You sign in to Spiral once and never paste a key.

How long does it take to set up Lyria 3 in Gemini CLI?

About two minutes: add the server, then sign in, then check it.

Does Gemini CLI wait while Lyria 3 runs?

Lyria 3 runs in the background. Gemini CLI starts the run, checks on it and gives you the audio when it's ready.

How long are Lyria 3 tracks?

Lyria 3 generates 30-second clips. Lyria 3 Pro supports songs up to three minutes, giving an arrangement more room to develop.

Can Lyria 3 make instrumental music and songs with lyrics?

Yes. Ask for instrumental music to leave out singing, or describe a vocal style and lyrical theme. You can also supply your own lyrics.

Which singing languages does Lyria 3 support?

English, German, Spanish, French, Hindi, Japanese, Korean, and Portuguese. Name the language alongside the vocal tone and delivery you want.

What should a useful Lyria 3 prompt include?

Specify the genre, mood, main instruments, pace, and vocal direction. For example, ask for a relaxed jazz instrumental with upright bass, brushed drums, and soft piano.

What audio format does Lyria 3 produce?

Lyria 3 and Lyria 3 Pro produce MP3 audio at 44.1 kHz and 192 kbps.

Get started

Start using Lyria 3 in Gemini CLI

One Spiral account for every tool your agent needs. No subscription; you pay per run.

Paste this into Gemini CLI:

Set up Gemini CLI

set up https://spiral.ai/SKILL.md
Are you an AI agent? See setup options