# Boost Music Style

> Audio Generation

Use Suno AI to enhance and boost music style descriptions. This is a **V4_5 model exclusive feature**.

**V4_5 Model Advantages:**
The V4_5 model's style capabilities have been significantly enhanced to accommodate more detailed style instructions. Previously, you might need prompts like "deep house, emotional, melodic", but now you can use more detailed descriptions like:
> "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 Example:**

```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"
    }
  }'
```

## Endpoint

`POST https://api.modelverse.cn/v1/suno/boost-music-style`

## Request Body

## Responses

- **200** — Success response
- **400** — Invalid parameters
- **413** — Prompt too long
- **default** — Error response

## OpenAPI Definition

```json
{
  "openapi": "3.1.0",
  "x-language": "en-US",
  "info": {
    "title": "Suno Boost Music Style API",
    "version": "1.0.0",
    "description": "Use Suno AI to enhance and boost music style descriptions. This is a **V4_5 model exclusive feature** that can transform simple style descriptions (e.g., \"Pop, Mysterious\") into more detailed and descriptive style text.\n\n**Endpoint:** `POST /v1/suno/boost-music-style`\n\n**Interface Type:** Synchronous (returns result directly, no polling required)\n"
  },
  "servers": [
    {
      "url": "https://api.modelverse.cn",
      "description": "ModelVerse API endpoint"
    }
  ],
  "tags": [
    {
      "name": "Suno Boost Music Style",
      "description": "Suno V4_5 model exclusive music style enhancement feature"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/suno/boost-music-style": {
      "post": {
        "tags": [
          "Suno Boost Music Style"
        ],
        "operationId": "boostMusicStyle",
        "summary": "Boost Music Style",
        "description": "Use Suno AI to enhance and boost music style descriptions. This is a **V4_5 model exclusive feature**.\n\n**V4_5 Model Advantages:**\nThe V4_5 model's style capabilities have been significantly enhanced to accommodate more detailed style instructions. Previously, you might need prompts like \"deep house, emotional, melodic\", but now you can use more detailed descriptions like:\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 Example:**\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": "Basic request",
                  "value": {
                    "model": "suno-boost-music-style",
                    "input": {
                      "prompt": "Pop, Mysterious"
                    }
                  }
                },
                "detailed": {
                  "summary": "Detailed style description",
                  "value": {
                    "model": "suno-boost-music-style",
                    "input": {
                      "prompt": "Create a melodic, emotional deep house song featuring organic textures"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Success response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BoostMusicStyleResponse"
                },
                "examples": {
                  "success": {
                    "summary": "Success response",
                    "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": "Invalid parameters",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "invalidParams": {
                    "summary": "Invalid parameters",
                    "value": {
                      "code": 400,
                      "msg": "Invalid parameters"
                    }
                  }
                }
              }
            }
          },
          "413": {
            "description": "Prompt too long",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                },
                "examples": {
                  "tooLong": {
                    "summary": "Prompt too long",
                    "value": {
                      "code": 413,
                      "msg": "Prompt too long"
                    }
                  }
                }
              }
            }
          },
          "default": {
            "description": "Error response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API key",
        "description": "ModelVerse API key sent in the `Authorization: Bearer <API_KEY>` header\n"
      }
    },
    "schemas": {
      "BoostMusicStyleRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "model",
          "input"
        ],
        "properties": {
          "model": {
            "type": "string",
            "description": "Fixed value `suno-boost-music-style`",
            "example": "suno-boost-music-style"
          },
          "input": {
            "type": "object",
            "description": "Style boost input parameters",
            "required": [
              "prompt"
            ],
            "properties": {
              "prompt": {
                "type": "string",
                "description": "Style description using clear and concise language to describe the desired music style.\n**Note:** Overly long prompts will return a 413 error\n",
                "example": "Pop, Mysterious"
              }
            }
          }
        }
      },
      "BoostMusicStyleResponse": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "code",
          "msg"
        ],
        "properties": {
          "code": {
            "type": "integer",
            "description": "Status code, 200=success, others=error",
            "example": 200
          },
          "msg": {
            "type": "string",
            "description": "Message or error description",
            "example": "success"
          },
          "data": {
            "type": "object",
            "description": "Response data (returned on success)",
            "properties": {
              "taskId": {
                "type": "string",
                "description": "Task ID",
                "example": "5c79****be8e"
              },
              "param": {
                "type": "string",
                "description": "Request parameters JSON string",
                "example": "{\"content\":\"Pop, Mysterious\"}"
              },
              "result": {
                "type": "string",
                "description": "Enhanced music style description text",
                "example": "A captivating pop track shrouded in mystery..."
              },
              "creditsConsumed": {
                "type": "number",
                "description": "Credits consumed",
                "example": 1
              },
              "creditsRemaining": {
                "type": "number",
                "description": "Remaining credits",
                "example": 999
              },
              "successFlag": {
                "type": "string",
                "description": "Execution result: 0-pending, 1-success, 2-failed",
                "enum": [
                  "0",
                  "1",
                  "2"
                ],
                "example": "1"
              },
              "errorCode": {
                "type": "number",
                "nullable": true,
                "description": "Error code",
                "example": null
              },
              "errorMessage": {
                "type": "string",
                "nullable": true,
                "description": "Error message",
                "example": null
              },
              "createTime": {
                "type": "string",
                "description": "Creation time",
                "example": "2024-01-01T00:00:00"
              }
            }
          }
        }
      },
      "ErrorResponse": {
        "type": "object",
        "additionalProperties": true,
        "required": [
          "code",
          "msg"
        ],
        "properties": {
          "code": {
            "type": "integer",
            "description": "Error status code",
            "example": 400
          },
          "msg": {
            "type": "string",
            "description": "Error message",
            "example": "Invalid parameters"
          }
        }
      }
    }
  }
}
```
