API Reference
API Reference / Endpoints / Music

Describe audio from URL

/v1/music/analyze/description

Generate a descriptive analysis for an audio file at a URL.

POST/v1/music/analyze/description
Auth: API keyBilling: Consumes 1 API callBehavior: SyncScopes: audio:generate
POSTSyncjsonaudio:generate

When to use it

Use this when you want model-generated metadata and natural-language description for an external audio source.

Behavior on success

Returns a completed payload on the normal success path.

Integration shape

Authorization model
audio:generate
Request format
json
Polling pattern
No polling required on the normal success path.

Request

FieldTypeRequiredDescription
urlstringYesPublicly reachable audio URL.
modelstringOptionalOptional analysis model id.

Example request

POST /v1/music/analyze/description
const response = await fetch('https://prod-backup-backend.wubble.ai/v1/music/analyze/description', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WUBBLE_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "url": "https://example.com/audio/reference.mp3"
}),
});

const payload = await response.json();
console.log(payload);

Example response

Response shapejson
{
  "success": true,
  "data": {
    "instrument": "synth",
    "genres": ["pop"],
    "tags": ["bright", "upbeat"],
    "description": "Bright synth-pop track with energetic percussion."
  }
}

Production guidance

Pair this route with idempotency on POST requests and either request polling or webhooks whenever the response is asynchronous.
Was this page helpful?
Previous
Separate stemsNext