API Reference
API Reference / Endpoints / Music

Extend lyrics

/v1/music/lyrics/extend

Continue an existing lyric draft with optional extra direction.

POST/v1/music/lyrics/extend
Auth: API keyBilling: Consumes 1 API callBehavior: SyncScopes: audio:generate
POSTSyncjsonaudio:generate

When to use it

Use this when your draft already has the right shape and you need the next section, verse, or ending.

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
lyricsstringYesExisting lyric text to continue from.
promptstringOptionalOptional guidance for how the next section should evolve.

Example request

POST /v1/music/lyrics/extend
const response = await fetch('https://prod-backup-backend.wubble.ai/v1/music/lyrics/extend', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.WUBBLE_API_KEY}`,
    'Idempotency-Key': crypto.randomUUID(),
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
  "lyrics": "We were driving under neon skies",
  "prompt": "Continue into a bigger pre-chorus with more urgency"
}),
});

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

Example response

Response shapejson
{
  "success": true,
  "data": {
    "lyrics": "We were driving under neon skies...",
    "title": null
  }
}

Implementation notes

This route returns a synchronous lyric continuation payload and does not use request 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
Extend songsNext