create music

POST

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

Generate a music clip from a text prompt and/or lyrics. Each request creates one asynchronous task — the response contains a task_id you poll via GET /api/v1/producer/task/{task_id}.

Cost: 10 credits per call. Credits are auto-refunded if the task fails.

Active task types: Only create_music is supported on this endpoint. The legacy cover_music, cover_upload_music, extend_music, extend_upload_music, replace_music, replace_upload_music, swap_music_vocals, swap_upload_music_vocals, swap_music_sound, swap_upload_music_sound, and music_variation task types have been permanently retired and now return HTTP 410 Gone. The recommended replacement is to call create_music with a fresh prompt.

For lyrics generation, call POST /api/v1/producer/lyrics-create (1 credit). For music videos, call POST /api/v1/producer/video-clip (5 credits).

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

Minimum: sound prompt only (uses default mv FUZZ-2.0)Lyrics + sound + title + seed + FUZZ-2.0 ProInstrumental (suppress vocals)With webhook callback

{
    "task_type": "create_music",
    "sound": "warm cinematic ambient pad with light percussion"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Minimum: sound prompt only (uses default mv FUZZ-2.0)Lyrics + sound + title + seed + FUZZ-2.0 ProInstrumental (suppress vocals)With webhook callback

curl --location --request POST 'https://api.aimusicapi.ai/api/v1/producer/create' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task_type": "create_music",
    "sound": "warm cinematic ambient pad with light percussion"
}'

Responses

🟢200

application/json

Task accepted. Use the returned task_id to poll GET /api/v1/producer/task/{task_id}.

Body

Example

{
    "message": "success",
    "task_id": "6d7253ac-916e-49a8-b288-91ffa7f8a8cd"
}

🟠400

🟠401

🟠402

🟠410

🟠429

🔴500

🔴502

Modified at 2026-04-27 17:09:53

Complete Request Example

upload