Skip to main content
POST
/
producer
/
v1
/
music
cURL
curl --request POST \
  --url https://api.ttapi.io/producer/v1/music \
  --header 'Content-Type: application/json' \
  --header 'TT-API-KEY: <api-key>' \
  --data '
{
  "sound_prompt": "<string>",
  "lyrics_text": "<string>",
  "instrumental": "false",
  "mv": "FUZZ-2.0",
  "title": "<string>",
  "cover_art_url": "<string>",
  "seed": "<string>",
  "lyrics_strength": "0.5",
  "sound_strength": "0.5",
  "weirdness": "0.5",
  "is_storage": "false",
  "hook_url": "<string>"
}
'
{
  "status": "SUCCESS",
  "message": "success",
  "data": {
    "job_id": "job_id"
  }
}
Start here if you need the main endpoint for Google Lyria 3 / Producer music generation. For the complete endpoint directory, workflow guidance, and related links, see the Google Lyria 3 / Producer API overview.

​
When To Use Producer Music API

Use this endpoint when your app needs:
  • Prompt-based Google Lyria 3 music generation
  • A main Producer API entry point for song creation
  • The first step in a larger lyrics -> music -> fetch workflow
  1. Optionally prepare lyrics with the Producer Lyrics API.
  2. Submit the generation request through Producer Music API.
  3. Track the async job with the Producer Fetch API.
  4. Continue with Producer Extend, Producer Cover, or Producer Stems if your workflow needs post-processing.

​
Before You Integrate

Authorizations

​
TT-API-KEY
string
header
required

You can obtain your API key from the TTAPI Dashboard.

Body

application/json
​
sound_prompt
string
required

Audio prompt, sound_prompt and lyrics_text cannot both be empty

​
lyrics_text
string
required

Lyrics text, sound_prompt and lyrics_text cannot both be empty

​
instrumental
boolean
default:false

Whether to generate pure music

​
mv
enum<string>
default:FUZZ-2.0

Model to use, supported options listed above

Available options:
FUZZ-2.0 Pro,
FUZZ-2.0,
FUZZ-2.0 Raw,
FUZZ-1.1 Pro,
FUZZ-1.0 Pro,
FUZZ-1.0,
FUZZ-1.1,
FUZZ-0.8,
Lyria 3 preview,
Lyria 3 Pro
​
title
string

Title

​
cover_art_url
string

Cover URL

​
seed
string

Random seed

​
lyrics_strength
number
default:0.5

Lyrics strength, optional 0-1

​
sound_strength
number
default:0.5

Audio prompt strength, optional 0.2-1

​
weirdness
number
default:0.5

Style weirdness, optional 0-1

​
is_storage
boolean
default:false

Whether to save

​
hook_url
string

Callback notification URL. The data returned is consistent with the task result query response

Response

Request successful

​
status
string
required
Example:

"SUCCESS"

​
message
string
required
Example:

"success"

​
data
object
required
Example:
{ "job_id": "job_id" }
Last modified on April 15, 2026