Generate music clip

This endpoint allows you to generate music clips with specific details. There are three modes which can be useful for different scenarios.

Modes

inspiration: only require a topic, both lyrics and music style will be decided by AI.

custom: require lyrics, music style and song title to create your custom piece of music

song continuation: almost the same parameters as the cutom mode but a few more for locating your previous music clips and continue generation based on your instructions: "task_id", "continue_clip_id", "continue_at", "task"

Inspiration Mode

gpt_description_prompt (string): The prompt for the music generation. It's basically a sentence or a few words what you want your song about.

Custom Mode

prompt (string): The prompt for the music submission.

tags (string): Tags associated with the music submission.

mv (string): The version of the music submission.

title (string): The title of the music submission.

Song Continuation

prompt (string): The prompt for the music submission.

tags (string): Tags associated with the music submission.

mv (string): The version of the music submission.

title (string): The title of the music submission.

task_id (string): Identifier for the task associated with the music submission.

continue_clip_id (string): Identifier for the clip to continue from.

continue_at (string): Position to continue from in the music submission.

negative_tags (string): Negative tags associated with the music submission.

Request

Header Params

Authorization

string

required

Example:

Bearer {{api-key}}

Body Params application/json

prompt

string

required

tags

string

required

string

required

title

string

required

Example

{
  "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
  "tags": "emotional punk",
  "mv": "chirp-v4",
  "title": "City Lights"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

text/plain

Body

code

string

required

message

string

required

data

string

required

Example

{
  "code": "success",
  "message": "",
  "data": "736a6f88-bd29-4b1e-b110-37132a5325ac"
}

Generate music clip