Music Studio

Create a music track from text prompt

Dispatches async job to ACE-Step GPU server. Cost: 3 credits. Optionally accepts a reference audio file for style/timbre guidance. Poll GET /music/:id for status. When status=completed, audioUrl holds the audio URL.

post/v1/music

Request

  • Base URL: https://api.sprixen.com
  • URL: https://api.sprixen.com/v1/music
  • Auth: bearer (a scheme the document does not define)

Request body

promptstring required

Text prompt describing the desired music

lyricsstring

Lyrics for vocal generation. Use [Verse], [Chorus], [Bridge], [Instrumental Break] tags. Leave empty for instrumental.

vocalLanguagestring

Vocal language ISO code (e.g. "en", "ja", "ko", "zh"). Only used when lyrics are provided.

presetSlugstring

Preset slug (epic_orchestral, chiptune_adventure, etc.)

namestring

Human-readable name for the track

genrestring

Desired genre tag

bpmnumber

Beats per minute (60-200)

keystring

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

durationnumber

Desired duration in seconds (15-300)

qualitystring

Generation quality mode. Both run XL turbo (4B): "fast" = 8 steps (3 credits), "quality" = 16 steps (5 credits)

Example request

{
  "prompt": "Epic orchestral battle theme with dramatic strings and brass",
  "lyrics": "[Verse]\nWalking through the neon lights\n[Chorus]\nWe are the future now",
  "vocalLanguage": "en",
  "presetSlug": "epic_orchestral",
  "name": "Battle Theme",
  "genre": "orchestral",
  "bpm": 120,
  "key": "C minor",
  "duration": 30,
  "quality": "fast"
}

Response

Music job created (pending)

Changes

No recorded changes to this operation across all 1 revision of this API.