{"models":[{"endpoint_id":"fal-ai/lyria2","metadata":{"display_name":"Lyria2","category":"text-to-audio","description":"Lyria 2 is Google's latest music generation model, you can generate any type of music with this model.","status":"active","tags":["music","stylized"],"updated_at":"2026-07-01T04:13:51.657Z","is_favorited":null,"thumbnail_url":"https://storage.googleapis.com/fal_cdn/fal/Sound-4.jpg","model_url":"https://fal.run/fal-ai/lyria2","license_type":"commercial","date":"2025-05-20T20:05:49.336Z","highlighted":false,"kind":"inference","pinned":false},"retires_at":null,"replacement":null,"openapi":{"openapi":"3.1.0","info":{"title":"Queue OpenAPI for fal-ai/lyria2","version":"1.0.0","description":"The OpenAPI schema for the fal-ai/lyria2 queue.","x-fal-metadata":{"endpointId":"fal-ai/lyria2","category":"text-to-audio","thumbnailUrl":"https://storage.googleapis.com/fal_cdn/fal/Sound-4.jpg","playgroundUrl":"https://fal.ai/models/fal-ai/lyria2","documentationUrl":"https://fal.ai/models/fal-ai/lyria2/api","about":"Generate music using Google's Lyria 2 text-to-music model.\n\nFor best results, prompts should be descriptive and clear. Include:\n- Genre/Style: Specify the musical genre (e.g., \"classical\", \"electronic\", \"rock\", \"jazz\", \"hip hop\")\n- Mood/Emotion: Describe the desired feeling or atmosphere (e.g., \"happy\", \"melancholy\", \"energetic\")\n- Instrumentation: List the instruments you want to hear (e.g., \"piano\", \"synthesizer\", \"acoustic guitar\")\n- Tempo/Rhythm: Indicate the speed and feel (e.g., \"fast tempo\", \"slow ballad\", \"driving beat\")\n- Soundscapes/Effects: For non-musical audio, describe the environment or specific sound effects\n- Arrangement/Structure: Briefly describe the progression or layering of sounds if important\n- Production Quality: Terms like \"high-quality production,\" \"clean mix,\" or \"vintage recording\"\n\nThe model supports:\n- 48kHz WAV audio output\n- 30 second duration\n- Negative prompting to exclude unwanted elements\n- Seed-based reproducibility\n\nSafety filters prevent generation of inappropriate content."}},"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"]},"Lyria2Input":{"required":["prompt"],"properties":{"prompt":{"type":"string","examples":["A lush, ambient soundscape featuring the serene sounds of a flowing river, complemented by the distant chirping of birds, and a gentle, melancholic piano melody that slowly unfolds."],"maxLength":2000,"minLength":1,"title":"Prompt","description":"The text prompt describing the music you want to generate"},"enable_safety_checker":{"type":"boolean","default":true,"title":"Enable Safety Checker","description":"Authorized callers may set false to request relaxed screening."},"negative_prompt":{"type":"string","examples":["vocals, slow tempo","low quality"],"title":"Negative Prompt","default":"low quality","description":"A description of what to exclude from the generated audio"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Seed","description":"A seed for deterministic generation. If provided, the model will attempt to produce the same audio given the same prompt and other parameters."}},"title":"TextToMusicInput","x-fal-order-properties":["prompt","negative_prompt","seed","enable_safety_checker"],"type":"object"},"Lyria2Output":{"required":["audio"],"properties":{"audio":{"examples":[{"url":"https://v3.fal.media/files/koala/9V6ADhxcZrZr2FcaiNA7H_output.wav"}],"$ref":"#/components/schemas/File","description":"The generated music"}},"title":"TextToMusicOutput","x-fal-order-properties":["audio"],"type":"object"},"File":{"required":["url"],"properties":{"file_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"examples":[4404019],"title":"File Size","description":"The size of the file in bytes."},"url":{"type":"string","title":"Url","description":"The URL where the file can be downloaded from."},"file_name":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["z9RV14K95DvU.png"],"title":"File Name","description":"The name of the file. It will be auto-generated if not provided."},"content_type":{"anyOf":[{"type":"string"},{"type":"null"}],"examples":["image/png"],"title":"Content Type","description":"The mime type of the file."}},"title":"File","x-fal-order-properties":["url","content_type","file_name","file_size"],"type":"object"}}},"paths":{"/fal-ai/lyria2/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/lyria2/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/lyria2":{"post":{"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Lyria2Input"}}}},"responses":{"200":{"description":"The request status.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/QueueStatus"}}}}}}},"/fal-ai/lyria2/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/Lyria2Output"}}}}}}}},"servers":[{"url":"https://queue.fal.run"}],"security":[{"apiKeyAuth":[]}]}}],"next_cursor":null,"has_more":false}
