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

200

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

400

401

500

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:

{
    "task_id": "29e983ca-7e86-4017-a9e3-xxxxxxxxx",
    "task_type": "udio-generate",
    "status": "finished",
    "songs": [
      {
        "lyrics": "....",
        "song_id": "ea6813ad-03ce-4a0b-a616-xxxxxxxxx",
        "audio_url": "https://....xxxxxxxxx.mp3",
        "image_url": "https://....xxxxxxxxx.jpeg",
      },
      {
        "lyrics": "...",
        "song_id": "21ad7efc-4954-4ae4-ae2a-xxxxxxxx",
        "audio_url": "https://....xxxxxxxxx.mp3",
        "image_url": "https://....xxxxxxxxx.jpeg",
      }
  ]
}

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

{
    "task_id": "29e983ca-7e86-4017-a9e3-xxxxxxxxx",
    "task_type": "udio-generate",
    "status": "processing",
    "percentage": 56,
    "songs": [
      {
        "lyrics": "....",
        "song_id": "ea6813ad-03ce-4a0b-a616-xxxxxxxxx",
        "audio_url": null",
        "image_url": "https://....xxxxxxxxx.jpeg",
      },
      {
        "lyrics": "...",
        "song_id": "21ad7efc-4954-4ae4-ae2a-xxxxxxxx",
        "audio_url": null,
        "image_url": "https://....xxxxxxxxx.jpeg",
      }
  ]
}