MusicAPI
HomeDocs
HomeDocs
  1. sonic
  • Introduction
  • Credits Usage Guide
  • Music API FAQ & Troubleshooting
  • Special Scenarios
  • Error handling
  • Webhook Integration Guide
  • sonic
    • Sonic Instructions
    • create / extend / cover music
      POST
    • upload and extend music
      POST
    • upload and cover music
      POST
    • create persona
      POST
    • sample
      POST
    • mashup
      POST
    • get BPM
      POST
    • get VOX
      POST
    • get wav
      POST
    • get midi
      POST
    • get lyrics timeline
      POST
    • upsample tags
      POST
    • concat music
      POST
    • stems basic
      POST
    • stems full
      POST
    • upload music
      POST
    • get music
      GET
  • riffusion(Deprecated)
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • producer
    • Producer instructions
    • Complete Request Examples
    • create music
    • upload
    • download
    • get music
  • studio(Unavailable)
    • Studio Instructions
    • description mode (Use case1)
    • extend mode (Use case2)
    • custom mode (Use case3)
    • instrumental mode (Use case4)
    • get music
  • lyrics generation
    • Make Lyrics
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
    • create instrument music
    • get music
  • get-credits
    GET
  • Schemas
    • 记录不存在
    • 参数不正确
HomeDocs
HomeDocs
  1. sonic

upsample tags

POST
https://api.musicapi.ai/api/v1/sonic/upsample-tags
Enhance and expand music style tags using AI. This endpoint takes simple tags and returns more detailed, professional music style descriptions that can improve music generation quality.
Credits cost: 1

Use Cases#

Improve generation quality: Convert simple tags like "pop" into richer descriptions
Discover related styles: Get suggestions for complementary music styles
Professional terminology: Transform casual descriptions into industry-standard terms

Example#

Input: "pop, happy"
Output: "upbeat pop, major key, bright synths, four-on-the-floor beat, catchy hooks, positive lyrics, radio-friendly, contemporary pop production"

Tips#

Start with basic genre and mood tags
The upsampled tags can be used directly in the create-music endpoint's tags field
Combine with your own tags for best results

Request

Authorization
JWT Bearer
Add the parameter
Authorization
to Headers
Example:
Authorization: ********************
or
Body Params application/json

Examples
{
    "tags": "pop"
}

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.musicapi.ai/api/v1/sonic/upsample-tags' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "tags": "pop"
}'

Responses

🟢200success
application/json
Success
Body

Example
{
    "code": 200,
    "message": "success",
    "data": {
        "upsampled_tags": "upbeat pop, major key, bright synthesizers, four-on-the-floor drum pattern, catchy melodic hooks, positive uplifting lyrics, radio-friendly production, contemporary pop sound, polished vocals"
    }
}
Modified at 2026-01-16 05:57:47
Previous
get lyrics timeline
Next
concat music
Built with