Udio API Guide: Generate Music Programmatically

Does Udio Have an Official API?

No. As of this writing, Udio does not offer a public API. Udio's own help center is direct about it: "We know there's keen interest, but we don't currently offer a public API." If you've been searching for official Udio API documentation and coming up empty, that's why, there isn't any to find. Some reports point to limited partner or enterprise beta access for select accounts, but that's not available to the general developer public, and Udio's official public-facing answer remains no.

That's a real gap if you want to build Udio's music generation into a product. The practical path most developers take instead is a third-party platform that has integrated Udio's generation capability into a standard REST API.

How to Generate Music With Udio Through Apiframe

Apiframe exposes Udio generation through the same unified API it uses for its other music, image, and video models. You send a prompt to POST /v2/music/generate with model: "udio", and you get back a job you poll (or get a webhook for) until the track is ready, the same pattern as generating a Midjourney image or a Kling video through the same platform. If you're already using Apiframe for other generation work, adding Udio doesn't mean learning a new auth scheme or a new response format.

Key Parameters and Controls

Udio generation on Apiframe is controlled through a udioParams object:

lyrics_type: "generate" (the default, AI writes lyrics from your description), "user" (you supply the lyrics yourself), or "instrumental" (no vocals at all)

title: track title, up to 80 characters

style: a genre or style hint, up to 1,000 characters, used as the style description when lyrics_type is "user"

negative_tags: comma-separated styles to avoid, up to 500 characters

seed: an integer for reproducible generations

Udio API Pricing

Through Apiframe, Udio generation costs 9 credits per track. For comparison, Suno on the same platform costs 11 credits per generation, so if you're budgeting across both (which makes sense given they solve overlapping but slightly different problems), Udio comes in a bit cheaper per track. Credits are deducted when you submit the request and automatically refunded if the generation fails, so a failed job doesn't cost you anything.

How to Call the Udio API: Code Example

import requests
import time

API_KEY = "afk_your_api_key_here"
BASE_URL = "https://api.apiframe.ai/v2"

headers = {
    "X-API-Key": API_KEY,
    "Content-Type": "application/json",
}

# 1. Submit the generation request
payload = {
    "prompt": "chill lo-fi hip hop beat with jazzy piano chords and vinyl crackle",
    "model": "udio",
    "udioParams": {
        "lyrics_type": "generate",
    },
}

response = requests.post(f"{BASE_URL}/music/generate", headers=headers, json=payload)
response.raise_for_status()
job_id = response.json()["jobId"]
print(f"Job submitted: {job_id}")

# 2. Poll for the result
while True:
    job = requests.get(f"{BASE_URL}/jobs/{job_id}", headers=headers).json()

    if job["status"] == "COMPLETED":
        print("Tracks ready:", job["result"]["tracks"])
        break
    elif job["status"] == "FAILED":
        print("Generation failed:", job.get("error"))
        break

    time.sleep(5)

For a track with your own lyrics instead of AI-generated ones:

curl -X POST https://api.apiframe.ai/v2/music/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "[Verse]\nIn the gentle evening air,\nWhispers dance without a care.\n[Chorus]\nHold me close, never let go",
    "model": "udio",
    "udioParams": {
      "lyrics_type": "user",
      "style": "jazz, pop",
      "title": "Evening Stars"
    }
  }'

And for an instrumental track with no vocals:

curl -X POST https://api.apiframe.ai/v2/music/generate \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "ambient electronic soundscape with evolving pads and gentle arpeggios",
    "model": "udio",
    "udioParams": {
      "lyrics_type": "instrumental",
      "negative_tags": "vocals, singing"
    }
  }'

Udio vs. Suno API

Both are accessible through Apiframe with nearly identical request shapes, which makes it easy to run the same prompt through both and compare. In general, people reach for Udio when they want a more natural, less obviously "AI" vocal texture and a faster average turnaround, and reach for Suno when they want more structural control over full songs (Suno's API also supports extending tracks, generating covers, adding vocals to an existing instrumental, and splitting stems, none of which Udio currently offers through this integration). If you're deciding between the two for a specific project, Apiframe's AI music model rankings break down how Suno, Udio, Mureka, and other models compare on turnaround time, vocal realism, and production control.

Commercial Use and Licensing

Tracks generated through Apiframe's Udio integration come with commercial usage rights as part of your Apiframe plan, since you're not going through Udio's own consumer terms of service, you're generating through Apiframe's infrastructure and licensing. If commercial use is central to your product (background music for a paid app, tracks sold as part of a larger asset pack, and so on), it's worth reading Apiframe's current terms of service directly rather than assuming, since licensing language can be updated.

FAQ

Will Udio release an official API? There's no public timeline. Udio's help center language ("we know there's keen interest") suggests it's on their radar, but nothing concrete has shipped for general developer access as of this writing.

Is there a free trial? Apiframe generally offers starter credits for new accounts to test generation before committing to a paid plan, worth checking the current signup flow for exact numbers since free-tier offers change.

What audio format and quality is returned? Generated tracks are returned as downloadable audio files via CDN URL in the completed job's result.tracks field.

Can lyrics be in languages other than English? Udio's underlying model handles multiple languages reasonably well, though quality and pronunciation accuracy vary by language, it's worth testing your specific target language before building it into a production workflow.

If you're building a product that needs music generation alongside images or video, Apiframe's unified API covers all three under one key, which is worth a look before you wire up a separate integration for each.