{"openapi":"3.1.0","info":{"title":"FreeMusic Music API","version":"1.0.0","description":"Create an API key and fund your separate API balance in the developer dashboard. Bearer authentication is required. API credits never expire. MCP uses website credits. Failed tasks are refunded to their original balance."},"servers":[{"url":"https://openapi.freemusic.ai"}],"security":[{"ApiKey":[]}],"components":{"securitySchemes":{"ApiKey":{"type":"http","scheme":"bearer","bearerFormat":"sk_api_"}}},"paths":{"/openapi/v1/music/generate":{"post":{"operationId":"generate","tags":["Music"],"summary":"Generate music","description":"Costs 10 API credits per task (1 credit = 1 US cent). Supported models: ElevenLabs (ElevenLabs), Lyria 3 Pro (Lyria3Pro), Mureka V8 (MurekaV8), V1-plus (V1_PLUS), V2.5 (V2_5), V2 (V2). Returns unique_id; poll tasks/status until is_complete=true.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"mode":{"type":"string","enum":["simple","custom"]},"model":{"type":"string","enum":["ElevenLabs","Lyria3Pro","MurekaV8","V1_PLUS","V2_5","V2"]},"instrumental":{"type":"boolean"},"prompt":{"type":"string","maxLength":5000},"style":{"type":"string","maxLength":1000},"title":{"type":"string","maxLength":100},"vocal_gender":{"type":"string","enum":["m","f"]},"style_weight":{"type":"number","minimum":0,"maximum":1},"weirdness":{"type":"number","minimum":0,"maximum":1},"negative_tags":{"type":"string","maxLength":500},"duration":{"type":"integer","minimum":10,"maximum":360},"n":{"type":"integer","minimum":1,"maximum":3},"duration_ms":{"type":"integer","minimum":3000,"maximum":600000},"workspace_id":{"type":"string","pattern":"^[1-9]\\d*$"}},"required":["mode"]},"example":{"model":"V2_5","mode":"simple","prompt":"A warm acoustic folk song about a journey","instrumental":false}}}},"responses":{"200":{"description":"Task accepted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"code":{"type":"number","const":0},"message":{"type":"string"},"data":{"type":"object","properties":{"unique_id":{"type":"string"},"status":{"type":"string","const":"pending"},"cost":{"type":"number"}},"required":["unique_id","status"],"additionalProperties":false}},"required":["code","message","data"],"additionalProperties":false}}}},"400":{"description":"Invalid request or insufficient API balance"},"401":{"description":"Invalid or revoked API key"}}}},"/openapi/v1/music/extend":{"post":{"operationId":"extend","tags":["Music"],"summary":"Extend music","description":"Costs 10 API credits per task (1 credit = 1 US cent). Supported models: V1-plus (V1_PLUS), V2.5 (V2_5), V2 (V2), Extend Beta (Extend Beta). Returns unique_id; poll tasks/status until is_complete=true.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"model":{"type":"string","enum":["V1_PLUS","V2_5","V2","Extend Beta"]},"source":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"library"},"song_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","pattern":"^[1-9]\\d*$"}]}},"required":["type","song_id"]},{"type":"object","properties":{"type":{"type":"string","const":"upload"},"upload_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","pattern":"^[1-9]\\d*$"}]}},"required":["type","upload_id"]}]},"continue_at":{"type":"number","exclusiveMinimum":0},"extend_type":{"type":"string","enum":["head","tail"]},"mode":{"type":"string","enum":["simple","custom"]},"instrumental":{"type":"boolean"},"prompt":{"type":"string","maxLength":5000},"style":{"type":"string","maxLength":1000},"title":{"type":"string","maxLength":100},"vocal_gender":{"type":"string","enum":["m","f"]},"style_weight":{"type":"number","minimum":0,"maximum":1},"weirdness":{"type":"number","minimum":0,"maximum":1},"audio_weight":{"type":"number","minimum":0,"maximum":1},"workspace_id":{"type":"string","pattern":"^[1-9]\\d*$"}},"required":["source","continue_at","mode"]},"example":{"model":"V2_5","mode":"custom","source":{"type":"library","song_id":"1"},"continue_at":30,"title":"Journey","style":"Acoustic folk","prompt":"A new verse"}}}},"responses":{"200":{"description":"Task accepted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"code":{"type":"number","const":0},"message":{"type":"string"},"data":{"type":"object","properties":{"unique_id":{"type":"string"},"status":{"type":"string","const":"pending"},"cost":{"type":"number"}},"required":["unique_id","status"],"additionalProperties":false}},"required":["code","message","data"],"additionalProperties":false}}}},"400":{"description":"Invalid request or insufficient API balance"},"401":{"description":"Invalid or revoked API key"}}}},"/openapi/v1/music/remix":{"post":{"operationId":"remix","tags":["Music"],"summary":"Remix music","description":"Costs 10 API credits per task (1 credit = 1 US cent). Supported models: V1-plus (V1_PLUS), V2.5 (V2_5), V2 (V2), Cover Beta (Cover Beta). Returns unique_id; poll tasks/status until is_complete=true.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"model":{"type":"string","enum":["V1_PLUS","V2_5","V2","Cover Beta"]},"source":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"library"},"song_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","pattern":"^[1-9]\\d*$"}]}},"required":["type","song_id"]},{"type":"object","properties":{"type":{"type":"string","const":"upload"},"upload_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","pattern":"^[1-9]\\d*$"}]}},"required":["type","upload_id"]}]},"mode":{"type":"string","enum":["simple","custom"]},"instrumental":{"type":"boolean"},"prompt":{"type":"string","maxLength":5000},"style":{"type":"string","maxLength":1000},"title":{"type":"string","maxLength":100},"vocal_gender":{"type":"string","enum":["m","f"]},"style_weight":{"type":"number","minimum":0,"maximum":1},"weirdness":{"type":"number","minimum":0,"maximum":1},"audio_weight":{"type":"number","minimum":0,"maximum":1},"workspace_id":{"type":"string","pattern":"^[1-9]\\d*$"}},"required":["source","mode"]},"example":{"model":"V2_5","mode":"custom","source":{"type":"library","song_id":"1"},"title":"Journey","style":"Acoustic folk","prompt":"A new verse"}}}},"responses":{"200":{"description":"Task accepted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"code":{"type":"number","const":0},"message":{"type":"string"},"data":{"type":"object","properties":{"unique_id":{"type":"string"},"status":{"type":"string","const":"pending"},"cost":{"type":"number"}},"required":["unique_id","status"],"additionalProperties":false}},"required":["code","message","data"],"additionalProperties":false}}}},"400":{"description":"Invalid request or insufficient API balance"},"401":{"description":"Invalid or revoked API key"}}}},"/openapi/v1/music/replace":{"post":{"operationId":"replace","tags":["Music"],"summary":"Replace music","description":"Costs 5 API credits per task (1 credit = 1 US cent). Supported models: V1-plus (V1_PLUS), V2.5 (V2_5), V2 (V2). Returns unique_id; poll tasks/status until is_complete=true.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"model":{"type":"string","enum":["V1_PLUS","V2_5","V2"]},"source_song_id":{"anyOf":[{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},{"type":"string","pattern":"^[1-9]\\d*$"}]},"full_lyrics":{"type":"string","minLength":1,"maxLength":5000},"style":{"type":"string","minLength":1,"maxLength":1000},"title":{"type":"string","minLength":1,"maxLength":255},"infill_start_s":{"type":"number","minimum":0},"infill_end_s":{"type":"number","exclusiveMinimum":0},"negative_tags":{"type":"string","maxLength":1000},"workspace_id":{"type":"string","pattern":"^[1-9]\\d*$"}},"required":["source_song_id","full_lyrics","style","title","infill_start_s","infill_end_s"]},"example":{"model":"V2_5","source_song_id":1,"full_lyrics":"The complete edited lyrics","title":"Journey","style":"Acoustic folk","infill_start_s":30,"infill_end_s":45}}}},"responses":{"200":{"description":"Task accepted","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"code":{"type":"number","const":0},"message":{"type":"string"},"data":{"type":"object","properties":{"unique_id":{"type":"string"},"status":{"type":"string","const":"pending"},"cost":{"type":"number"}},"required":["unique_id","status"],"additionalProperties":false}},"required":["code","message","data"],"additionalProperties":false}}}},"400":{"description":"Invalid request or insufficient API balance"},"401":{"description":"Invalid or revoked API key"}}}},"/openapi/v1/music/tasks/status":{"post":{"tags":["Music"],"summary":"Read your music tasks","description":"Free. All IDs are local strings. is_complete indicates generation and transfer are settled. Media URLs are present only after transfer to our storage. Failures use neutral messages. Song IDs can be used for subsequent creations.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"unique_ids":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"string","pattern":"^\\d+$"}}},"required":["unique_ids"],"additionalProperties":false}}}},"responses":{"200":{"description":"Tasks, their statuses and stable media results","content":{"application/json":{"schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"code":{"type":"number","const":0},"message":{"type":"string"},"data":{"type":"object","properties":{"tasks":{"type":"array","items":{"type":"object","properties":{"unique_id":{"type":"string"},"status":{"type":"string","enum":["pending","running","partial","succeeded","failed"]},"is_complete":{"type":"boolean"},"created_at":{"anyOf":[{"type":"number"},{"type":"null"}]},"completed_at":{"anyOf":[{"type":"number"},{"type":"null"}]},"error_code":{"anyOf":[{"type":"number"},{"type":"null"}]},"error_message":{"anyOf":[{"type":"string"},{"type":"null"}]},"songs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"anyOf":[{"type":"string"},{"type":"null"}]},"status":{"type":"string","enum":["failed","ready","generating"]},"audio_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"cover_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"download_url":{"anyOf":[{"type":"string"},{"type":"null"}]},"duration":{"anyOf":[{"type":"number"},{"type":"null"}]},"lyrics":{"anyOf":[{"type":"string"},{"type":"null"}]},"style":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["id","title","status","audio_url","cover_url","download_url","duration","lyrics","style"],"additionalProperties":false}}},"required":["unique_id","status","is_complete","created_at","completed_at","error_code","error_message","songs"],"additionalProperties":false}}},"required":["tasks"],"additionalProperties":false}},"required":["code","message","data"],"additionalProperties":false}}}}}}}}}