Skip to main content
POST
/
api
/
v1
/
client
/
txt2music
cURL
curl --request POST \
  --url https://api.deapi.ai/api/v1/client/txt2music \
  --header 'Accept: <accept>' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "caption": "upbeat electronic dance music with energetic synths",
  "model": "ACE-Step-v1.5-turbo",
  "duration": 30,
  "inference_steps": 8,
  "guidance_scale": 7,
  "seed": -1,
  "format": "flac",
  "lyrics": "[Instrumental]",
  "bpm": 120,
  "keyscale": "C major",
  "timesignature": 4,
  "vocal_language": "en",
  "webhook_url": "https://your-server.com/webhooks/deapi"
}
'
{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}
Text-to-Music generates music tracks from text descriptions. You can control genre, tempo, key, time signature, and even provide lyrics. The endpoint returns a task ID to track processing status. Ideal for apps needing automated music creation — background tracks, jingles, or full songs with vocals.
Prerequisite: To ensure a successful request, you must first consult the Model Selection endpoint to identify a valid model slug and check specific limits.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

​
Accept
enum<string>
default:application/json
required
Available options:
application/json

Body

application/json

Music generation parameters

​
caption
string
required

Text description of the music to generate

Example:

"upbeat electronic dance music with energetic synths"

​
model
string
required

The model to use for music generation. Available models can be retrieved via the GET /api/v1/client/models endpoint.

Example:

"ACE-Step-v1.5-turbo"

​
duration
number
required

Duration in seconds (10-600)

Example:

30

​
inference_steps
integer
required

Number of diffusion inference steps (1-100). Use 8 for turbo models, 32+ for base models.

Example:

8

​
guidance_scale
number
required

Classifier-free guidance scale (0-20)

Example:

7

​
seed
integer
required

Random seed. Use -1 for random.

Example:

-1

​
format
string
required

Audio output format

Example:

"flac"

​
lyrics
string | null

Lyrics for the music. Use "[Instrumental]" for instrumental tracks.

Example:

"[Instrumental]"

​
bpm
integer | null

Beats per minute (30-300)

Example:

120

​
keyscale
string | null

Musical key/scale (e.g. "C major", "F# minor")

Example:

"C major"

​
timesignature
integer | null

Time signature. Must be 2, 3, 4, or 6.

Example:

4

​
vocal_language
string | null

Language code for vocals (e.g. "en", "es", "fr")

Example:

"en"

​
webhook_url
string<uri> | null

Optional HTTPS URL to receive webhook notifications for job status changes (processing, completed, failed). Must be HTTPS. Max 2048 characters.

Maximum string length: 2048
Example:

"https://your-server.com/webhooks/deapi"

Response

ID of the inference request.

​
data
object

Information from success endpoint