Music

Write song lyrics with Udio

Has Udio write lyrics from a description, without generating any audio. Settles in seconds; result is { lyrics, instrumental, tempo? }. Pass duration to match the song you intend to generate — the same prompt yields roughly 8 lines at 32s and 30 at 130s. Pass lyrics to have Udio rewrite existing words instead of starting from nothing. Feed the result back as udioParams.lyrics on POST /v2/music/generate.

post/v2/music/udio/lyrics

Request

  • Base URL: https://api.apiframe.ai
  • URL: https://api.apiframe.ai/v2/music/udio/lyrics
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Headers

Idempotency-Keystring

Optional client-supplied key (max 255 chars). Replaying the same key within 24 hours returns the original job rather than creating a duplicate. Strongly recommended for any non-idempotent network: cron jobs, browser retries, mobile clients.

Request body

promptstring required
lyricsstring
webhookUrlstring uri
webhookEventsstring[]

Response

Job accepted and queued. Track via GET /v2/jobs/{id} or webhook.

jobIdstring uuid required
status'QUEUED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' required

Status at the moment the job record was persisted. Almost always QUEUED; idempotent replays may return the original status.

Changes

No recorded changes to this operation across all 1 revision of this API.