歌词 / 灵感 / 音效 / 标签 | ToAPIs Documentation

POST

/v1/music/generations/lyrics

国内用户请注意： 中国大陆用户请使用 https://toapis.cn 作为接口地址（Base URL）。

POST https://toapis.com/v1/music/generations/{operation}

modelstring请求体必填

固定 "suno"

lyrics — 歌词生成($0.008)

promptstring请求体必填

歌词主题描述

lyrics_modelstring请求体

歌词模型：classic / remi（可选）

curl --request POST \
  --url https://toapis.com/v1/music/generations/lyrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","prompt":"写一首关于夏日海边的歌"}'

inspo — 参考音频灵感生成($0.068,Max $0.136)

以 1-4 条参考音频为灵感生成新歌曲。

audio_urlsarray请求体必填

1-4 条公网音频 URL

max_modeboolean请求体

Max 档（本操作无 custom，直接生效）

不要传 custom，上游会拒绝。

sounds — 音效生成($0.0096)

promptstring请求体必填

音效描述

typestring请求体

音效类型

bpmnumber请求体

节拍（范围 1-300)

keystring请求体

调性

upsampleTags — 风格标签扩写($0.004)

将简短风格标签扩写为详细风格描述。

tagsstring请求体必填

风格标签，如 "lo-fi chill beats"

curl --request POST \
  --url https://toapis.com/v1/music/generations/upsampleTags \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"model":"suno","tags":"lo-fi chill beats"}'

Response

task_idstring

任务 ID

statusstring

submitted