Generate a song

Generate a song using Udio AI.

POST https://api.apiframe.pro/udio-generate

Headers

Name
Value

Content-Type

application/json

Authorization*

Your APIFRAME API Key

Body

Name
Type
Description

prompt*

string

Description/style for the song (e.g., "night breeze, piano", "jazz, pop"). Max 2000 characters.

lyrics

string

Full lyrics when lyrics_type is "user". Max 5000 characters.

lyrics_type

string

generate (AI writes lyrics), user (use provided lyrics), or instrumental (no lyrics). Default: generate

negative_tags

string

Tags to avoid, comma-separated (e.g., "pop,rock"). Max 500 characters.

seed

string

Seed for reproducibility. Use -1 for random.

webhook_url

string

The final result and updates of this task will be posted at this URL.

webhook_secret

string

Will be passed as x-webhook-secret in the webhook call headers for authentication.

Response

// Success, the task has been submitted
{
  "task_id": "29e983ca-7e86-4017-a9e3-ef6fe9cd5f2a"
}

This endpoint doesn't generate the songs instantly, you can use the Fetch endpoint to fetch the result or use webhooks.

The result (posted to the webhook_url or retrieved with the Fetch endpoint) looks like this:

If the job is not completed, you will get a result like this:

Last updated