跳转到主要内容
POST
/
api
/
v1
/
style
/
generate
提升音乐风格
curl --request POST \
  --url https://api.api.box/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

🔑 API 认证说明

所有接口都需要通过 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 - 请求成功
  • ⚠️ 400 - 参数错误
  • ⚠️ 401 - 没有访问权限
  • ⚠️ 404 - 请求方式或者路径错误
  • ⚠️ 405 - 调用超过限制
  • ⚠️ 413 - 主题或者prompt过长
  • ⚠️ 429 - 积分不足
  • ⚠️ 430 - 您的调用频率过高。请稍后再试。
  • ⚠️ 455 - 网站维护
  • ❌ 500 - 服务器异常
Available options:
200,
400,
401,
404,
405,
413,
429,
430,
455,
500
Example:

200

msg
string

当 code != 200 时,展示错误信息

Example:

"success"

data
object
I