{"models":[{"endpoint_id":"mureka/v9.5/generate/song","metadata":{"display_name":"Mureka 9.5 Song Generation","category":"text-to-audio","description":"Generates songs from a text prompt or supplied lyrics, with musical style, vocal, reference-audio, and melody controls, plus support for multiple variations.","status":"active","tags":["music","vocals","song generation"],"updated_at":"2026-10-30T21:18:39.431Z","is_favorited":null,"thumbnail_url":"https://v3b.fal.media/files/b/0aaa61bd/nUKHfwGHS0eFH_BoR-mDL.jpg","model_url":"https://fal.run/mureka/v9.5/generate/song","license_type":"commercial","date":"2026-09-14T10:31:07.248Z","group":{"key":"mureka-v9.5","label":"Song Generation"},"highlighted":false,"kind":"inference","stream_url":"https://fal.run/mureka/v9.5/generate/song/stream","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for fal-ai/mureka/v9.5/generate/song","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/mureka/v9.5/generate/song queue.","x-fal-metadata":{"endpointId":"fal-ai/mureka/v9.5/generate/song","playgroundUrl":"https://fal.ai/models/fal-ai/mureka/v9.5/generate/song","documentationUrl":"https://fal.ai/models/fal-ai/mureka/v9.5/generate/song/api","about":"Generate complete songs from lyrics or a natural-language description.\n\nLyrics mode gives direct control over the words, while prompt mode creates a\nsong from its requested theme and musical styles. Each result includes a\nreusable song ID and audio URL."}},"components":{"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"Authorization","description":"Fal Key"}},"schemas":{"QueueStatus":{"type":"object","properties":{"status":{"type":"string","enum":["IN_QUEUE","IN_PROGRESS","COMPLETED"]},"request_id":{"type":"string","description":"The request id."},"response_url":{"type":"string","description":"The response url."},"status_url":{"type":"string","description":"The status url."},"cancel_url":{"type":"string","description":"The cancel url."},"logs":{"type":"object","description":"The logs.","additionalProperties":true},"metrics":{"type":"object","description":"The metrics.","additionalProperties":true},"queue_position":{"type":"integer","description":"The queue position."}},"required":["status","request_id"]},"MurekaV95GenerateSongInput":{"title":"GenerateSongV95Input","properties":{"enable_safety_checker":{"title":"Enable Safety Checker","description":"Authorized callers may set false to request relaxed screening.","default":true,"type":"boolean"},"gender":{"title":"Gender","description":"Preferred vocal gender for lyrics-to-song generation. An uploaded or cloned voice takes precedence.","anyOf":[{"enum":["female","male"],"type":"string"},{"type":"null"}]},"styles":{"title":"Styles","examples":[["pop","rock"]],"description":"One or more musical genres for prompt-to-song generation. This cannot be used when lyrics is provided.","anyOf":[{"minItems":1,"type":"array","items":{"enum":["pop","rock","jazz","r&b","edm","ambient","folk","latin","k-pop","j-pop","house","gospel","lo-fi"],"type":"string"}},{"type":"null"}]},"melody_id":{"title":"Melody Id","description":"Melody ID returned by /files/upload with purpose='melody'. This cannot be combined with prompt, reference_id, or vocal_id.","anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"vocal_id":{"title":"Vocal Id","description":"Voice ID returned by /voice/clone.","anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"prompt":{"title":"Prompt","description":"Describe the desired song, mood, instrumentation, and vocals. Required when lyrics is omitted, up to 2,000 characters. With lyrics, it acts as a music-style control and supports up to 1,024 characters.","examples":["A bright summer love song with a catchy chorus"],"anyOf":[{"minLength":1,"maxLength":2000,"type":"string"},{"type":"null"}]},"lyrics":{"title":"Lyrics","description":"Lyrics to sing, up to 5,000 characters. Provide this for lyrics-to-song generation; otherwise provide prompt for prompt-to-song generation.","anyOf":[{"minLength":1,"maxLength":5000,"type":"string"},{"type":"null"}]},"reference_id":{"title":"Reference Id","description":"Reference-music ID returned by /files/upload with purpose='reference'.","anyOf":[{"minLength":1,"type":"string"},{"type":"null"}]},"duration":{"title":"Duration","description":"Target song duration in seconds. If omitted, the model determines the duration automatically. The length of the lyrics also affects the target duration.","anyOf":[{"maximum":300,"minimum":120,"type":"integer"},{"type":"null"}]}},"description":"Input for v9.5 GenerateSong.","type":"object","x-fal-order-properties":["lyrics","styles","prompt","gender","reference_id","vocal_id","melody_id","enable_safety_checker","duration"]},"MurekaV95GenerateSongOutput":{"title":"GeneratedAudioOutput","properties":{"audio":{"$ref":"#/components/schemas/File","description":"The generated audio file."},"duration":{"title":"Duration","description":"Duration of the generated audio in milliseconds, when available.","anyOf":[{"type":"integer"},{"type":"null"}]},"lyrics_sections":{"title":"Lyrics Sections","description":"Timed lyric sections for the generated audio, when available.","anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/LyricsSection"}},{"type":"null"}]},"song_id":{"title":"Song Id","description":"Reusable identifier for this audio. Pass it to endpoints that accept song_id.","anyOf":[{"type":"string"},{"type":"null"}]}},"description":"A generated audio file and its reusable song identifier.","required":["audio"],"type":"object","x-fal-order-properties":["song_id","audio","duration","lyrics_sections"]},"File":{"title":"File","properties":{"url":{"title":"Url","description":"The URL where the file can be downloaded from.","type":"string"},"file_size":{"title":"File Size","examples":[4404019],"description":"The size of the file in bytes.","anyOf":[{"type":"integer"},{"type":"null"}]},"file_name":{"title":"File Name","examples":["z9RV14K95DvU.png"],"description":"The name of the file. It will be auto-generated if not provided.","anyOf":[{"type":"string"},{"type":"null"}]},"content_type":{"title":"Content Type","examples":["image/png"],"description":"The mime type of the file.","anyOf":[{"type":"string"},{"type":"null"}]}},"required":["url"],"type":"object","x-fal-order-properties":["url","content_type","file_name","file_size"]},"LyricsSection":{"title":"LyricsSection","properties":{"lines":{"title":"Lines","anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/LyricsLine"}},{"type":"null"}]},"start":{"title":"Start","anyOf":[{"type":"integer"},{"type":"null"}]},"end":{"title":"End","anyOf":[{"type":"integer"},{"type":"null"}]},"section_type":{"title":"Section Type","anyOf":[{"enum":["intro","verse","pre-chorus","chorus","bridge","break","outro"],"type":"string"},{"type":"null"}]}},"type":"object","x-fal-order-properties":["section_type","start","end","lines"]},"LyricsLine":{"title":"LyricsLine","properties":{"text":{"title":"Text","anyOf":[{"type":"string"},{"type":"null"}]},"start":{"title":"Start","anyOf":[{"type":"integer"},{"type":"null"}]},"end":{"title":"End","anyOf":[{"type":"integer"},{"type":"null"}]},"words":{"title":"Words","anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/LyricsWord"}},{"type":"null"}]}},"type":"object","x-fal-order-properties":["start","end","text","words"]},"LyricsWord":{"title":"LyricsWord","properties":{"text":{"title":"Text","anyOf":[{"type":"string"},{"type":"null"}]},"start":{"title":"Start","anyOf":[{"type":"integer"},{"type":"null"}]},"end":{"title":"End","anyOf":[{"type":"integer"},{"type":"null"}]}},"type":"object","x-fal-order-properties":["start","end","text"]}}},"paths":{"/fal-ai/mureka/v9.5/generate/song/requests/{request_id}/status":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}},{"name":"logs","in":"query","required":false,"schema":{"type":"number","description":"Whether to include logs (`1`) in the response or not (`0`)."}}],"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/mureka/v9.5/generate/song/requests/{request_id}/cancel":{"put":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"The request was cancelled.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the request was cancelled successfully."}}}}}}}}},"/fal-ai/mureka/v9.5/generate/song":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MurekaV95GenerateSongInput"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/mureka/v9.5/generate/song/requests/{request_id}":{"get":{"parameters":[{"name":"request_id","in":"path","required":true,"schema":{"type":"string","description":"Request ID"}}],"responses":{"200":{"description":"Result of the request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MurekaV95GenerateSongOutput"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}}],"next_cursor":null,"has_more":false}
