---
title: "Music Generation"
method: POST
path: "/v1/music_generation"
tags: ["Music"]
---

# Music Generation

`POST /v1/music_generation`

## Request

- Base URL: `https://api.minimax.io`
- URL: `https://api.minimax.io/v1/music_generation`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/minimax/apis/minimax-api-2/docs/v1/music_generation/post.ts> (a function with typed inputs; its response is checked against the schema)

Generate music from text prompt

## Request body

- GenerateMusicReq
  - `refer_voice` string: Reference music voice_id
  - `refer_instrumental` string: Reference instrumental file_id
  - `lyrics` string, required: Music lyrics
  - `model` string, required: Model to use for music generation
  - `stream` boolean: Whether to use streaming
  - `audio_setting` AudioSetting (unresolved $ref)
  - `refer_vocal` string: Reference vocal voice_id
  - `prompt` string: Music creation inspiration description
  - `reference_music_id` string: Reference music ID
  - `seed` integer: Random seed for generation
  - `output_format` string: Output format
  - `aigc_watermark` boolean: Whether to add AIGC watermark

## Response `200`

Successful response

- GenerateMusicResp
  - `data` MusicData
    - `audio` string: Generated music data in hex encoding
    - `status` integer: Synthesis status: 1-synthesizing, 2-completed
  - `trace_id` string: Request unique identifier
  - `extra_info` MusicExtraInfo
    - `audio_length` integer: Audio duration in milliseconds
    - `audio_size` integer: Audio size in bytes
    - `audio_bitrate` integer: Bitrate
    - `audio_sample_rate` integer: Sample rate
    - `music_duration` integer: Music duration
    - `create_at` integer: Creation timestamp
    - `finish_at` integer: Completion timestamp
    - `music_sample_rate` integer: Music sample rate
    - `music_channel` integer: Music channel
    - `bitrate` integer: Bitrate
    - `music_size` integer: Music size
  - `analysis_info` MusicAnalysisInfo
    - `song_information_analysis` SongInformationAnalysis: Song information analysis
    - `vocal_information_analysis` VocalInformationAnalysis: Vocal information analysis
    - `arrangement_features_analysis` ArrangementFeaturesAnalysis: Arrangement features analysis

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `500`: Internal server error

---

[API](https://skmtc.dev/minimax/apis/minimax-api-2.md) - [All operations](https://skmtc.dev/minimax/apis/minimax-api-2/llms.txt) - [OpenAPI document](https://skmtc.dev/minimax/apis/minimax-api-2/revisions/b18c2ab45c0e?raw)