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

opencode · AudioReleased 2026-02-18

How to Use Lyria 3 in opencode

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 opencode

Copy an example into opencode, 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 3opencode
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 opencode

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

Use Spiral's MCP server

  1. Add the server

    Leave out --global to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

    opencode mcp add spiral --global --url https://api.spiral.ai/mcp
  2. Sign in

    Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, /mcps starts the same sign-in.

    opencode mcp auth spiral
  3. Check it

    Spiral shows as connected.

    opencode mcp list

Use the Spiral skill

  1. Send opencode 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: opencode 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 opencode 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 opencode?

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 opencode

Can opencode use Lyria 3?

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

How much does Lyria 3 cost in opencode?

$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 opencode plan is separate.

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

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 opencode?

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

Does opencode wait while Lyria 3 runs?

Lyria 3 runs in the background. opencode 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 opencode

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

Paste this into opencode:

Set up opencode

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