> ## 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.

# 获取音乐



## OpenAPI

````yaml /api-reference/openapi.json get /suno/v1/v3.0/music/id
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/v1/v3.0/music/id:
    get:
      tags:
        - 模型接口/Suno音乐接口/GoAmzAI格式/v3.0
      summary: 获取音乐
      parameters:
        - name: Authorization
          in: header
          description: ''
          required: false
          example: Bearer YOUR_API_KEY
          schema:
            type: string
      responses:
        '200':
          description: 请求成功
          content:
            application/json:
              schema:
                type: object
                properties:
                  code:
                    type: integer
                  data:
                    type: object
                    properties:
                      task_id:
                        type: string
                      status:
                        type: string
                      input:
                        type: string
                      clips:
                        type: object
                        properties:
                          e0fe8bba-fac8-460b-bf1c-111111111111:
                            type: object
                            properties:
                              id:
                                type: string
                              video_url:
                                type: string
                              audio_url:
                                type: string
                              image_url:
                                type: string
                              image_large_url:
                                type: string
                              is_video_pending:
                                type: boolean
                              major_model_version:
                                type: string
                              model_name:
                                type: string
                              metadata:
                                type: object
                                properties:
                                  tags:
                                    type: string
                                  prompt:
                                    type: string
                                  gpt_description_prompt:
                                    type: string
                                  audio_prompt_id:
                                    type: string
                                  history:
                                    type: string
                                    nullable: true
                                  concat_history:
                                    type: string
                                    nullable: true
                                  type:
                                    type: string
                                  duration:
                                    type: number
                                  refund_credits:
                                    type: boolean
                                  stream:
                                    type: boolean
                                  error_type:
                                    type: string
                                    nullable: true
                                  error_message:
                                    type: string
                                    nullable: true
                                required:
                                  - tags
                                  - prompt
                                  - gpt_description_prompt
                                  - audio_prompt_id
                                  - history
                                  - concat_history
                                  - type
                                  - duration
                                  - refund_credits
                                  - stream
                                  - error_type
                                  - error_message
                              is_liked:
                                type: boolean
                              is_handle_updated:
                                type: boolean
                              is_trashed:
                                type: boolean
                              reaction:
                                type: string
                                nullable: true
                              created_at:
                                type: string
                              status:
                                type: string
                              title:
                                type: string
                              play_count:
                                type: integer
                              upvote_count:
                                type: integer
                              is_public:
                                type: boolean
                            required:
                              - id
                              - video_url
                              - audio_url
                              - image_url
                              - image_large_url
                              - is_video_pending
                              - major_model_version
                              - model_name
                              - metadata
                              - is_liked
                              - is_handle_updated
                              - is_trashed
                              - reaction
                              - created_at
                              - status
                              - title
                              - play_count
                              - upvote_count
                              - is_public
                          f66f7a6f-a868-464f-b280-111111111111:
                            type: object
                            properties:
                              id:
                                type: string
                              video_url:
                                type: string
                              audio_url:
                                type: string
                              image_url:
                                type: string
                              image_large_url:
                                type: string
                              is_video_pending:
                                type: boolean
                              major_model_version:
                                type: string
                              model_name:
                                type: string
                              metadata:
                                type: object
                                properties:
                                  tags:
                                    type: string
                                  prompt:
                                    type: string
                                  gpt_description_prompt:
                                    type: string
                                  audio_prompt_id:
                                    type: string
                                  history:
                                    type: string
                                    nullable: true
                                  concat_history:
                                    type: string
                                    nullable: true
                                  type:
                                    type: string
                                  duration:
                                    type: number
                                  refund_credits:
                                    type: boolean
                                  stream:
                                    type: boolean
                                  error_type:
                                    type: string
                                    nullable: true
                                  error_message:
                                    type: string
                                    nullable: true
                                required:
                                  - tags
                                  - prompt
                                  - gpt_description_prompt
                                  - audio_prompt_id
                                  - history
                                  - concat_history
                                  - type
                                  - duration
                                  - refund_credits
                                  - stream
                                  - error_type
                                  - error_message
                              is_liked:
                                type: boolean
                              is_handle_updated:
                                type: boolean
                              is_trashed:
                                type: boolean
                              reaction:
                                type: string
                                nullable: true
                              created_at:
                                type: string
                              status:
                                type: string
                              title:
                                type: string
                              play_count:
                                type: integer
                              upvote_count:
                                type: integer
                              is_public:
                                type: boolean
                            required:
                              - id
                              - video_url
                              - audio_url
                              - image_url
                              - image_large_url
                              - is_video_pending
                              - major_model_version
                              - model_name
                              - metadata
                              - is_liked
                              - is_handle_updated
                              - is_trashed
                              - reaction
                              - created_at
                              - status
                              - title
                              - play_count
                              - upvote_count
                              - is_public
                        required:
                          - e0fe8bba-fac8-460b-bf1c-111111111111
                          - f66f7a6f-a868-464f-b280-111111111111
                    required:
                      - task_id
                      - status
                      - input
                      - clips
                  message:
                    type: string
                required:
                  - code
                  - data
                  - message
              example:
                code: 200
                data:
                  task_id: 56ea8da3-8507-4118-9f1e-111111111111
                  status: completed
                  input: >-
                    {"custom_mode":false,"gpt_description_prompt":"blowing in
                    the
                    wind","make_instrumental":false,"prompt":"","title":"","continue_at":0,"continue_clip_id":"","mv":"chirp-v3-0","tags":""}
                  clips:
                    e0fe8bba-fac8-460b-bf1c-111111111111:
                      id: e0fe8bba-fac8-460b-bf1c-111111111111
                      video_url: >-
                        https://cdn1.suno.ai/e0fe8bba-fac8-460b-bf1c-111111111111.mp4
                      audio_url: >-
                        https://cdn1.suno.ai/e0fe8bba-fac8-460b-bf1c-111111111111.mp3
                      image_url: >-
                        https://cdn1.suno.ai/image_e0fe8bba-fac8-460b-bf1c-111111111111.png
                      image_large_url: >-
                        https://cdn1.suno.ai/image_large_e0fe8bba-fac8-460b-bf1c-111111111111.png
                      is_video_pending: false
                      major_model_version: v3
                      model_name: chirp-v3
                      metadata:
                        tags: acoustic folk ballad
                        prompt: |-
                          [Verse]
                          Leaves whisper
                          Trees sway
                          In the wind
                          We all play
                          Questions fly
                          Answers hide
                          In this world
                          Side by side

                          [Verse 2]
                          Birds soar
                          Clouds roam
                          In the breeze
                          We find home
                          Searching for truth
                          In the sky
                          As the wind carries our sigh

                          [Chorus]
                          Blowin' in the breeze
                          We're like the leaves
                          Wonderin' where life takes us
                          Where it leads
                          With every gust
                          We let go of what we know
                          Blowin' in the breeze
                          We're free to grow
                        gpt_description_prompt: blowing in the wind
                        audio_prompt_id: ''
                        history: null
                        concat_history: null
                        type: gen
                        duration: 108.8
                        refund_credits: false
                        stream: true
                        error_type: null
                        error_message: null
                      is_liked: false
                      is_handle_updated: false
                      is_trashed: false
                      reaction: null
                      created_at: '2024-04-18T14:29:31.760Z'
                      status: complete
                      title: Blowin' in the Breeze
                      play_count: 0
                      upvote_count: 0
                      is_public: false
                    f66f7a6f-a868-464f-b280-111111111111:
                      id: f66f7a6f-a868-464f-b280-111111111111
                      video_url: >-
                        https://cdn1.suno.ai/f66f7a6f-a868-464f-b280-111111111111.mp4
                      audio_url: >-
                        https://cdn1.suno.ai/f66f7a6f-a868-464f-b280-111111111111.mp3
                      image_url: >-
                        https://cdn1.suno.ai/image_f66f7a6f-a868-464f-b280-111111111111.png
                      image_large_url: >-
                        https://cdn1.suno.ai/image_large_f66f7a6f-a868-464f-b280-111111111111.png
                      is_video_pending: false
                      major_model_version: v3
                      model_name: chirp-v3
                      metadata:
                        tags: acoustic folk ballad
                        prompt: |-
                          [Verse]
                          Leaves whisper
                          Trees sway
                          In the wind
                          We all play
                          Questions fly
                          Answers hide
                          In this world
                          Side by side

                          [Verse 2]
                          Birds soar
                          Clouds roam
                          In the breeze
                          We find home
                          Searching for truth
                          In the sky
                          As the wind carries our sigh

                          [Chorus]
                          Blowin' in the breeze
                          We're like the leaves
                          Wonderin' where life takes us
                          Where it leads
                          With every gust
                          We let go of what we know
                          Blowin' in the breeze
                          We're free to grow
                        gpt_description_prompt: blowing in the wind
                        audio_prompt_id: ''
                        history: null
                        concat_history: null
                        type: gen
                        duration: 103.2
                        refund_credits: false
                        stream: true
                        error_type: null
                        error_message: null
                      is_liked: false
                      is_handle_updated: false
                      is_trashed: false
                      reaction: null
                      created_at: '2024-04-18T14:29:31.761Z'
                      status: complete
                      title: Blowin' in the Breeze
                      play_count: 0
                      upvote_count: 0
                      is_public: false
                message: success
      deprecated: false
      security: []

````