# 提升音乐风格 > 音频生成 使用 Suno AI 对音乐风格描述进行增强提升。这是 **V4_5 模型的专属功能**。 **V4_5 模型优势：** V4_5 的风格功能得到了显著增强，可以容纳更详细的风格指令。以前可能需要 "deep house, emotional, melodic" 这样的提示，现在可以使用更详细的描述，如： > "Create a melodic, emotional deep house song featuring organic textures and hypnotic rhythms. Begin with soft ambient layers, natural sounds, and a deep, steady groove." **cURL 示例：** ```bash curl --request POST \ --url 'https://api.modelverse.cn/v1/suno/boost-music-style' \ --header 'Authorization: Bearer YOUR_API_KEY' \ --header 'Content-Type: application/json' \ --data '{ "model": "suno-boost-music-style", "input": { "prompt": "Pop, Mysterious" } }' ``` ## 请求地址 `POST https://api.modelverse.cn/v1/suno/boost-music-style` ## 请求体 ## 响应 - **200** — 成功响应 - **400** — 参数错误 - **413** — 提示词过长 - **default** — 错误响应 ## OpenAPI 定义 ```json { "openapi": "3.1.0", "x-language": "zh-CN", "info": { "title": "Suno 提升音乐风格", "version": "1.0.0", "description": "使用 Suno AI 对音乐风格描述进行增强提升。这是 **V4_5 模型的专属功能**，可以将简单的风格描述（如 \"Pop, Mysterious\"）转换为更详细、更具描述性的风格文本。\n\n**接口地址：** `POST /v1/suno/boost-music-style`\n\n**接口类型：** 同步接口（直接返回结果，无需轮询查询）\n" }, "servers": [ { "url": "https://api.modelverse.cn", "description": "ModelVerse API 端点" } ], "tags": [ { "name": "Suno 提升音乐风格", "description": "Suno V4_5 模型专属的音乐风格增强功能" } ], "security": [ { "bearerAuth": [] } ], "paths": { "/v1/suno/boost-music-style": { "post": { "tags": [ "Suno 提升音乐风格" ], "operationId": "boostMusicStyle", "summary": "提升音乐风格", "description": "使用 Suno AI 对音乐风格描述进行增强提升。这是 **V4_5 模型的专属功能**。\n\n**V4_5 模型优势：**\nV4_5 的风格功能得到了显著增强，可以容纳更详细的风格指令。以前可能需要 \"deep house, emotional, melodic\" 这样的提示，现在可以使用更详细的描述，如：\n> \"Create a melodic, emotional deep house song featuring organic textures and hypnotic rhythms. Begin with soft ambient layers, natural sounds, and a deep, steady groove.\"\n\n**cURL 示例：**\n\n```bash\ncurl --request POST \\\n --url 'https://api.modelverse.cn/v1/suno/boost-music-style' \\\n --header 'Authorization: Bearer YOUR_API_KEY' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"model\": \"suno-boost-music-style\",\n \"input\": {\n \"prompt\": \"Pop, Mysterious\"\n }\n }'\n```\n", "security": [ { "bearerAuth": [] } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoostMusicStyleRequest" }, "examples": { "basic": { "summary": "基础请求", "value": { "model": "suno-boost-music-style", "input": { "prompt": "Pop, Mysterious" } } }, "detailed": { "summary": "详细风格描述", "value": { "model": "suno-boost-music-style", "input": { "prompt": "Create a melodic, emotional deep house song featuring organic textures" } } } } } } }, "responses": { "200": { "description": "成功响应", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BoostMusicStyleResponse" }, "examples": { "success": { "summary": "成功响应", "value": { "code": 200, "msg": "success", "data": { "taskId": "5c79****be8e", "param": "{\"content\":\"Pop, Mysterious\"}", "result": "A captivating pop track shrouded in mystery...", "creditsConsumed": 1, "creditsRemaining": 999, "successFlag": "1", "errorCode": null, "errorMessage": null, "createTime": "2024-01-01T00:00:00" } } } } } } }, "400": { "description": "参数错误", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "invalidParams": { "summary": "参数无效", "value": { "code": 400, "msg": "Invalid parameters" } } } } } }, "413": { "description": "提示词过长", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "examples": { "tooLong": { "summary": "提示词过长", "value": { "code": 413, "msg": "Prompt too long" } } } } } }, "default": { "description": "错误响应", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } } } } }, "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "API key", "description": "ModelVerse API 密钥，通过 `Authorization: Bearer ` 请求头传递\n" } }, "schemas": { "BoostMusicStyleRequest": { "type": "object", "additionalProperties": false, "required": [ "model", "input" ], "properties": { "model": { "type": "string", "description": "固定值 `suno-boost-music-style`", "example": "suno-boost-music-style" }, "input": { "type": "object", "description": "风格提升输入参数", "required": [ "prompt" ], "properties": { "prompt": { "type": "string", "description": "风格描述，用简洁清晰的语言描述期望生成的音乐风格。\n**注意：** 主题或提示词过长会返回 413 错误\n", "example": "Pop, Mysterious" } } } } }, "BoostMusicStyleResponse": { "type": "object", "additionalProperties": false, "required": [ "code", "msg" ], "properties": { "code": { "type": "integer", "description": "状态码，200=成功，其他=错误", "example": 200 }, "msg": { "type": "string", "description": "消息或错误描述", "example": "success" }, "data": { "type": "object", "description": "响应数据（成功时返回）", "properties": { "taskId": { "type": "string", "description": "任务ID", "example": "5c79****be8e" }, "param": { "type": "string", "description": "请求参数JSON字符串", "example": "{\"content\":\"Pop, Mysterious\"}" }, "result": { "type": "string", "description": "增强后的音乐风格描述文本", "example": "A captivating pop track shrouded in mystery..." }, "creditsConsumed": { "type": "number", "description": "消耗的积分", "example": 1 }, "creditsRemaining": { "type": "number", "description": "剩余积分", "example": 999 }, "successFlag": { "type": "string", "description": "执行结果，0-等待中, 1-成功, 2-失败", "enum": [ "0", "1", "2" ], "example": "1" }, "errorCode": { "type": "number", "nullable": true, "description": "错误码", "example": null }, "errorMessage": { "type": "string", "nullable": true, "description": "错误消息", "example": null }, "createTime": { "type": "string", "description": "创建时间", "example": "2024-01-01T00:00:00" } } } } }, "ErrorResponse": { "type": "object", "additionalProperties": true, "required": [ "code", "msg" ], "properties": { "code": { "type": "integer", "description": "错误状态码", "example": 400 }, "msg": { "type": "string", "description": "错误信息", "example": "Invalid parameters" } } } } } } ```