🎵Suno

TTAPI Suno接口服务

生成音乐

POST https://api.ttapi.io/suno/v1/music

通过文字提示词或者自定义歌词生成音乐，注：每次请求生成两首音乐，不可拆分，定价详见

Headers

Name
Value

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Body

参数
类型
是否必须
描述

mv

string

是

使用模型 suno使用模型，支持 chirp-v3-0 chirp-v3-5 chirp-v4 当前默认chirp-v4

custom

boolean

是

音频是否自定义 true - 音频将从歌词中生成 false - 音频将根据灵感模式提示词生成

instrumental

boolean

是

是否生成纯音乐 true 为生成纯音乐，true的情况下会忽略自定义歌词 默认为false

gpt_description_prompt

string

否

灵感模式提示词 根据此提示词自动生成歌词

prompt

string

否

歌词，自定义模式专用

title

string

否

标题，自定义模式专用

tags

string

否

风格标签，自定义模式专用

music_id

string

否

歌曲ID，需要延长的歌曲

continue_at

int

否

歌曲延长时间，单位：秒

hookUrl

string

否

回调通知地址，当设置此参数，任务成功或者失败降会向该地址发送一个post请求，携带数据与查询任务结果中返回一致

Response

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

生成歌词

POST https://api.ttapi.io/suno/v1/lyrics

根据提示词生成歌词，定价详见

Headers

Name
Value

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Body

参数
类型
是否必须
描述

prompt

string

是

提示词

hookUrl

string

否

回调通知地址，当设置此参数，任务成功或者失败将会向该地址发送一个post请求，携带数据与查询任务结果返回一致

Response

{
  "status": "SUCCESS",
  "message": "",
  "data": {
    "jobId": "ed1a1b01-7d64-4c8a-acaa-71185d23a2f3"
  }
}

查询任务结果

POST https://api.ttapi.io/suno/v1/fetch

通过jobId查询当前音乐&歌词生成结果，免费接口

Headers

Name
Value

Content-Type

application/json

TT-API-KEY

用于请求授权 TT-API 的API密钥

Query参数

参数
类型
是否必须
描述

jobId

string

是

生成的音乐或者歌词的jobId

Response

异步回调josn结构与fetch接口查询返回结构一致

{
    "status": "SUCCESS",
    "message": "success",
    "jobId": "34505837-41f0-4c68-b830-e8e051b72148",
    "data": {
        "jobId": "34505837-41f0-4c68-b830-e8e051b72148",
        "action": "extend",
        "progress": "100%",
        "mv": "chirp-v3-0",
        "quota": "5",
        "hookUrl": null,
        "musics": [
            {
                "musicId": "a7d3712d-2507-4d87-80d0-b60bb375a049",
                "prompt": "[Verse]\n远方你的微笑\n穿越时空寻找\n夜晚的风轻飘\n心跳为你燃烧\n\n[Bridge]\n梦里花落几场\n想你思念成霜\n星光作伴凄凉\n入骨相思难忘\n\n[Chorus]\n思念入骨髓\n心已随风飞\n两地相隔泪\n只为与你归",
                "title": "思念入骨髓 (Longing in My Bones)",
                "tags": "harmonized melancholic traditional chinese",
                "imageUrl": "https://cdn2.suno.ai/image_a7d3712d-2507-4d87-80d0-b60bb375a049.jpeg",
                "imageLargeUrl": "https://cdn2.suno.ai/image_large_a7d3712d-2507-4d87-80d0-b60bb375a049.jpeg",
                "audioUrl": "https://cdn1.suno.ai/a7d3712d-2507-4d87-80d0-b60bb375a049.mp3",
                "videoUrl": "https://cdn1.suno.ai/a7d3712d-2507-4d87-80d0-b60bb375a049.mp4"
            },
            {
                "musicId": "ab763675-b371-44d5-ae1b-6aea35fe4403",
                "prompt": "[Verse]\n远方你的微笑\n穿越时空寻找\n夜晚的风轻飘\n心跳为你燃烧\n\n[Bridge]\n梦里花落几场\n想你思念成霜\n星光作伴凄凉\n入骨相思难忘\n\n[Chorus]\n思念入骨髓\n心已随风飞\n两地相隔泪\n只为与你归",
                "title": "思念入骨髓 (Longing in My Bones)",
                "tags": "harmonized melancholic traditional chinese",
                "imageUrl": "https://cdn2.suno.ai/image_ab763675-b371-44d5-ae1b-6aea35fe4403.jpeg",
                "imageLargeUrl": "https://cdn2.suno.ai/image_large_ab763675-b371-44d5-ae1b-6aea35fe4403.jpeg",
                "audioUrl": "https://cdn1.suno.ai/ab763675-b371-44d5-ae1b-6aea35fe4403.mp3",
                "videoUrl": "https://cdn1.suno.ai/ab763675-b371-44d5-ae1b-6aea35fe4403.mp4"
            }
        ]
    }
}

PreviousLumaNext账户体系

Last updated

Was this helpful?