Music

Upload your own audio to Udio

Puts audio from a public URL onto Udio's storage so later generations can reference it. result is { url }, and that URL is the handle: pass it as udioParams.style_ref.file (generate in its style) or udioParams.voice.file (sing with its voice) on as many generations as you like. Uploads are fingerprinted, and are refused when the copyright check does not clear.

post/v2/music/udio/upload

Request

  • Base URL: https://api.apiframe.ai
  • URL: https://api.apiframe.ai/v2/music/udio/upload
  • 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

audioUrlstring required
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.