SunoAI API 文档

SSH终端执行拉起：git clone https://gitee.com/tulong_co/Suno-API.git

API 端点：https://api.sunoaiapi.com/api/v1/

标头参数：

注意：此处的参数不是 。api-keyapi_key

{
  "api-key": "Your API Key",
}

API 查询账户余额

说明：此接口用于查询剩余次数生成音频为账号生成音频，只需携带头信息GET。

路径：/gateway/limit

方法：GET

类型：application/json

返回结果：

{'code': 0, 'msg': 'success', 'data': {'songs_left': 1388, 'points': 0}}

API1 生成音乐

说明：该接口为自定义创建模式，灵活性高。此接口只提交音乐生成任务，需要使用返回的两个并查看结果。song_idAPI2

路径：/gateway/generate/music

方法：POST

类型：application/json

参数：

参数名称	类型	描述	备注
标题	字符串	音乐标题
标签	字符串	音乐风格
提示	字符串	音乐创作提示词
MV型	字符串	型	默认值为 chirp-v3-0，参数不需要
continue_at	字符串		可选参数
continue_clip_id	字符串		可选参数

返回示例：

{
 "code": 0,
 "msg": "success",
 "data": [{
  "user_id": "xxx",
  "song_id": "71540f19-d335-4938-95e7-52b3d524d17c",
  "status": "submitted",
  "title": "Happy dog Song",
  "image_large_url": null,
  "image_url": null,
  "model_name": "chirp-v3",
  "video_url": "",
  "audio_url": "",
  "meta_tags": "happy, rock",
  "meta_prompt": "A happy song about dogs",
  "meta_duration": null,
  "meta_error_msg": null,
  "meta_error_type": null
 }, {
  "user_id": "xxx",
  "song_id": "afdcb554-249d-4d67-90e3-917f7b4f8bfe",
  "status": "submitted",
  "title": "Happy dog Song",
  "image_large_url": null,
  "image_url": null,
  "model_name": "chirp-v3",
  "video_url": "",
  "audio_url": "",
  "meta_tags": "happy, rock",
  "meta_prompt": "A happy song about dogs",
  "meta_duration": null,
  "meta_error_msg": null,
  "meta_error_type": null
 }]
}

关键参数说明：

参数名称	类型	描述	备注
标题	字符串	音乐标题
地位	字符串	生成状态
song_id	字符串	歌曲 ID	可用于查询生成结果

API2 查询生成结果

描述：此接口接受 a 作为参数来查询该 .song_idid

路径：/gateway/feed/{song_id}

方法：GET

类型：application/json

参数：

参数名称	类型	描述	备注
song_id	字符串	歌曲 ID

返回示例：

{
    "code": 0,
    "msg": "success",
    "data": {
        "user_id": "8xxx",
        "song_id": "71540f19-d335-4938-95e7-52b3d524d17c",
        "status": "complete",
        "title": "Happy dog Song",
        "image_large_url": "https://cdn1.suno.ai/image_large_71540f19-d335-4938-95e7-52b3d524d17c.png",
        "image_url": "https://cdn1.suno.ai/image_71540f19-d335-4938-95e7-52b3d524d17c.png",
        "model_name": "chirp-v3",
        "video_url": "https://cdn1.suno.ai/71540f19-d335-4938-95e7-52b3d524d17c.mp4",
        "audio_url": "https://cdn1.suno.ai/71540f19-d335-4938-95e7-52b3d524d17c.mp3",
        "meta_tags": "happy, rock",
        "meta_prompt": "A happy song about dogs",
        "meta_duration": 64,
        "meta_error_msg": null,
        "meta_error_type": null
    }
}

API3 仅基于提示生成音乐 （BETA）

说明：此接口对应 Suno AI 的自定义模式关闭的情况。也就是说，通过对音乐的描述来生成歌曲。

路径：/gateway/generate/gpt_desc

方法：POST

类型：application/json

参数：

参数名称	类型	描述	备注
gpt_description_prompt	字符串	音乐描述
make_instrumental	布尔	如果为真，则表示没有歌词
MV型	字符串	型	默认值为 chirp-v3-0，参数不需要
提示	字符串		可选参数

返回结果请参考API1。 同样，根据 查询生成结果。song_id

API4 音乐生成（类似于 ChatGPT 模式）（测试版）

描述：与 ChatGPT 模式类似，API 最多会等待 220 秒，直到音频生成完成，并会直接返回音频链接等信息。使用此接口发送请求时，请注意超时设置。

路径：/gateway/generate/chatgpt

方法：POST

类型：application/json

参数：

参数名称	类型	描述	备注
gpt_description_prompt	字符串	音乐描述
make_instrumental	布尔	如果为真，则表示没有歌词
MV型	字符串	型	默认值为 chirp-v3-0，参数不需要
提示	字符串		可选参数

返回结果：同时返回两个生成的音频的信息。

生成随机歌词

描述：提供提示参数，为您生成相关歌词。

路径：/gateway/generate/lyrics

方法：POST

类型：application/json

参数：

参数名称	类型	描述	笔记
提示	字符串

响应结果：

{'code': 0, 'msg': 'success', 'data': {'id': '51e70dd6-189d-4bfe-b87c-42c4829d935b'}}

查询歌词生成结果

描述：根据上述接口返回的歌词ID，查询歌词的生成结果。

路径：/gateway/lyrics/{lid}

方法：GET

类型：application/json

参数：

参数名称	类型	描述	笔记
盖子	字符串

响应结果：

{'code': 0, 'msg': 'success', 'data': {'text': "[Verse] ...", 'title': 'Pawsitive Vibes', 'status': 'complete'}}