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

批量获取任务

开发中
POST
https://maas.haoee.com/suno/fetch

请求参数

Header 参数

Body 参数application/json

示例
{
    "ids": [
        "462f8185-c1ba-40dc-8881-fa3b052dbe0c"
    ],
    "action": "MUSIC"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://maas.haoee.com/suno/fetch' \
--header 'Authorization: {{API_KEY}}' \
--header 'ModelName;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "ids": [
        "462f8185-c1ba-40dc-8881-fa3b052dbe0c"
    ],
    "action": "MUSIC"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "success",
    "message": "",
    "data": [
        {
            "task_id": "d9ccfc46-d553-4bf7-a181-b877ed14e068",
            "platform": "suno",
            "action": "UPLOAD",
            "status": "SUCCESS",
            "fail_reason": "",
            "submit_time": 1767061265,
            "start_time": 1767061265,
            "finish_time": 1767061279,
            "progress": "100%",
            "data": [
                {
                    "allow_comments": true,
                    "audio_url": "https://cdn1.suno.ai/d9ccfc46-d553-4bf7-a181-b877ed14e068.mp3",
                    "avatar_image_url": "https://cdn1.suno.ai/sAura11.jpg",
                    "batch_index": 0,
                    "clip_id": "d9ccfc46-d553-4bf7-a181-b877ed14e068",
                    "comment_count": 0,
                    "created_at": "2025-12-30T02:21:05.143Z",
                    "display_name": "HighEndBreakbeat2848",
                    "display_tags": "Chinese folk-pop, guzheng, female vocal",
                    "duration": 95.52979,
                    "entity_type": "song_schema",
                    "flag_count": 0,
                    "handle": "highendbreakbeat2848",
                    "has_hook": false,
                    "id": "d9ccfc46-d553-4bf7-a181-b877ed14e068",
                    "image_large_url": "https://cdn2.suno.ai/image_large_d9ccfc46-d553-4bf7-a181-b877ed14e068.jpeg",
                    "image_url": "https://cdn2.suno.ai/image_d9ccfc46-d553-4bf7-a181-b877ed14e068.jpeg",
                    "is_contest_clip": false,
                    "is_following_creator": false,
                    "is_handle_updated": false,
                    "is_liked": false,
                    "is_public": false,
                    "is_trashed": false,
                    "major_model_version": "",
                    "metadata": {
                        "can_publish_with_vocal": true,
                        "can_remix": true,
                        "duration": 95.52979591836734,
                        "has_stem": false,
                        "has_vocal": false,
                        "is_remix": false,
                        "prompt": "[Chorus]\n我自观山天秋\n千秋皆入画\n更有飞雪\n说与风与马\n我是千里故人\n青山隐白首\n年少有劫\n应偿这风流\n\n[Verse 1]\n仗剑行荒\n饮此故鸿儒\n向人世间尽一副归貌\n\n[Chorus]\n纵一二歌\n与怀仗杯酒\n何上万里人与君同寿\n我自观山天秋\n千秋皆入画\n更有飞雪\n说与风与马\n我是千里故人\n青山隐白首\n年少有劫\n应偿这风流\n我自观山天秋\n千秋皆入画\n更有飞雪\n说与风与马\n我是千里故人\n青山隐白首\n年少有劫\n应偿这风流",
                        "secondary_badges": [
                            {
                                "dark": {
                                    "background_color": "FFFFFF0C",
                                    "border_color": "00000000",
                                    "text_color": "A3A3A3"
                                },
                                "display_name": "Uploaded",
                                "icon_key": "uploaded",
                                "light": {
                                    "background_color": "1C1C1F0A",
                                    "border_color": "00000000",
                                    "text_color": "7D7C83"
                                }
                            }
                        ],
                        "tags": "This is a Chinese folk-pop song with a moderate tempo and a major key. The instrumentation features a prominent guzheng, a plucked zither, playing a flowing melodic line, accompanied by a string section providing sustained harmonies and counter-melodies. A drum kit provides a light, driving rhythm with a focus on snare and cymbals. The lead female vocal is clear and expressive, utilizing a vibrato technique and a relatively high register. The song structure includes verses and a chorus, with the guzheng often taking a lead role in instrumental breaks. Production elements include a clean mix with a slight reverb on the vocals and guzheng, creating a spacious and ethereal atmosphere. The melody is highly ornamented, characteristic of traditional Chinese music, but presented within a contemporary pop framework. The chord progression is diatonic and largely follows a I-IV-V-I pattern, providing a sense of resolution and familiarity.",
                        "type": "upload",
                        "uses_latest_model": false
                    },
                    "model_name": "chirp-chirp",
                    "play_count": 0,
                    "prompt": "[Chorus]\n我自观山天秋\n千秋皆入画\n更有飞雪\n说与风与马\n我是千里故人\n青山隐白首\n年少有劫\n应偿这风流\n\n[Verse 1]\n仗剑行荒\n饮此故鸿儒\n向人世间尽一副归貌\n\n[Chorus]\n纵一二歌\n与怀仗杯酒\n何上万里人与君同寿\n我自观山天秋\n千秋皆入画\n更有飞雪\n说与风与马\n我是千里故人\n青山隐白首\n年少有劫\n应偿这风流\n我自观山天秋\n千秋皆入画\n更有飞雪\n说与风与马\n我是千里故人\n青山隐白首\n年少有劫\n应偿这风流",
                    "state": "succeeded",
                    "status": "complete",
                    "tags": "This is a Chinese folk-pop song with a moderate tempo and a major key. The instrumentation features a prominent guzheng, a plucked zither, playing a flowing melodic line, accompanied by a string section providing sustained harmonies and counter-melodies. A drum kit provides a light, driving rhythm with a focus on snare and cymbals. The lead female vocal is clear and expressive, utilizing a vibrato technique and a relatively high register. The song structure includes verses and a chorus, with the guzheng often taking a lead role in instrumental breaks. Production elements include a clean mix with a slight reverb on the vocals and guzheng, creating a spacious and ethereal atmosphere. The melody is highly ornamented, characteristic of traditional Chinese music, but presented within a contemporary pop framework. The chord progression is diatonic and largely follows a I-IV-V-I pattern, providing a sense of resolution and familiarity.",
                    "title": "up-241244ce-80b0-4355-abf4-d4324a0ada84",
                    "upvote_count": 0,
                    "video_url": ""
                }
            ],
            "cost": 0.01,
            "search_item": "d9ccfc46-d553-4bf7-a181-b877ed14e068"
        }
    ]
}
上一页
查询歌曲
下一页
Timing:歌词、音频时间线
Built with