Text-to-Music

Endpoint for requesting text2music inference

Text-to-Music generates music tracks from text descriptions. You can control genre, tempo, key, time signature, and even provide lyrics. Optionally upload a reference_audio file for style transfer — the model will use it as a stylistic reference for the generated track. 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.

NOTE

Prerequisite: To ensure a successful request, you must first consult the Model Selection endpoint to identify a valid model slug and check specific limits.

WARNING

Reference audio requirements (optional):

• Supported formats: MP3, WAV, FLAC, OGG, M4A
• Maximum file size: 10 MB
• Duration must be within model-specific limits

This endpoint uses multipart/form-data content type to support file uploads.

OpenAPI

curl -X POST "https://api.dryapi.dev/api/v1/client/txt2music" \  -H "Accept: application/json" \  -F caption="upbeat electronic dance music with energetic synths" \  -F model="ACE-Step-v1.5-turbo" \  -F lyrics="[Instrumental]" \  -F duration="30" \  -F inference_steps="8" \  -F guidance_scale="7" \  -F seed="-1" \  -F format="flac"

{
  "data": {
    "request_id": "c08a339c-73e5-4d67-a4d5-231302fbff9a"
  }
}

{
  "data": {},
  "message": "string",
  "errors": [
    null
  ],
  "statusCode": 0
}

{
  "data": {},
  "message": "string",
  "errors": [
    null
  ],
  "statusCode": 0
}

{
  "message": "The selected model does not support Text To Image.",
  "errors": {
    "model": [
      "The selected model does not support Text To Image."
    ]
  }
}

{
  "message": "Too Many Attempts."
}