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 / remaster / add vocals / add instrumental
      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
    • stems basic
      POST
    • stems full
      POST
    • replace section
      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
    • 记录不存在
    • 参数不正确
  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
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
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
stems basic
Built with