跳转到主要内容
POST
/
api
/
v1
/
style
/
generate
提升音乐风格
curl --request POST \
  --url https://api.kie.ai/api/v1/style/generate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "content": "Pop, Mysterious"
}'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "<string>",
    "param": "<string>",
    "result": "<string>",
    "creditsConsumed": 123,
    "creditsRemaining": 123,
    "successFlag": "<string>",
    "errorCode": 123,
    "errorMessage": "<string>",
    "createTime": "<string>"
  }
}
这是V4_5的独特功能。V4_5的风格功能已经得到显著增强,正如官方网站所述:
新4.5模型的众多优势之一是它能够适应更详细的风格指令。在之前的模型中,必须优先考虑具体的流派和风格细节,但现在的指令可以包含更具对话性的提示。 之前,最佳效果可能通过这样的提示词实现:‘深度浩室,情感,旋律。’ 现在,您可以提供这样的提示:‘创作一首富有旋律性和情感的深度浩室歌曲,融入有机质感和催眠节奏。从柔和的环境音层、自然声音和稳定的律动开始。逐渐叠加流动的旋律合成器、温暖的低音线条,以及精致、细腻的打击乐。’
‘风格提升’功能将显著增强用户描述和控制风格的能力。推荐使用此功能。

参数说明

  • content:必填,字符串类型。需包含风格描述。

Authorizations

Authorization
string
header
required

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

获取 API Key:

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

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

注意事项:

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

Body

application/json
content
string
required

风格描述。请用简洁明了的语言描述你期望生成的音乐风格。示例:'Pop, Mysterious'。

Example:

"Pop, Mysterious"

Response

请求成功

code
enum<integer>

响应状态码

  • 200: 成功 - 请求已成功处理
  • 401: 未授权 - 身份验证凭据缺失或无效
  • 402: 积分不足 - 账户没有足够的积分执行此操作
  • 404: 未找到 - 请求的资源或端点不存在
  • 409: 冲突 - WAV记录已存在
  • 422: 验证错误 - 请求参数未通过验证检查
  • 429: 超出限制 - 已超过对此资源的请求限制
  • 451: 未授权 - 获取图像失败。请验证您或您的服务提供商设置的任何访问限制。
  • 455: 服务不可用 - 系统当前正在进行维护
  • 500: 服务器错误 - 处理请求时发生意外错误
可用选项:
200,
401,
402,
404,
409,
422,
429,
451,
455,
500
msg
string

当 code != 200 时的错误信息

Example:

"success"

data
object