Music

Run a follow-up action on a completed Udio job

Runs a follow-up action on a completed udio job, referenced by its job ID. Both actions select one of the parent's songs with index (1–2) or trackId (from the parent's result.tracks[].id). extend adds up to 32 seconds (output_length) to the song, placed before or after it (placement). One extension per call — to build a longer track, extend the result again. remix generates the song again: remix_strength (0.1–1.0, default 0.5) sets how far from the original it lands, and crop_range limits it to part of the track. Anything left out is inherited from the source song; the optional generation fields override it. Both return a fresh pair of Udio songs that can be acted on again. Extending is not available for songs generated with a udio130-* model or longer than 15 minutes. Returns 409 when the action is not available for the parent job.

post/v2/music/udio/action

Request

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

OR

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.