跳转到主要内容
POST
/
v1
/
lyrics_generation
歌词生成
curl --request POST \
  --url https://api.minimaxi.com/v1/lyrics_generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "mode": "write_full_song",
  "prompt": "一首关于夏日海边的轻快情歌"
}
'
{
  "song_title": "夏日海风的约定",
  "style_tags": "Mandopop, Summer Vibe, Romance, Lighthearted, Beach Pop",
  "lyrics": "[Intro]\n(Ooh-ooh-ooh)\n(Yeah)\n阳光洒满了海面\n\n[Verse 1]\n海风轻轻吹拂你发梢\nSmiling face, like a summer dream\n浪花拍打着脚边\nLeaving footprints, you and me\n沙滩上留下我们的笑\nEvery moment, a sweet melody\n看着你眼中的闪耀\nLike the stars in the deep blue sea\n\n[Pre-Chorus]\n你说这感觉多么奇妙\n(So wonderful)\n想要永远停留在这一秒\n(Right here, right now)\n心跳加速,像海浪在奔跑\n\n[Chorus]\nOh, 夏日的海边,我们的约定\n阳光下,你的身影,如此动听\n微风吹散了烦恼,只留下甜蜜\n这瞬间,只想和你,永远在一起\n(永远在一起)\n\n[Verse 2]\n...",
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}

授权

Authorization
string
header
必填

HTTP: Bearer Auth

  • Security Scheme Type: http
  • HTTP Authorization Scheme: Bearer API_key,用于验证账户信息,可在 账户管理>接口密钥 中查看。

请求头

Content-Type
enum<string>
默认值:application/json
必填

请求体的媒介类型,请设置为 application/json,确保请求数据的格式为 JSON

可用选项:
application/json

请求体

application/json
mode
enum<string>
必填

生成模式。
write_full_song:写完整歌曲
edit:编辑/续写歌词

可用选项:
write_full_song,
edit
prompt
string

提示词/指令,用于描述歌曲主题、风格或编辑方向。为空时随机生成。

Maximum string length: 2000
lyrics
string

现有歌词内容,仅在 edit 模式下有效。可用于续写或修改已有歌词。

Maximum string length: 3500
title
string

歌曲标题。传入后输出将保持该标题不变。

响应

200 - application/json

成功响应

song_title
string

生成的歌名。若请求传入 title 则保持一致。

style_tags
string

风格标签,逗号分隔。例如:Pop, Upbeat, Female Vocals

lyrics
string

生成的歌词,包含结构标签。可直接用于音乐生成接口lyrics 参数生成歌曲。
支持的结构标签(14种):[Intro], [Verse], [Pre-Chorus], [Chorus], [Hook], [Drop], [Bridge], [Solo], [Build-up], [Instrumental], [Breakdown], [Break], [Interlude], [Outro]

base_resp
object

状态码及详情