Replace a section of an existing music track

POST

https://api.musicapi.ai/api/v1/producer/create

Replace the segment between starts_at and ends_at of a previously generated or uploaded clip with new content. Surrounding sections are preserved.

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

Migration note

This operation replaced the legacy Producer replace endpoint in 2026-04. The old starts / ends parameters are still accepted but you should prefer starts_at / ends_at and the new instruction field.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

With explicit instruction (recommended)Legacy fallback — instruction synthesized from sound/lyricsVocal swap (migration path from swap_music_vocals)Instrumental swap (migration path from swap_music_sound)Replace a chorus with a major-key version

{
    "task_type": "replace_music",
    "clip_id": "abc123xyz789",
    "starts_at": 30,
    "ends_at": 45,
    "instruction": "Replace this segment with a heavy distorted guitar riff over double-bass drums and aggressive energy"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

curl --location --request POST 'https://api.musicapi.ai/api/v1/producer/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task_type": "replace_music",
    "clip_id": "abc123xyz789",
    "starts_at": 30,
    "ends_at": 45,
    "instruction": "Replace this segment with a heavy distorted guitar riff over double-bass drums and aggressive energy"
}'

Responses

🟢200

application/json

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

Body

Example

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

🟠400

🟠401

🟠403

🔴500

Modified at 2026-04-27 16:24:40

Extend an existing music track

Studio Instructions

Replace a section of an existing music track

Migration note#

Request

Request Code Samples

Responses

Migration note