> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omniall.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 音乐生成

> MiniMax 官方音乐生成（同步风格 JSON 响应）。

**路径：** `POST https://api.omniall.ai/v1/music_generation`

可传 `prompt` 和/或 `lyrics`。纯伴奏可设 `is_instrumental`。

鉴权：`Authorization: Bearer sk-...`



## OpenAPI

````yaml zh-CN/openapi/minimax-music.yaml POST /v1/music_generation
openapi: 3.1.0
info:
  title: Omniall AI — MiniMax音乐
  version: 1.0.0
  description: |-
    MiniMax 官方音乐生成。

    **路径：** `POST https://api.omniall.ai/v1/music_generation`

    模型 ID 以[模型广场](https://omniall.ai/pricing)为准。

    鉴权：`Authorization: Bearer sk-...`
servers:
  - url: https://api.omniall.ai
security: []
paths:
  /v1/music_generation:
    post:
      tags:
        - MiniMax音频
      summary: 音乐生成
      description: |-
        MiniMax 官方音乐生成（同步风格 JSON 响应）。

        **路径：** `POST https://api.omniall.ai/v1/music_generation`

        可传 `prompt` 和/或 `lyrics`。纯伴奏可设 `is_instrumental`。

        鉴权：`Authorization: Bearer sk-...`
      operationId: minimaxCreateMusic
      parameters:
        - name: Authorization
          in: header
          required: true
          schema:
            type: string
            example: Bearer sk-...
          description: Bearer API Key，例如 `Bearer sk-...`。
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model
              description: MiniMax music_generation 请求体。
              properties:
                model:
                  type: string
                  description: 音乐模型 ID（以模型广场为准）。
                  example: music-2.0
                prompt:
                  type: string
                  description: 风格 / 情绪 / 编曲描述。
                  example: 轻快独立流行，明亮吉他与充满希望的副歌
                lyrics:
                  type: string
                  description: 可选歌词。
                  example: |-
                    [主歌]
                    霓虹倒映在潮湿路面
                    [副歌]
                    我们穿过整座不夜城
                stream:
                  type: boolean
                  description: 是否流式（以上游能力为准）。
                  example: false
                output_format:
                  type: string
                  description: 输出封装，如 `url` / `hex`（以上游为准）。
                audio_setting:
                  type: object
                  description: 音频编码参数。
                  properties:
                    sample_rate:
                      type: integer
                      example: 44100
                    bitrate:
                      type: integer
                      example: 256000
                    format:
                      type: string
                      example: mp3
                aigc_watermark:
                  type: boolean
                  description: AIGC 水印。
                lyrics_optimizer:
                  type: boolean
                  description: 生成前优化歌词。
                is_instrumental:
                  type: boolean
                  description: 是否纯伴奏。
                  example: false
            examples:
              仅风格描述:
                summary: 仅风格描述
                value:
                  model: music-2.0
                  prompt: 轻快独立流行，明亮吉他与充满希望的副歌
                  is_instrumental: false
              风格 + 歌词:
                summary: 风格 + 歌词
                value:
                  model: music-2.0
                  prompt: 电影感独立流行，霓虹夜色氛围
                  lyrics: |-
                    [主歌]
                    霓虹倒映在潮湿路面
                    [副歌]
                    我们穿过整座不夜城
                  audio_setting:
                    sample_rate: 44100
                    bitrate: 256000
                    format: mp3
              纯伴奏:
                summary: 纯伴奏
                value:
                  model: music-2.0
                  prompt: 适合深夜编程的柔和氛围钢琴
                  is_instrumental: true
      responses:
        '200':
          description: 音乐生成结果（上游 JSON；通常含音频 URL / hex）
          content:
            application/json:
              schema:
                type: object
                description: MiniMax 上游响应（含 `base_resp` 与音频字段）。
              example:
                data:
                  audio: https://cdn.example.com/track.mp3
                  status: success
                base_resp:
                  status_code: 0
                  status_msg: success

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.