1. suno_music
好易智算-API文档
  • 数字人
  • 大语言
    • doubao-seed-1-8-251228
      • 聊天识图
      • 文本生成
    • gemini-3-pro-preview
      • gemini原生
        • 文本生成
      • chat兼容
        • 文本生成
    • glm-4.7-flash和glm-4.7
      • 对话补全
    • claude-opus-4-5-20251101
      • 对话补全
    • deepseek
      • 对话补全
    • gpt-5.2
      • 对话补全
    • gpt-5.2-pro
      • 对话
    • gpt-5.4
      • 对话
    • gpt-5.4-pro
      • 对话
    • glm-4.6v-flash
      • 创建聊天
    • glm-4.7-flash
      • 对话补全
    • gpt-5.3-codex
      • 对话补全
    • gemini-3.1-pro-preview
      • 文本生成
    • gemini-3-flash-preview
      • Chat(聊天)
    • claude-sonnet-4-6
      • Chat(聊天)
      • 创建聊天补全 (流式)
    • claude-4-6-opus
      • Chat(聊天)
      • 创建聊天补全 (流式)
  • 绘图
    • gpt-image-1.5
      • 创建 gpt-image-1.5
      • 编辑 gpt-image-1.5
      • 蒙版 gpt-image-1.5
    • cogview-3-flash
      • 图像生成
    • doubao-seedream-4-0-250828
      • doubao-seedream-4-0-250828
    • doubao-seedream-4-5-251128
      • doubao-seedream-4-5-251128
    • gemini-3-pro-image-preview
      • gemini原生
        • 图片生成 (控制宽高比 +清晰度)
    • nano-banana-pro
      • 图片生成
      • 查询结果
    • nano-banana-2
      • 图片生成
      • 查询结果
    • gpt-4o-image-vip
      • 生成图片
      • 编辑图片
      • 蒙版图片
    • qwen-image-max
      • 文生图
    • qwen-image-edit-max-2026-01-16
      • 图像编辑
    • kling-Omni-Image
      • 图生视频
      • 查询
    • wan2.6-image
      • 通义万相-通用图像编辑2.1
      • 查询结果
    • gemini-2.5-flash-image
      • 图片生成 gemini-2.5-flash-image
      • gemini图片创作接口 [chat兼容格式]
    • mj_imagine
      • 提交Imagine任务
      • 根据ID列表查询任务
    • gemini-3.1-flash-image-preview
      • 图片生成
    • kling-video-o1
      • 图生视频
      • 查询
      • 图片生成
  • 视频
    • doubao-seedance-1-5-pro-251215
      • 文生视频
      • 图生视频-首帧
      • seedance-lite-首尾帧
      • 图生视频-base64编码
      • seedance-lite-参考图
      • 查询单个任务
      • 查询视频生成任务列表-默认
      • 查询视频生成任务列表-搜索多个任务 ID
    • doubao-seedance-1-0-pro-fast-251015
      • 文生视频
      • 图生视频-首帧
      • seedance-lite-首尾帧
      • 图生视频-base64编码
      • seedance-lite-参考图
      • 查询单个任务
      • 查询视频生成任务列表
      • 查询视频生成任务列表-搜索多个任务
    • doubao-seedance-1-0-pro-250528
      • 文生视频
      • 图生视频-首帧
      • seedance-lite-首尾帧
      • 图生视频-base64编码
      • seedance-lite-参考图
      • 查询单个任务
      • 查询视频生成任务列表
      • 查询视频生成任务列表-搜索多个任务
    • doubao-seedance-1-0-lite-i2v-250428
      • 文生视频
      • 图生视频-首帧
      • seedance-lite-首尾帧
      • 图生视频-base64编码
      • seedance-lite-参考图
      • 查询单个任务
    • sora-2
      • 文生视频
      • 图生视频
      • 查询结果
    • sora-2-pro
      • 创建视频
      • 查询视频任务详情
      • 转存视频
    • wan2.6-i2v-flash
      • 通义万相-图生视频-基于首帧
      • 查询结果
    • wan2.6-r2v
      • 通义万相-参考生视频
      • 根据任务ID查询结果
    • wan2.6-i2v
      • 通义万相-图生视频-基于首帧
      • 根据任务ID查询结果
    • cogvideox-3
      • 视频生成(异步)
      • 查询异步结果
    • grok-video-3
      • 查询任务
      • 创建视频
    • 海螺
      • MiniMax-Hailuo-2.3-Fast
        • 图生视频(异步)
        • 查询任务
      • MiniMax-Hailuo-02
        • 图生视频(异步)
        • 文生视频(异步)
        • 查询任务
      • MiniMax-Hailuo-2.3
        • 图生视频(异步)
        • 文生视频(异步)
        • 查询任务
    • veo
      • 文生图
        • 视频生成(异步)
        • 查询任务
      • 图生图
        • 图生视频-基于首帧
        • 图生视频-基于首尾帧
        • 参考生视频
        • 查询任务
    • veo3.1-pro
      • 文生图
        • 视频生成(异步)
      • 图生图
        • 图生视频-基于首帧
        • 图生视频-基于首尾帧
        • 参考生视频
        • 查询任务
    • veo3.1
      • 文生图
        • 视频生成(异步)
      • 图生图
        • 图生视频-基于首帧
        • 图生视频-基于首尾帧
        • 查询任务
    • 可灵 Kling 平台
      • 数字人
        • 数字人
        • 查询任务(单个)
        • 查询任务(单个)
      • kling-v2-1-master
        • 文生视频
          • 文生视频 (天映)
          • 文生视频
          • 查询任务(单个)
        • 图生视频
          • 图生视频
          • 查询任务(单个)
      • kling-video-v2-5-turbo
        • 文成视频
          • 文生视频
          • 查询任务(单个)
        • 图生视频
          • 图生视频
          • 查询任务(单个)
      • kling-video-o1
        • 图生视频
        • 查询
    • 腾讯AIGC视频生成
      • 创建任务
      • 获取请求结果
    • viduq2-pro-fast
      • 图生视频
      • 图生视频-首尾帧
      • 查询任务
    • viduq3-pro
      • 文生视频
      • 图生视频
      • 任务查询
    • viduq2
      • 参考生视频
      • 文生视频
      • 图生视频
      • 任务查询
    • viduq2-turbo
      • 创建首尾帧生视频任务
      • 图生视频
      • 任务查询
    • viduq2-pro
      • 参考生视频
      • 任务查询
    • veo3-fast-frames
      • 创建视频
      • 创建视频,带图片
      • 查询任务
      • 创建视频(参考图)
    • veo3-pro-frames
      • 创建视频
      • 创建视频,带图片
      • 查询任务
      • 创建视频(参考图)
    • veo3.1-components
      • 创建视频
      • 创建视频,带图片
      • 查询任务
      • 创建视频(参考图)
  • 音频
    • Recognize(录音文件极速识别)
  • TTS
    • qwen-tts
      • 语音合成
  • 音乐
    • 海螺 music-2.5
      • 生成歌曲
      • 查询任务
    • 海螺 music-2.0
      • 生成歌曲
      • 查询任务
    • suno v5
      • 生成歌曲(自定义模式)
      • 上传音乐通过url
      • Timing:歌词、音频时间线
      • wav:获取 wav 格式文件
      • Video(获取视频)
      • Speed(调整歌曲速度)
      • Crop(裁剪音乐)
      • wav:获取 wav 格式文件 Copy
      • Add Vocals(纯音乐配人声)
      • Add Instrumental(清唱配乐)
      • Music(Suno歌曲续写)
      • Music(Suno全自动模式)
      • Timing(歌曲时间线)
      • Wav(获取Wav文件)
    • suno_lyrics
      • Suno生成歌词
      • Suno查询任务
    • suno_music
      • Suno上传素材
      • Suno歌曲续写
      • Suno查询任务
  • OCR文字识别
    • qwen-vl-ocr-latest
  • Chat(聊天)
    • 创建聊天补全
    • Chat(修改图片)
    • Chat(流式返回)
    • Chat(兼容Recraftv3)
  • 视频模型
    • 视频生成模型简介
    • 统一格式接口
      • sora2视频
        • chat(聊天格式兼容)
        • sora2文生视频
        • sora2图生视频
        • sora2故事板视频
        • 创建角色 Character
        • sora2 使用角色客串
        • sora2查询任务
    • sora2官方格式
      • 创建视频
      • 创建模型响应
      • 创建模型响应(调用联网)
      • 创建模型响应(流式返回)
      • remix 编辑视频
      • 查询视频进度
    • MiniMax-Hailuo-2.3-Fast
      • 获取视频链接
      • 视频任务状态查询
      • 视频生成任务
    • grok 视频生成
      • 创建视频
      • 查询任务
    • 海螺
      • 状态码
      • 提交视频生成任务
      • 图生视频
      • 首尾帧视频
      • 视频任务状态查询
      • 视频生成任务 Copy
  • 音频模型
    • suno_music
      • 补充
      • GoAmz 配置方式
      • 音乐版本以及生成参数介绍
      • 生成歌曲(自定义模式)
        POST
      • 生成歌曲(灵感模式)
        POST
      • 生成歌曲(续写模式)
        POST
      • 生成歌曲(歌手风格)
        POST
      • 生成歌曲(上传歌曲二次创作)
        POST
      • 生成歌曲(拼接歌曲)
        POST
      • 生成歌曲(曲声分离)
        POST
      • 生成歌词
        POST
      • 上传请求
        POST
      • 报告上传完毕
        POST
      • 查询上传处理状态
        GET
      • 初始化音频文件
        POST
      • Persona:创建歌手风格
        POST
      • tags: 拓展 style tags
        POST
      • 查询歌词
        GET
      • 查询歌曲
        GET
      • 批量获取任务
        POST
      • Timing:歌词、音频时间线
        GET
      • wav:获取 wav 格式文件
        GET
      • mp4:生成 mp4 mv 视频
        GET
      • 获取 midi
        GET
      • 上传音乐通过url
        POST
      • 生成歌曲 (v1 版本)
        POST
      • 拼接歌曲 (v1 版本)
        POST
      • 生成歌词 (v1 版本)
        POST
      • 声曲分离 (v1 版本)
        POST
      • 查询歌曲 (v1 版本)
        GET
      • 查询歌词 (v1 版本)
        GET
    • suno-actions
      • 批量获取任务
      • 生成歌曲(灵感模式)
      • 上传音乐通过url
  • 绘图模型
    • 生图模型简介
    • doubao-seedream-4-5-251128
      • 即梦3 图生图
      • 即梦3 文生图
    • kling-v2-6
      • 文生视频
      • 查询任务(文生视频)
      • 图生视频
      • 查询任务(图生视频)
      • 多图参考生图
      • 多图参考生视频
      • 视频延长
      • 对口型
      • 视频特效
      • 自定义音色
      • 文生音效
      • 查询任务(免费)
      • Omni-Video
      • Omni-Video查询任务(免费)
      • Omni-Video 创建自定义主体
      • Omni-Video 查询自定义主体
      • Omni-Video 查询预设主体
      • 视频生音效
      • 扩图
      • 视频延长
    • wan2.6-i2v-flash
      • 通义万相-图生视频-基于首帧
    • cogview-3-flash
      • 图像生成
    • 可灵 Kling 平台
      • 图像生成
        • 图像生成
        • 查询任务(单个)
  • 模型
    • gpt-4o-image-vip
      • Chat(聊天)
      • Chat(修改图片)
      • Chat(流式返回)
      • Chat(兼容Recraftv3)
      • Chat(修改图片)
      • Chat(生成图片)
      • 创建模型响应
      • 创建模型响应(流式返回)
      • 创建模型响应(调用联网)
    • gpt-image-1.5
      • Chat(聊天)
      • Chat(工具tools调用)
      • Chat(修改图片)
      • Chat(兼容Recraftv3)
      • Chat(流式返回)
      • Chat(修改图片)
      • Chat(生成图片)
      • 图像编辑(gpt-image-1)
      • 4o 图像编辑(异步)
      • Flux
      • Dall-e 携带参考图
      • 创建模型响应
      • 创建模型响应(流式返回)
      • 创建模型响应(调用联网)
    • mj_fast_high_variation
      • 获取请求结果
      • FLUX.1 [Dev] 文本生成图片
      • FLUX.1 [Dev] 图片生成图片
      • FLUX.1 [Dev] Redux
      • FLUX.1 [Schell] Redux
      • FLUX.1 Kontext [Pro]
      • FLUX.1 Kontext [Max]
      • FLUX.1 Kontext [Max Multi](实验性多图编辑)
      • FLUX.1 Kontext [Multi](实验性多图编辑)
      • FLUX.1 Kontext [Max] 文本转图像
      • FLUX.1 Kontext [Max] 文本转图像
    • 模型2
      • 天映—sora-2 生成视频
      • 天映sora-2 查询任务
      • 生成视频
      • 查询任务
    • sora-2
      • 创建视频
      • 查询视频任务详情
      • 转存视频
  1. suno_music

查询歌曲

开发中
GET
https://maas.haoee.com/suno/fetch/{task_id}

请求参数

Path 参数

Header 参数

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://maas.haoee.com/suno/fetch/' \
--header 'Authorization: {{API_KEY}}' \
--header 'ModelName;' \
--header 'Content-Type: application/json'

返回响应

🟢200成功
application/json
Body

示例
{
    "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]\nPaws tap-dance on the wooden floor\nWhiskered mischief I adore\nA tail that flicks like a metronome\nThis feline world feels like my home\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be\n\n[Verse 2]\nEyes like jewels they pierce my soul\nSilent watcher never extols\nA leap a stretch a quiet yawn\nYou rule the night and greet the dawn\n\n[Bridge]\nThe sofa's yours the bed is shared\nEvery snack must be declared\nA conqueror in a tiny size\nYou’ve claimed my heart no compromise\n\n[Verse 3]\nA paper bag you’ve turned to gold\nA cozy nook you love to hold\nFrom lofty perch you gaze on down\nIn your soft paws resides my crown\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe 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]\nPaws tap-dance on the wooden floor\nWhiskered mischief I adore\nA tail that flicks like a metronome\nThis feline world feels like my home\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be\n\n[Verse 2]\nEyes like jewels they pierce my soul\nSilent watcher never extols\nA leap a stretch a quiet yawn\nYou rule the night and greet the dawn\n\n[Bridge]\nThe sofa's yours the bed is shared\nEvery snack must be declared\nA conqueror in a tiny size\nYou’ve claimed my heart no compromise\n\n[Verse 3]\nA paper bag you’ve turned to gold\nA cozy nook you love to hold\nFrom lofty perch you gaze on down\nIn your soft paws resides my crown\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe 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]\nPaws tap-dance on the wooden floor\nWhiskered mischief I adore\nA tail that flicks like a metronome\nThis feline world feels like my home\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be\n\n[Verse 2]\nEyes like jewels they pierce my soul\nSilent watcher never extols\nA leap a stretch a quiet yawn\nYou rule the night and greet the dawn\n\n[Bridge]\nThe sofa's yours the bed is shared\nEvery snack must be declared\nA conqueror in a tiny size\nYou’ve claimed my heart no compromise\n\n[Verse 3]\nA paper bag you’ve turned to gold\nA cozy nook you love to hold\nFrom lofty perch you gaze on down\nIn your soft paws resides my crown\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe 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]\nPaws tap-dance on the wooden floor\nWhiskered mischief I adore\nA tail that flicks like a metronome\nThis feline world feels like my home\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe queen of pets you’ll always be\n\n[Verse 2]\nEyes like jewels they pierce my soul\nSilent watcher never extols\nA leap a stretch a quiet yawn\nYou rule the night and greet the dawn\n\n[Bridge]\nThe sofa's yours the bed is shared\nEvery snack must be declared\nA conqueror in a tiny size\nYou’ve claimed my heart no compromise\n\n[Verse 3]\nA paper bag you’ve turned to gold\nA cozy nook you love to hold\nFrom lofty perch you gaze on down\nIn your soft paws resides my crown\n\n[Chorus]\nOh cat oh cat you're a mystery\nA stealthy shadow in history\nYou pounce you prance a royal spree\nThe 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
            }
        ]
    }
}
上一页
查询歌词
下一页
批量获取任务
Built with