producer
Producer

Cover an existing music track

Reinterpret a previously generated or uploaded clip in a new style. The cover keeps the source clip's structural skeleton and re-records it according to your instruction. The strength parameter (0–1) controls how strongly the cover diverges from the original.

Auto-refund: if the upstream cover fails, the 12-credit charge is automatically refunded.

Migration note

The legacy cover_strength field is still accepted and is treated as a back-compat alias for strength. Existing SDK calls continue to work without code changes. If neither field is provided, strength defaults to 0.5.

post/api/v1/producer/create

Request

  • Base URL
    https://api.musicapi.ai
  • URL
    https://api.musicapi.ai/api/v1/producer/create
  • Auth
    HTTP bearer

Request body

task_type'cover_music' | 'cover_upload_music' required

Use cover_music when the source clip_id came from create_music, extend_music, or replace_music. Use cover_upload_music when the source clip_id came from POST /api/v1/producer/upload.

clip_idstring required

ID of the source clip to cover. Obtained from a previous Producer task result or from /api/v1/producer/upload.

instructionstring

Editorial guidance describing the desired style of the cover. Recommended — clearer than sound for describing how to reinterpret the source. If omitted, derived from sound and lyrics as a fallback.

strengthnumber float

Transformation intensity. Lower values stay closer to the original; higher values diverge more aggressively. Defaults to 0.5 if neither strength nor the legacy cover_strength is provided.

cover_strengthnumber float

Deprecated. Legacy alias for strength. Existing SDK calls that pass this field continue to work. If both strength and cover_strength are provided, strength wins.

soundstring

Optional. Sound/style prompt. Used as fallback to derive instruction if instruction is not provided.

lyricsstring

Optional. Used as fallback to derive instruction if neither instruction nor sound is provided.

titlestring

Optional. Title for the cover track.

seedstring

Optional. Random seed for reproducible generation.

mvstring

Optional. Model version. Defaults to Lyria 3 Pro. Legacy values (FUZZ-*) are accepted as aliases and silently routed to Lyria 3 Pro.

webhook_urlstring uri

Optional. HTTPS URL to receive task completion/failure notifications.

webhook_secretstring

Optional. Secret for signing webhook payloads with HMAC-SHA256. Only used when webhook_url is set.

Example request

{
  "clip_id": "abc123xyz789",
  "instruction": "lofi piano remix, mellow downtempo with vinyl crackle",
  "strength": 0.6,
  "mv": "Lyria 3 Pro"
}

Response

Task accepted. Poll GET /api/v1/producer/task/{task_id} for the result.

messagestring required
task_idstring uuid required

Public task ID. Use it to poll GET /api/v1/producer/task/{task_id} for the result.

Example response

{
  "message": "success",
  "task_id": "29906f02-2366-4218-b25a-41458e1d60e0"
}

Changes

No recorded changes to this operation across all 1 revision of this API.