> ## 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/fetch/{task_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/fetch/{task_id}: get: tags: - 模型接口/Suno音乐接口/NewAPI兼容格式 summary: 查询歌曲 parameters: - name: task_id in: path description: '' required: true example: ea05eedd-efda-43ba-b09b-787bbba14562 schema: type: string - name: Authorization in: header description: '' required: false example: YOUR_API_KEY schema: type: string responses: '200': description: 请求成功 content: application/json: schema: type: object properties: code: type: string message: 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 data: type: array items: type: object properties: id: type: string tags: type: string state: type: string title: type: string handle: type: string prompt: type: string status: type: string clip_id: type: string duration: type: number is_liked: type: boolean metadata: type: object properties: tags: type: string type: type: string prompt: type: string stream: type: boolean duration: type: number is_remix: type: boolean priority: type: integer can_remix: type: boolean refund_credits: type: boolean free_quota_category: type: string gpt_description_prompt: type: string audio_url: type: string format: uri image_url: type: string format: uri is_public: type: boolean video_url: type: string format: uri created_at: type: string format: date-time flag_count: type: integer is_trashed: type: boolean model_name: type: string play_count: type: integer entity_type: type: string display_name: type: string upvote_count: type: integer comment_count: type: integer allow_comments: type: boolean image_large_url: type: string format: uri avatar_image_url: type: string format: uri is_handle_updated: type: boolean major_model_version: type: string is_following_creator: type: boolean example: code: success message: '' data: task_id: f4a94d75-087b-4bb1-bd45-53ba293faf96 notify_hook: '' action: LYRICS status: SUCCESS fail_reason: '' submit_time: 1716192124 start_time: 1716192124 finish_time: 1716192124 progress: 100% data: - id: 7a4bde37-f81a-4af2-a8a6-0d0c92f745b8 tags: acoustic vibes, whimsical, playful, female vocals state: succeeded title: Feline Reverie handle: croora5o prompt: |- [Verse] Paws tap-dance on the wooden floor Whiskered mischief I adore A tail that flicks like a metronome This feline world feels like my home [Chorus] Oh cat oh cat you're a mystery A stealthy shadow in history You pounce you prance a royal spree The queen of pets you’ll always be [Verse 2] Eyes like jewels they pierce my soul Silent watcher never extols A leap a stretch a quiet yawn You rule the night and greet the dawn [Bridge] The sofa's yours the bed is shared Every snack must be declared A conqueror in a tiny size You’ve claimed my heart no compromise [Verse 3] A paper bag you’ve turned to gold A cozy nook you love to hold From lofty perch you gaze on down In your soft paws resides my crown [Chorus] Oh cat oh cat you're a mystery A stealthy shadow in history You pounce you prance a royal spree The queen of pets you’ll always be status: complete clip_id: 7a4bde37-f81a-4af2-a8a6-0d0c92f745b8 duration: 198.76 is_liked: false metadata: tags: acoustic vibes, whimsical, playful, female vocals type: gen prompt: |- [Verse] Paws tap-dance on the wooden floor Whiskered mischief I adore A tail that flicks like a metronome This feline world feels like my home [Chorus] Oh cat oh cat you're a mystery A stealthy shadow in history You pounce you prance a royal spree The queen of pets you’ll always be [Verse 2] Eyes like jewels they pierce my soul Silent watcher never extols A leap a stretch a quiet yawn You rule the night and greet the dawn [Bridge] The sofa's yours the bed is shared Every snack must be declared A conqueror in a tiny size You’ve claimed my heart no compromise [Verse 3] A paper bag you’ve turned to gold A cozy nook you love to hold From lofty perch you gaze on down In your soft paws resides my crown [Chorus] Oh cat oh cat you're a mystery A stealthy shadow in history You pounce you prance a royal spree The queen of pets you’ll always be stream: true duration: 198.76 is_remix: false priority: 0 can_remix: true refund_credits: false free_quota_category: web_v4_gen gpt_description_prompt: cat audio_url: >- https://cdn1.suno.ai/7a4bde37-f81a-4af2-a8a6-0d0c92f745b8.mp3 image_url: >- https://cdn2.suno.ai/image_7a4bde37-f81a-4af2-a8a6-0d0c92f745b8.jpeg is_public: false video_url: >- https://cdn1.suno.ai/7a4bde37-f81a-4af2-a8a6-0d0c92f745b8.mp4 created_at: '2025-05-05T15:03:51.024Z' flag_count: 0 is_trashed: false model_name: chirp-v4 play_count: 0 entity_type: song_schema display_name: croora5o upvote_count: 0 comment_count: 0 allow_comments: true image_large_url: >- https://cdn2.suno.ai/image_large_7a4bde37-f81a-4af2-a8a6-0d0c92f745b8.jpeg avatar_image_url: https://cdn1.suno.ai/sAura19.jpg is_handle_updated: false major_model_version: v4 is_following_creator: false - id: 375c0c33-988c-4178-98aa-25613f1b763c tags: acoustic vibes, whimsical, playful, female vocals state: succeeded title: Feline Reverie handle: croora5o prompt: |- [Verse] Paws tap-dance on the wooden floor Whiskered mischief I adore A tail that flicks like a metronome This feline world feels like my home [Chorus] Oh cat oh cat you're a mystery A stealthy shadow in history You pounce you prance a royal spree The queen of pets you’ll always be [Verse 2] Eyes like jewels they pierce my soul Silent watcher never extols A leap a stretch a quiet yawn You rule the night and greet the dawn [Bridge] The sofa's yours the bed is shared Every snack must be declared A conqueror in a tiny size You’ve claimed my heart no compromise [Verse 3] A paper bag you’ve turned to gold A cozy nook you love to hold From lofty perch you gaze on down In your soft paws resides my crown [Chorus] Oh cat oh cat you're a mystery A stealthy shadow in history You pounce you prance a royal spree The queen of pets you’ll always be status: complete clip_id: 375c0c33-988c-4178-98aa-25613f1b763c duration: 119.04 is_liked: false metadata: tags: acoustic vibes, whimsical, playful, female vocals type: gen prompt: |- [Verse] Paws tap-dance on the wooden floor Whiskered mischief I adore A tail that flicks like a metronome This feline world feels like my home [Chorus] Oh cat oh cat you're a mystery A stealthy shadow in history You pounce you prance a royal spree The queen of pets you’ll always be [Verse 2] Eyes like jewels they pierce my soul Silent watcher never extols A leap a stretch a quiet yawn You rule the night and greet the dawn [Bridge] The sofa's yours the bed is shared Every snack must be declared A conqueror in a tiny size You’ve claimed my heart no compromise [Verse 3] A paper bag you’ve turned to gold A cozy nook you love to hold From lofty perch you gaze on down In your soft paws resides my crown [Chorus] Oh cat oh cat you're a mystery A stealthy shadow in history You pounce you prance a royal spree The queen of pets you’ll always be stream: true duration: 119.04 is_remix: false priority: 0 can_remix: true refund_credits: false free_quota_category: web_v4_gen gpt_description_prompt: cat audio_url: >- https://cdn1.suno.ai/375c0c33-988c-4178-98aa-25613f1b763c.mp3 image_url: >- https://cdn2.suno.ai/image_375c0c33-988c-4178-98aa-25613f1b763c.jpeg is_public: false video_url: >- https://cdn1.suno.ai/375c0c33-988c-4178-98aa-25613f1b763c.mp4 created_at: '2025-05-05T15:03:51.024Z' flag_count: 0 is_trashed: false model_name: chirp-v4 play_count: 0 entity_type: song_schema display_name: croora5o upvote_count: 0 comment_count: 0 allow_comments: true image_large_url: >- https://cdn2.suno.ai/image_large_375c0c33-988c-4178-98aa-25613f1b763c.jpeg avatar_image_url: https://cdn1.suno.ai/sAura19.jpg is_handle_updated: false major_model_version: v4 is_following_creator: false x-maxapi-schema-source: example headers: {} deprecated: false security: [] ````