sample

POST

https://api.musicapi.ai/api/v1/sonic/sample

Generate a complete song from a short audio sample or hummed melody. This endpoint uses a clip segment as inspiration to create a full-length track.

Credits cost: 20 on every model.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Body Params application/json

Examples

Sample with custom lyrics (using clip_id)Sample with AI-generated lyrics (using clip_id)Instrumental from sample (using clip_id)Sample from URL (auto-upload)

{
    "sample_clip_id": "abc123-def456-sample",
    "chop_sample_start_s": 0,
    "chop_sample_end_s": 30,
    "custom_mode": true,
    "mv": "sonic-v6",
    "make_instrumental": false,
    "prompt": "[Verse 1]\nInspired by this melody\nCreating something beautiful\n\n[Chorus]\nFrom a simple hum\nA full song has come",
    "title": "Melody Dreams",
    "tags": "pop, melodic, uplifting",
    "style_weight": 0.7
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Sample with custom lyrics (using clip_id)Sample with AI-generated lyrics (using clip_id)Instrumental from sample (using clip_id)Sample from URL (auto-upload)

curl --location 'https://api.musicapi.ai/api/v1/sonic/sample' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "sample_clip_id": "abc123-def456-sample",
    "chop_sample_start_s": 0,
    "chop_sample_end_s": 30,
    "custom_mode": true,
    "mv": "sonic-v6",
    "make_instrumental": false,
    "prompt": "[Verse 1]\nInspired by this melody\nCreating something beautiful\n\n[Chorus]\nFrom a simple hum\nA full song has come",
    "title": "Melody Dreams",
    "tags": "pop, melodic, uplifting",
    "style_weight": 0.7
}'

Responses

🟢200success

application/json

success

Bodyapplication/json

Examples

Success response (using sample_clip_id)Success response (using url, includes upload step)

{
    "code": 200,
    "message": "success",
    "task_id": "81ed9f60-56ae-48c1-9c46-33a8220dfca7"
}

Modified at 2026-09-21 01:33:01

create persona

mashup