跳转到主要内容
POST
/
api
/
v1
/
lyrics
生成歌词
curl --request POST \
  --url https://api.kie.ai/api/v1/lyrics \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "一首关于童年回忆和在小镇长大的怀旧歌曲",
  "callBackUrl": "https://api.example.com/callback"
}
'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "5c79****be8e"
  }
}

​
使用指南

  • 使用此接口为音乐创作创建歌词
  • 每个请求将生成多个歌词变体
  • 每套生成的歌词包括标题和结构化的verse/chorus部分

​
参数详情

  • prompt 应描述所需歌词的主题、风格或题材
  • 详细的提示词会产生更有针对性和相关性的歌词

​
开发者注意事项

  • 生成的歌词将保留14天
  • 完成时会通过回调一次性返回所有生成的变体
  • 通常每个请求会返回2-3种不同的歌词变体
  • 每套歌词都按标准部分标记格式化（[Verse], [Chorus]等）

授权

​
Authorization
string
header
必填

所有接口都需要通过 Bearer Token 方式进行认证。

获取 API Key:

  1. 访问 API Key 管理页面 获取您的 API Key

使用方式: 在请求头中添加： Authorization: Bearer YOUR_API_KEY

注意事项：

  • 请妥善保管您的 API Key，不要泄露给他人
  • 如果怀疑 API Key 泄露，请立即在管理页面重置

请求体

application/json
​
prompt
string
必填

对所需歌词内容的描述。具体说明您希望歌词中包含的主题、情绪、风格或故事元素。提示越详细，结果越好。最大字数限制为200字。

示例:

"一首关于童年回忆和在小镇长大的怀旧歌曲"

​
callBackUrl
string<uri>
必填

用于接收歌词生成任务完成更新的URL地址。所有歌词生成请求都需要此参数。

  • 系统将在歌词生成完成时向此URL发送POST请求，包含任务状态和结果
  • 回调包含生成的所有歌词变体及其标题和结构化内容
  • 您的回调端点应能接受包含歌词数据的JSON载荷的POST请求
  • 详细的回调格式和实现指南，请参见 歌词生成回调
  • 或者，您也可以使用获取歌词详情接口来轮询任务状态
  • 为确保回调安全性，请参阅 Webhook 校验指南 了解签名验证实现方法
示例:

"https://api.example.com/callback"

响应

请求成功

​
code
enum<integer>

响应状态码

  • 200: 请求成功
  • 400: 无效参数
  • 401: 未授权访问
  • 404: 无效的请求方法或路径
  • 405: 超出速率限制
  • 413: 主题或提示过长
  • 429: 积分不足
  • 430: 您的调用频率过高，请稍后再试
  • 455: 系统维护
  • 500: 服务器错误
可用选项:
200,
400,
401,
404,
405,
413,
429,
430,
455,
500
​
msg
string

当 code != 200 时的错误信息

示例:

"success"

​
data
object