GoogleMediumUltra

Lyria 3 Pro

Google's most capable music generation model. Generates full-length songs up to 3 minutes with vocals, lyrics, song structure tags ([Verse], [Chorus], [Bridge]) and timestamp control from a text prompt, optionally inspired by up to 10 reference images. Returns an MP3 file.

190 credits

per song (up to 3 min)

Full-length songs up to 3 minutes

Vocals, lyrics and song structure tags ([Verse], [Chorus], [Bridge])

Timestamp control such as [0:00 - 0:30] for section timing

Multi-language vocals

Up to 10 reference images as mood inspiration

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "google/lyria-3-pro",
  "input": {
    "prompt": "[Verse]\n아침부터 AI, 커피보다 진해\n코딩하다 보니 벌써 새벽 두 시네!\n안 되는 건 없어, 일단 만들어 봐\n상상이 현실 되는 마법 같은 회사!\n\n[Chorus]\n코어! 닷! 투데이!\n오늘의 상상이 내일의 기술로!\n코어! 닷! 투데이!\nAI도 놀라는 우리의 아이디어!\n\n[Outro]\n뚝딱뚝딱 만들고, 반짝반짝 빛내고!\n기술을 넘어 경험으로!\n코어닷투데이, Hey!\n\nBright upbeat K-pop electro-pop company jingle, 128 BPM, energetic female and male vocals in Korean, catchy chant chorus, synth brass, punchy drums, about ninety seconds."
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`prompt`	string	Yes	-	Text prompt describing the song. Include genre, instruments, mood, tempo, lyrics, and song structure (e.g. [Verse], [Chorus], [Bridge]). Timestamps like [0:00 - 0:30] control timing.
`images`	array	No	[]	Input images to inspire the music composition (up to 10 images)
`seed`	integer	No	-	Random seed for more reproducible results (exact determinism not guaranteed)

How to Provide File Input

There are 3 ways to provide files for the images parameter:

Recommended

Image URL

Pass a publicly accessible URL directly. With the Storage API (POST /v1/files/upload-url) the file uploads straight to S3 (50MB per file) and you pass the returned file_url.

{
  "model": "google/lyria-3-pro",
  "input": {
    "prompt": "your prompt here",
    "images": ["https://example.com/image.jpg"]
  }
}

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step, but the bytes pass through the API server so the whole request is capped at 10MB.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=google/lyria-3-pro" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:images=@your_file.png"

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Core.Today company song

The same Korean company-song lyrics given to every music model — compare how each one sings them

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "google/lyria-3-pro",
  "input": {
    "prompt": "[Verse]\n아침부터 AI, 커피보다 진해\n코딩하다 보니 벌써 새벽 두 시네!\n안 되는 건 없어, 일단 만들어 봐\n상상이 현실 되는 마법 같은 회사!\n\n[Chorus]\n코어! 닷! 투데이!\n오늘의 상상이 내일의 기술로!\n코어! 닷! 투데이!\nAI도 놀라는 우리의 아이디어!\n\n[Outro]\n뚝딱뚝딱 만들고, 반짝반짝 빛내고!\n기술을 넘어 경험으로!\n코어닷투데이, Hey!\n\nBright upbeat K-pop electro-pop company jingle, 128 BPM, energetic female and male vocals in Korean, catchy chant chorus, synth brass, punchy drums, about ninety seconds."
  }
}'

Song from structured lyrics

Tagged verse/chorus lyrics plus a style line become a full song

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "google/lyria-3-pro",
  "input": {
    "prompt": "[Verse 1]\nWalking through the neon glow,\ncity lights reflect below,\nevery shadow tells a story,\nevery corner, fading glory.\n\n[Chorus]\nWe are the echoes in the night,\nburning brighter than the light,\nhold on tight, don't let me go,\nwe are the echoes down below.\n\nSynth-pop, 110 BPM, female vocals, about ninety seconds."
  }
}'

Timed instrumental

Use timestamps to shape sections of an instrumental track

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "google/lyria-3-pro",
  "input": {
    "prompt": "Cinematic orchestral instrumental. [0:00 - 0:30] soft piano intro, [0:30 - 1:30] strings build with percussion, [1:30 - 2:00] full orchestra climax and gentle fade. No vocals."
  }
}'