GET
/v1/schemas/fal/audio/mureka/api/generate/song
Accept:
| field | recorded source |
|---|---|
| schema | Source linked above. upstream-spec Source trace67f931828535e210f67f3ffab9548fa45557a66ae558369ce7c09387b10d5227{
"fetchedAt": 1792645225,
"extractorVersion": "1",
"verifiedAt": null
} |
Request body
9 properties · 0 required · 0 $defs| property | type | description | constraints |
|---|---|---|---|
| vocal_id | string | Voice ID returned by /voice/clone. | length ≥ 1 · nullable |
| melody_id | string | Melody ID returned by /files/upload with purpose='melody'. This cannot be combined with prompt, reference_id, or vocal_id. | length ≥ 1 · nullable |
| lyrics | string | Lyrics to sing, up to 5,000 characters. Provide this for lyrics-to-song generation; otherwise provide prompt for prompt-to-song generation. | length ≥ 1 · length ≤ 5000 · nullable |
| reference_id | string | Reference-music ID returned by /files/upload with purpose='reference'. | length ≥ 1 · nullable |
| gender | enum | Preferred vocal gender for lyrics-to-song generation. An uploaded or cloned voice takes precedence. | female | male · nullable |
| prompt | string | Describe the desired song, mood, instrumentation, and vocals. Required when lyrics is omitted; with lyrics, it acts as a music-style control. | length ≥ 1 · length ≤ 2000 · nullable |
| enable_safety_checker | boolean | Authorized callers may set false to request relaxed screening. | default: true |
| model | enum | The model to use for song generation. | mureka-7.6 | mureka-o2 | mureka-8 | mureka-9 | mureka-9.5 · default: "mureka-9.5" |
| styles | enum[] | One or more musical genres for prompt-to-song generation. This cannot be used when lyrics is provided. | items ≥ 1 · nullable |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"fal","endpointId":"mureka/api/generate/song","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}