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

# 生成音乐 v5



## OpenAPI

````yaml /api-reference/openapi.json post /suno/submit/music
openapi: 3.0.1
info:
  title: MaxAPI 模型 API
  description: MaxAPI 文本、图像、视频、音频和音乐模型接口。
  version: 1.0.0
servers:
  - url: https://api.maxapi.ai
    description: MaxAPI 生产环境
security: []
tags:
  - name: 模型接口
  - name: 模型接口/绘图模型
  - name: 模型接口/绘图模型/OpenAI Dall-e 格式
  - name: 模型接口/绘图模型/Flux系列
  - name: 模型接口/绘图模型/Flux系列/OpenAI Dalle 格式
  - name: 模型接口/绘图模型/Z-image
  - name: 模型接口/绘图模型/Banana生图异步格式(未来可能兼容其他模型)
  - name: 模型接口/聊天接口（Chat）
  - name: 模型接口/视频模型
  - name: 模型接口/视频模型/谷歌veo
  - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式
  - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式/视频生成
  - name: 模型接口/视频模型/谷歌veo/VertexAI-VEO官方格式/任务查询
  - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式
  - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/视频生成
  - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/任务查询
  - name: 模型接口/视频模型/谷歌veo/AIStudio-VEO官方格式/下载视频(只有aistudio有这个动作)
  - name: 模型接口/视频模型/谷歌veo/GCP异步任务接口
  - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式
  - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式/视频生成
  - name: 模型接口/视频模型/谷歌veo/官网逆向接口格式/OpenAI官方视频格式(适配 newapi)
  - name: 模型接口/视频模型/Wan阿里万象(官方格式)
  - name: 模型接口/视频模型/豆包seedance(官方格式)
  - name: 模型接口/视频模型/Vidu官方格式
  - name: 模型接口/视频模型/Vidu官方格式/视频生成
  - name: 模型接口/视频模型/Vidu官方格式/图像生成
  - name: 模型接口/视频模型/Vidu官方格式/音频生成
  - name: 模型接口/视频模型/Vidu官方格式/其他功能
  - name: 模型接口/视频模型/Vidu官方格式/任务管理
  - name: 模型接口/视频模型/MiniMax-Hailuo官方格式
  - name: 模型接口/视频模型/MiniMax-Hailuo官方格式/视频生成
  - name: 模型接口/视频模型/MiniMax-Hailuo官方格式/任务管理
  - name: 模型接口/视频模型/MiniMax-Hailuo-OpenAI-Sora兼容格式
  - name: 模型接口/视频模型/MiniMax-Hailuo-OpenAI-Sora兼容格式/视频生成
  - name: 模型接口/视频模型/Sora-2-官方格式
  - name: 模型接口/视频模型/Sora-2-官方格式/创建角色接口
  - name: 模型接口/视频模型/Sora-2026-01-07新格式
  - name: 模型接口/自动补全接口（Completions）
  - name: 模型接口/图像接口（Images）
  - name: 模型接口/向量生成接口（Embeddings）
  - name: 模型接口/音频接口（Audio）
  - name: 模型接口/MJ图像(视频)接口
  - name: 模型接口/MJ图像(视频)接口/InsightFace任务提交
  - name: 模型接口/MJ图像(视频)接口/任务提交
  - name: 模型接口/MJ图像(视频)接口/任务查询
  - name: 模型接口/MJ图像(视频)接口/MJ视频相关
  - name: 模型接口/Suno音乐接口
  - name: 模型接口/Suno音乐接口/GoAmzAI格式
  - name: 模型接口/Suno音乐接口/GoAmzAI格式/v3.5
  - name: 模型接口/Suno音乐接口/GoAmzAI格式/v3.0
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/所有接口
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景1 生成自定义音乐(带歌词)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 2 通过提示词直接生成音乐(带歌词)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 4 通过提示词直接生成音乐(纯音乐)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景3 生成自定义音乐(纯音乐)
  - name: 模型接口/Suno音乐接口/官网原生格式(v2)/场景 5 上传自定义音频并续写
  - name: 模型接口/Suno音乐接口/生成歌词
  - name: 模型接口/Suno音乐接口/NewAPI兼容格式
  - name: 模型接口/Luma视频接口
  - name: 模型接口/Luma视频接口/GoAmzAI格式
  - name: 模型接口/Luma视频接口/GoAmzAI格式/付费版
  - name: 模型接口/Luma视频接口/GoAmzAI格式/免费版
  - name: 模型接口/Luma视频接口/官网原生格式(v2)
  - name: 模型接口/SD图像接口
  - name: 模型接口/SD图像接口/SD3
  - name: 模型接口/SD图像接口/SDXL
  - name: 模型接口/Fish Audio
  - name: 模型接口/统一视频接口
  - name: 模型接口/统一视频接口/阿里Wan(万相视频
  - name: 模型接口/统一视频接口/Sora2视频
  - name: 模型接口/统一视频接口/Seedance(即梦视频
  - name: 模型接口/统一视频接口/Google-Veo
  - name: 历史接口
  - name: 历史接口/PPT类接入
  - name: 历史接口/请求示例
  - name: 历史接口/原始接口（参数需要定义后才能发送请求）
  - name: 佐糖API
  - name: MewXAI星月熊开放API
  - name: MewXAI星月熊开放API/开放API接口
  - name: MewXAI星月熊开放API/示例
  - name: Ideogram（绘画）
  - name: 可灵API
  - name: RunWay官方API
  - name: 视频生成
  - name: 任务查询
  - name: Wan官方格式
  - name: 图像生成
  - name: 音频生成
  - name: 其他功能
  - name: 任务管理
  - name: InsightFace任务提交
  - name: 任务提交
  - name: Generate
  - name: SDXL & SD1.6
paths:
  /suno/submit/music:
    post:
      tags:
        - 模型接口/Suno音乐接口/NewAPI兼容格式
      summary: 生成音乐 v5
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: false
          example: YOUR_API_KEY
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                prompt:
                  type: string
                mv:
                  type: string
                title:
                  type: string
                tags:
                  type: string
                continue_at:
                  type: integer
                continue_clip_id:
                  type: string
                task:
                  type: string
            example:
              prompt: |-
                [Verse]
                Move your paws
                Left and right
                Jump around
                Feel the light
                Whiskers twitch
                Tails in the air
                Dancing cats
                Everywhere

                [Chorus]
                Cat dance
                Oh
                Let's go!
                Swing your tails
                Don’t say no (don’t say no!)
                Purr and twirl
                Like a show
                Cat dance
                Let's steal the glow

                [Verse 2]
                Tiptoe steps
                Soft and sweet
                Tiny paws
                Unbeatable beat
                Meow to the rhythm
                Claws precise
                Every move
                Feline paradise

                [Chorus]
                Cat dance
                Oh
                Let's go!
                Swing your tails
                Don’t say no (don’t say no!)
                Purr and twirl
                Like a show
                Cat dance
                Let's steal the glow

                [Bridge]
                Ooh-ooh
                Bounce and sway (ooh-ooh!)
                Moonlit grooves
                Night turns to day
                Lean and stretch
                Strike your pose
                Every kitty steals the show

                [Chorus]
                Cat dance
                Oh
                Let's go!
                Swing your tails
                Don’t say no (don’t say no!)
                Purr and twirl
                Like a show
                Cat dance
                Let's steal the glow
              mv: chirp-crow
              title: Cat Dance
              tags: romantic raga
              continue_at: 123
              continue_clip_id: 4c4c80c4-6318-48c7-a314-71dd03ba3a11
              task: extend
            x-maxapi-schema-source: example
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: string
                  data:
                    type: object
                    properties:
                      task_id:
                        type: string
                      notify_hook:
                        type: string
                      action:
                        type: string
                      status:
                        type: string
                      fail_reason:
                        type: string
                      submit_time:
                        type: integer
                      start_time:
                        type: integer
                      finish_time:
                        type: integer
                      progress:
                        type: string
                      search_item:
                        type: string
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                            title:
                              type: string
                            audio_url:
                              type: string
                            video_url:
                              type: string
                            image_url:
                              type: string
                            image_large_url:
                              type: string
                            major_model_version:
                              type: string
                            model_name:
                              type: string
                            status:
                              type: string
                            created_at:
                              type: string
                              format: date-time
                            handle:
                              type: string
                            display_name:
                              type: string
                            avatar_image_url:
                              type: string
                              format: uri
                            user_id:
                              type: string
                            entity_type:
                              type: string
                            is_public:
                              type: boolean
                            is_trashed:
                              type: boolean
                            is_liked:
                              type: boolean
                            is_handle_updated:
                              type: boolean
                            is_contest_clip:
                              type: boolean
                            allow_comments:
                              type: boolean
                            has_hook:
                              type: boolean
                            play_count:
                              type: integer
                            upvote_count:
                              type: integer
                            flag_count:
                              type: integer
                            metadata:
                              type: object
                              properties:
                                can_remix:
                                  type: boolean
                                edited_clip_id:
                                  type: string
                                history:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      continue_at:
                                        type: integer
                                      id:
                                        type: string
                                      infill:
                                        type: boolean
                                      source:
                                        type: string
                                      type:
                                        type: string
                                infill:
                                  type: boolean
                                is_remix:
                                  type: boolean
                                priority:
                                  type: integer
                                prompt:
                                  type: string
                                stream:
                                  type: boolean
                                tags:
                                  type: string
                                task:
                                  type: string
                                type:
                                  type: string
                      audio_url:
                        type: string
                      video_url:
                        type: string
                      image_url:
                        type: string
                      image_large_url:
                        type: string
                      major_model_version:
                        type: string
                      model_name:
                        type: string
                      prompt:
                        type: string
                      type:
                        type: string
                      tags:
                        type: string
                      duration:
                        type: integer
                      error_type:
                        type: string
                      error_message:
                        type: string
                      handle:
                        type: string
                      is_handle_updated:
                        type: boolean
                      is_trashed:
                        type: boolean
                      reaction:
                        nullable: true
                      created_at:
                        type: string
                      title:
                        type: string
                  message:
                    type: string
              example:
                code: success
                data:
                  task_id: 15f3e2b3-fd32-4233-a3b3-3dec3dd1525e
                  notify_hook: ''
                  action: MUSIC
                  status: SUBMITTED
                  fail_reason: ''
                  submit_time: 1754390318
                  start_time: 1754390318
                  finish_time: 0
                  progress: 0%
                  search_item: >-
                    77e2b720-bdd6-486e-a96c-0c97c46e8315,1ca98c30-7a35-4a98-9bee-b46b1f7abe8e
                  data:
                    - id: 77e2b720-bdd6-486e-a96c-0c97c46e8315
                      title: Cat Dance
                      audio_url: ''
                      video_url: ''
                      image_url: ''
                      image_large_url: ''
                      major_model_version: v3
                      model_name: chirp-v3
                      status: submitted
                      created_at: '2025-08-05T10:38:37.985Z'
                      handle: unyieldingencore9039
                      display_name: UnyieldingEncore9039
                      avatar_image_url: https://cdn1.suno.ai/sAura19.jpg
                      user_id: 2841561b-dd5d-4665-ae78-00a9c348b6d1
                      entity_type: song_schema
                      is_public: false
                      is_trashed: false
                      is_liked: false
                      is_handle_updated: false
                      is_contest_clip: false
                      allow_comments: true
                      has_hook: false
                      play_count: 0
                      upvote_count: 0
                      flag_count: 0
                      metadata:
                        can_remix: true
                        edited_clip_id: 4c4c80c4-6318-48c7-a314-71dd03ba3a11
                        history:
                          - continue_at: 123
                            id: 4c4c80c4-6318-48c7-a314-71dd03ba3a11
                            infill: false
                            source: web
                            type: gen
                        infill: false
                        is_remix: false
                        priority: 10
                        prompt: |-
                          [Verse]
                          Move your paws
                          Left and right
                          Jump around
                          Feel the light
                          Whiskers twitch
                          Tails in the air
                          Dancing cats
                          Everywhere

                          [Chorus]
                          Cat dance
                          Oh
                          Let's go!
                          Swing your tails
                          Don’t say no (don’t say no!)
                          Purr and twirl
                          Like a show
                          Cat dance
                          Let's steal the glow

                          [Verse 2]
                          Tiptoe steps
                          Soft and sweet
                          Tiny paws
                          Unbeatable beat
                          Meow to the rhythm
                          Claws precise
                          Every move
                          Feline paradise

                          [Chorus]
                          Cat dance
                          Oh
                          Let's go!
                          Swing your tails
                          Don’t say no (don’t say no!)
                          Purr and twirl
                          Like a show
                          Cat dance
                          Let's steal the glow

                          [Bridge]
                          Ooh-ooh
                          Bounce and sway (ooh-ooh!)
                          Moonlit grooves
                          Night turns to day
                          Lean and stretch
                          Strike your pose
                          Every kitty steals the show

                          [Chorus]
                          Cat dance
                          Oh
                          Let's go!
                          Swing your tails
                          Don’t say no (don’t say no!)
                          Purr and twirl
                          Like a show
                          Cat dance
                          Let's steal the glow
                        stream: true
                        tags: romantic raga
                        task: extend
                        type: gen
                    - id: 1ca98c30-7a35-4a98-9bee-b46b1f7abe8e
                      title: Cat Dance
                      audio_url: ''
                      video_url: ''
                      image_url: ''
                      image_large_url: ''
                      major_model_version: v3
                      model_name: chirp-v3
                      status: submitted
                      created_at: '2025-08-05T10:38:37.985Z'
                      handle: unyieldingencore9039
                      display_name: UnyieldingEncore9039
                      avatar_image_url: https://cdn1.suno.ai/sAura19.jpg
                      user_id: 2841561b-dd5d-4665-ae78-00a9c348b6d1
                      entity_type: song_schema
                      is_public: false
                      is_trashed: false
                      is_liked: false
                      is_handle_updated: false
                      is_contest_clip: false
                      allow_comments: true
                      has_hook: false
                      play_count: 0
                      upvote_count: 0
                      flag_count: 0
                      metadata:
                        can_remix: true
                        edited_clip_id: 4c4c80c4-6318-48c7-a314-71dd03ba3a11
                        history:
                          - continue_at: 123
                            id: 4c4c80c4-6318-48c7-a314-71dd03ba3a11
                            infill: false
                            source: web
                            type: gen
                        infill: false
                        is_remix: false
                        priority: 10
                        prompt: |-
                          [Verse]
                          Move your paws
                          Left and right
                          Jump around
                          Feel the light
                          Whiskers twitch
                          Tails in the air
                          Dancing cats
                          Everywhere

                          [Chorus]
                          Cat dance
                          Oh
                          Let's go!
                          Swing your tails
                          Don’t say no (don’t say no!)
                          Purr and twirl
                          Like a show
                          Cat dance
                          Let's steal the glow

                          [Verse 2]
                          Tiptoe steps
                          Soft and sweet
                          Tiny paws
                          Unbeatable beat
                          Meow to the rhythm
                          Claws precise
                          Every move
                          Feline paradise

                          [Chorus]
                          Cat dance
                          Oh
                          Let's go!
                          Swing your tails
                          Don’t say no (don’t say no!)
                          Purr and twirl
                          Like a show
                          Cat dance
                          Let's steal the glow

                          [Bridge]
                          Ooh-ooh
                          Bounce and sway (ooh-ooh!)
                          Moonlit grooves
                          Night turns to day
                          Lean and stretch
                          Strike your pose
                          Every kitty steals the show

                          [Chorus]
                          Cat dance
                          Oh
                          Let's go!
                          Swing your tails
                          Don’t say no (don’t say no!)
                          Purr and twirl
                          Like a show
                          Cat dance
                          Let's steal the glow
                        stream: true
                        tags: romantic raga
                        task: extend
                        type: gen
                  audio_url: ''
                  video_url: ''
                  image_url: ''
                  image_large_url: ''
                  major_model_version: ''
                  model_name: ''
                  prompt: ''
                  type: ''
                  tags: ''
                  duration: 0
                  error_type: ''
                  error_message: ''
                  handle: ''
                  is_handle_updated: false
                  is_trashed: false
                  reaction: null
                  created_at: ''
                  title: ''
                message: ''
              x-maxapi-schema-source: example
          headers: {}
      deprecated: false
      security: []

````