Music GenerationtaskType: boost_music_style10 Credits / Task

Boost Music Style

Optimize and expand concise musical style descriptions into rich, evocative Suno AI prompts. The booster adds acoustic depth, specific instruments, vocal textures, and genre markers to maximize musical impact.

POST/api/v1/createTask
Test in Playground

Usage Guide & Overview

  • Simple Input to Rich Prompt: Pass simple keywords via content (e.g. "Pop, Mysterious" or "Cyberpunk City").
  • AI Prompt Expansion: The model expands your prompt with acoustic textures, instruments, bass qualities, and tempo cues optimized for Suno V6.
  • Direct Integration: Use the resulting result string directly as the style or tags parameter in generation endpoints.
  • Cost Efficiency: Consumes only 10 credits per style boost task.

How It Enhances Your Music

Prompt Engine
Acoustic Textures

Adds reverb qualities, stereo presence, vinyl crackle, or spatial depth.

Specific Instruments

Expands broad tags into concrete instrumentation like 808 sub-bass, arpeggios, and Rhodes piano.

Vocal Timbre Cues

Incorporates vocal phrasing modifiers such as airy harmonies, soulful belts, or whispered tones.

Input Recommendations & Best Practices

Input Content Rules

  • Provide concise, focused genre or mood keywords (1 to 10 words works best).
  • Separate distinct descriptors with commas (e.g. "Electronic, Darkwave, Driving Beat").
  • Avoid putting full song lyrics into the style booster; use it strictly for sonic and musical style attributes.

Authentication & Headers

HeaderRequirementDescription
Authorizationrequired

Bearer YOUR_API_KEY

Secret Key generated from dashboard

Content-Typerequired

application/json

Request payload format

Request Body Schema

4 fields
contentstringrequired

Initial music style or genre description to boost and expand. Provide concise keywords or mood phrases (e.g. "Pop, Mysterious" or "Cinematic Synthwave").

taskTypestringoptional
default:boost_music_style

Task routing identifier. Explicitly set to "boost_music_style" (or "boost-music-style").

modelstringoptional
default:ai-music-api/boost-music-style

AI booster model identifier. Default: "ai-music-api/boost-music-style".

callBackUrlstringoptional

Public Webhook URL to receive asynchronous completion notifications when style expansion finishes.

Request Sample
curl -X POST "https://api.sunoapi.top/api/v1/createTask" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskType": "boost_music_style",
    "content": "Pop, Mysterious",
    "callBackUrl": "https://api.yourdomain.com/webhook/suno"
  }'
Response Body(200 status)
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "7a8b9c0d1e2f3a4b",
    "param": "Pop, Mysterious",
    "result": "Dark atmospheric synthpop with haunting female vocals, pulsating 80s bassline, shimmering arpeggiated synths, cinematic reverb, and suspenseful moody rhythm",
    "creditsConsumed": 10,
    "creditsRemaining": 90,
    "successFlag": "SUCCESS",
    "createTime": "2026-09-25 01:40:00"
  }
}

When Callbacks Are Sent

The SongMesh API automatically triggers an HTTP POST request to your designated callBackUrl under these events:

  • Style expansion and prompt enhancement completed (code: 200)
  • Style optimization task failed or timed out (code: 400, 500, 501)

Webhook Payload Format

Response Body(200 status)
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "7a8b9c0d1e2f3a4b",
    "param": "Pop, Mysterious",
    "result": "Dark atmospheric synthpop with haunting female vocals, pulsating 80s bassline, shimmering arpeggiated synths, cinematic reverb, and suspenseful moody rhythm",
    "creditsConsumed": 10,
    "creditsRemaining": 90,
    "successFlag": "SUCCESS",
    "errorCode": 0,
    "errorMessage": null,
    "createTime": "2026-09-25 01:40:00"
  }
}

Callback Payload Fields

FieldTypeDescription
codeintegerExecution status code (200: Success, 400: Bad params, 500: Server error)
msgstringExecution result message or error description
data.taskIdstringUnique task identifier, consistent with the taskId returned on creation
data.paramstringOriginal input style query provided in the request
data.resultstringEnriched and expanded musical style prompt, optimized for Suno generation endpoints
data.creditsConsumednumberCredits consumed by this operation (10 credits)

Receiver Implementation Example

Webhook Receiver
// Next.js App Router Webhook Receiver (/api/webhook/suno/route.ts)
import { NextRequest, NextResponse } from 'next/server';

export async function POST(req: NextRequest) {
  const payload = await req.json();
  const { code, msg, data } = payload;

  if (code === 200 && data) {
    const { taskId, param, result } = data;
    console.log(`Style booster completed for task ${taskId}`);
    console.log(`Original input: "${param}"`);
    console.log(`Boosted Suno style prompt: "${result}"`);
    // Use the boosted style prompt directly in generate-music / extend-music...
  } else {
    console.error(`Style boost failed (${code}): ${msg}`);
  }

  return NextResponse.json({ received: true });
}

Webhook Security Recommendation

Always verify incoming webhook payloads on your server. Respond with a 200 OK immediately after parsing the payload to prevent redundant delivery retries from the webhook dispatcher.

Previous EndpointAdd Instrumental to MusicNext EndpointGenerate Mashup Music

Ready to integrate Boost Music Style?

Create your free account, obtain your Secret Key, and get 100 free generation credits.

Generate Secret Key