Skip to main content
POST
/
api
/
v1
/
style
/
generate
Boost Music Style
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>"
  }
}
This is an exclusive capability of V4_5. The style functionality of V4_5 has been significantly enhanced, as stated on the official website:
One of the many advantages of the new 4.5 model is its ability to accommodate more detailed style instructions. In previous models, it was necessary to prioritize specific genre and style details, but now instructions can incorporate a more conversational prompt. Previously, optimal results might have been achieved with a prompt like: ‘deep house, emotional, melodic.’ Now, you can provide a prompt such as: ‘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. Gradually build with flowing melodic synths, warm basslines, and intricate, subtle percussion.’
The ‘Boost Your Style’ feature will significantly enhance users’ ability to describe and control style. It is recommended for use.

​
Parameter Description

  • content: Required, string type. Style description is required.

Authorizations

​
Authorization
string
header
required

🔑 API Authentication

All endpoints require authentication using Bearer Token.

Get API Key

  1. Visit the API Key Management Page to obtain your API Key

Usage

Add to request headers:

Authorization: Bearer YOUR_API_KEY

⚠️ Note:

  • Keep your API Key secure and do not share it with others
  • If you suspect your API Key has been compromised, reset it immediately from the management page

Body

application/json
​
content
string
required

Style description. Please describe in concise and clear language the music style you expect to generate. Example: 'Pop, Mysterious'

Example:

"Pop, Mysterious"

Response

Request successful

​
code
enum<integer>

Status Codes

  • ✅ 200 - Request successful
  • ⚠️ 400 - Invalid parameters
  • ⚠️ 401 - Unauthorized access
  • ⚠️ 404 - Invalid request method or path
  • ⚠️ 405 - Rate limit exceeded
  • ⚠️ 413 - Theme or prompt too long
  • ⚠️ 429 - Insufficient credits
  • ⚠️ 430 - Your call frequency is too high. Please try again later.
  • ⚠️ 455 - System maintenance
  • ❌ 500 - Server error
Available options:
200,
400,
401,
404,
405,
413,
429,
430,
455,
500
Example:

200

​
msg
string

Error message when code != 200

Example:

"success"

​
data
object