SKUAI接口文档
  1. zeakAi格式
SKUAI接口文档
  • 使用须知
  • OpenAI 通用接口
    • 聊天
      • 1.聊天接口(OpenAI格式通用)
    • 图像
      • 1.创建图像
      • 2.创建图片编辑
  • 绘图模型
    • Midjourney
      • 1.文生图(Imagine)接口
      • 2.按钮点击(Action)接口
      • 3.图片融合(Blend)接口
      • 4.窗口执行(Modal)接口
      • 5.图生文(Describe)接口
      • 6.缩短提示词(Shorten)接口
      • 7.换脸(FaceSwap)接口
      • 8.上传(upload)接口
      • 9.查询接口
      • 10.批量查询接口
      • 11.获取种子(Seed)接口
      • 12.刷新链接(Refresh)接口
    • Flux
      • 官方格式
        • 1.生成图片
        • 2.查询任务
      • OpenAI格式
        • 1.创建图像
        • 2.创建图片编辑
    • Ideogram
      • 1.Generate(文生图)
      • 2.Edit(编辑)
      • 3.Remix(混合图)
      • 4.Upscale(放大高清)
      • 5.Describe(图生文)
  • 音乐模型
    • Suno
      • zeakAi格式
        • 1.生成歌词接口
          POST
        • 2.获取歌词接口
          GET
        • 3.生成音乐(灵感模式)
          POST
        • 4.生成音乐(专业模式)
          POST
        • 5.生成音乐(翻唱模式)
          POST
        • 6.局部编辑音乐
          POST
        • 7.上传音乐
          POST
        • 8.续写音乐
          POST
        • 9.裁剪音乐
          POST
        • 10.合并音乐
          POST
        • 11.查询音乐
          GET
      • newApi格式
        • 1.生成歌词接口
        • 2.生成音乐接口
        • 3.上传音乐接口
        • 4.歌曲拼接接口
        • 5.查询任务
  1. zeakAi格式

11.查询音乐

GET
/suno/task/{id}/fetch
续写后,通过续写的clipId 与原始clip合并成完整歌曲

请求参数

Path 参数
id
string 
任务ID
必需
示例值:
1717680067183517
Header 参数
Authorization
string 
用户中心获取的密钥
可选
示例值:
{{YOUR_API_KEY}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location -g --request GET 'https://openapi.sku.vip/suno/task/1717680067183517/fetch'

返回响应

🟢200成功
application/json
Body
id
string 
任务ID
必需
majorModelVersion
string 
版本
必需
clips
array [object {15}] 
歌曲数组
必需
task_id
string 
歌曲任务id
必需
系统内部使用
id
string 
歌曲ID
必需
可用于续写、合并等
title
string 
歌曲标题
必需
video_url
string 
视频地址
必需
audio_url
string 
音频地址
必需
image_url
string 
封面地址
必需
image_large_url
string 
封面地址
必需
major_model_version
string 
模型版本
必需
model_name
string 
模型名称
必需
status
string 
任务状态
必需
可用值:SUBMITTED,RUNNING,FAILURE,SUCCESS
reaction
null 
评价
必需
is_handle_updated
boolean 
是否更新
必需
is_video_pending
null 
是否视频生成中
必需
created_at
string 
创建时间
必需
metadata
object 
任务元数据
必需
submitAt
string 
提交时间
必需
cost
number 
消耗积分
必需
failReason
null 
失败原因
必需
startAt
string 
开始时间
必需
finishAt
string 
完成时间
必需
status
string 
任务状态
必需
可用值:SUBMITTED,RUNNING,FAILURE,SUCCESS
示例
{
    "id": "17350498477280038",
    "majorModelVersion": "v3.5",
    "clips": [
        {
            "task_id": "1718160",
            "id": "39e6bf6a-06a7-4609-9e3d-9ae961271807",
            "title": "Face-Melting Solo",
            "video_url": "https://cdn1.suno.ai/39e6bf6a-06a7-4609-9e3d-9ae961271807.mp4",
            "audio_url": "https://cdn1.suno.ai/39e6bf6a-06a7-4609-9e3d-9ae961271807.mp3",
            "image_url": "https://cdn2.suno.ai/image_39e6bf6a-06a7-4609-9e3d-9ae961271807.jpeg",
            "image_large_url": "https://cdn2.suno.ai/image_large_39e6bf6a-06a7-4609-9e3d-9ae961271807.jpeg",
            "major_model_version": "v3.5",
            "model_name": "chirp-v3",
            "status": "SUCCESS",
            "reaction": null,
            "is_handle_updated": false,
            "is_video_pending": null,
            "created_at": "2024-12-24 22:17:28",
            "metadata": {
                "duration": 112.76,
                "error_message": null,
                "gpt_description_prompt": "a groovy dance song about writing a face-melting guitar solo",
                "stream": true,
                "error_type": null,
                "concat_history": null,
                "history": null,
                "type": "gen",
                "audio_prompt_id": null,
                "prompt": "[Verse]\nStart with a strum\n(ooh-yeah!)\nFeel the rhythm hum\nFingers on fire\nTaking us higher\nHigher!\n\n[Verse 2]\nStrings in a blaze\nGot the crowd in a daze\nNotes flying free\nFeel the ecstasy\nEcstasy!\n\n[Chorus]\nGuitar on fire\n(yeah, yeah!)\nHigher and higher\nDance to the beat\nSolo so sweet\nSweet!\n\n[Bridge]\nHands on the neck\nMake the world forget\nEvery note a hit\nCan't get enough of it\nIt!\n\n[Verse 3]\nSweat on the strings\nHear the guitar sing\nEvery chord so tight\nLighting up the night\nNight!\n\n[Chorus]\nGuitar on fire\n(yeah, yeah!)\nHigher and higher\nDance to the beat\nSolo so sweet\nSweet!",
                "tags": "dance, groovy, electro-pop"
            }
        },
        {
            "task_id": "1718161",
            "id": "e52a3ea4-bb1c-4894-9a9a-480347964cbd",
            "title": "Face-Melting Solo",
            "video_url": "https://cdn1.suno.ai/e52a3ea4-bb1c-4894-9a9a-480347964cbd.mp4",
            "audio_url": "https://cdn1.suno.ai/e52a3ea4-bb1c-4894-9a9a-480347964cbd.mp3",
            "image_url": "https://cdn2.suno.ai/image_e52a3ea4-bb1c-4894-9a9a-480347964cbd.jpeg",
            "image_large_url": "https://cdn2.suno.ai/image_large_e52a3ea4-bb1c-4894-9a9a-480347964cbd.jpeg",
            "major_model_version": "v3",
            "model_name": "chirp-v3",
            "status": "SUCCESS",
            "reaction": null,
            "is_handle_updated": false,
            "is_video_pending": null,
            "created_at": "2024-12-24 22:17:28",
            "metadata": {
                "duration": 173.24,
                "error_message": null,
                "gpt_description_prompt": "a groovy dance song about writing a face-melting guitar solo",
                "stream": true,
                "error_type": null,
                "concat_history": null,
                "history": null,
                "type": "gen",
                "audio_prompt_id": null,
                "prompt": "[Verse]\nStart with a strum\n(ooh-yeah!)\nFeel the rhythm hum\nFingers on fire\nTaking us higher\nHigher!\n\n[Verse 2]\nStrings in a blaze\nGot the crowd in a daze\nNotes flying free\nFeel the ecstasy\nEcstasy!\n\n[Chorus]\nGuitar on fire\n(yeah, yeah!)\nHigher and higher\nDance to the beat\nSolo so sweet\nSweet!\n\n[Bridge]\nHands on the neck\nMake the world forget\nEvery note a hit\nCan't get enough of it\nIt!\n\n[Verse 3]\nSweat on the strings\nHear the guitar sing\nEvery chord so tight\nLighting up the night\nNight!\n\n[Chorus]\nGuitar on fire\n(yeah, yeah!)\nHigher and higher\nDance to the beat\nSolo so sweet\nSweet!",
                "tags": "dance, groovy, electro-pop"
            }
        }
    ],
    "submitAt": "2024-12-24 22:17:28",
    "cost": 2.5,
    "failReason": null,
    "startAt": "2024-12-24 22:17:28",
    "finishAt": "2024-12-24 22:20:40",
    "status": "SUCCESS"
}
修改于 2025-06-09 06:36:10
上一页
10.合并音乐
下一页
1.生成歌词接口
Built with