API Reference
API Reference / Endpoints / Music

Generate instrumentals

/v1/music/instrumentals

Create instrumental music from a text brief.

POST/v1/music/instrumentals
Auth: API keyBilling: Consumes 1 API callBehavior: AsyncScopes: audio:generate
POSTAsyncjsonaudio:generate

When to use it

Use this when you want the fastest path to non-vocal music without lyrics handling.

Behavior on success

Returns 202 Accepted with a request_id. Poll the status endpoint or use webhooks.

Integration shape

Authorization model
audio:generate
Request format
json
Polling pattern
Poll status if the route returns processing.

Request

FieldTypeRequiredDescription
promptstringYesInstrumental direction, mood, genre, pacing, and texture.

Example request

POST /v1/music/instrumentals
const response = await fetch('https://prod-backup-backend.wubble.ai/v1/music/instrumentals', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WUBBLE_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "prompt": "Warm cinematic instrumental with strings, piano, and gradual build"
}),
});

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

Example response

Response shapejson
{
  "success": true,
  "data": {
    "request_id": "<uuid>",
    "status": "processing",
    "estimated_seconds": 75
  }
}

Implementation notes

Async route. Use the unified request status endpoint for polling.

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
LyricsNext