ACE MUSIC · SONG CREATION API

Turn a spark of inspiration,
into your next song.

Describe the music you want to hear, or bring lyrics you wrote yourself. ACE Music generates two candidates for you to preview, compare, and download your favorite version.

Get API credentialsOpen the creation workspace

2 creation methods

Inspiration descriptions and custom lyrics cover the basic workflow from concept to finished song.

2 candidates

Each complete generation delivers a set of candidates to preview individually and download as MP3s.

3 API types

Song, lyrics, and task query APIs, all using the same platform credentials.

Start with a single sentence, or carefully refine your lyrics

Inspiration creation

Describe the theme, style, and mood—ideal for quickly exploring song directions.

Custom creation

Enter a title, lyrics, and style while retaining control over the content.

Lyrics assistant

Generate a lyric draft first, then submit it for song generation once you are satisfied with your edits.

Submit once, retain the task identity

Save the task ID after asynchronous submission, then use free queries to retrieve progress and results. Continue querying the original task after a network interruption to avoid duplicate creations.

curl --request POST 'https://api.acedata.cloud/acemusic/audios' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "acemusic-v1.1",
    "custom": false,
    "prompt": "一首关于故乡的温暖民谣",
    "async": true
  }'
Read the full integration guide →

Find a sound for your ideas

Song drafts

Compare different interpretations and choose a direction for further creation.

Soundtrack concepts

Use themes and moods to explore music ideas for videos, stories, and game scenes.

Creative applications

Integrate through the API or Agent to connect lyric writing, generation, and previewing into your own workflow.

Get started in three steps

01 · Get credentials

Activate the service and choose the credit plan that suits you.

02 · Describe or write lyrics

Choose a model and submit your inspiration or custom lyrics.

03 · Preview and download

Query the original task, compare completed candidates, and download the audio.

Choose the right method for your current stage

MethodYou provideBest for
Inspiration modeA creative descriptionQuickly exploring themes and styles
Custom modeTitle, lyrics, and music styleWhen you already have clear lyrics and a content direction
Lyrics assistantTheme and optional styleRefining the text first, then creating music

Choose a model explicitly

ACE Music v1.1

Default creation model. Public API ID: acemusic-v1.1.

ACE Music v1

Retained optional model. Public API ID: acemusic-v1.

Based on results

Music style and performance are generated by the model; actual duration is determined by the result.

Charged by completed creations

Song generation

$0.02995

At the highest plan rate, each set of two complete candidates is charged once.

Lyrics assistant

$0.001497

At the highest plan rate, each successful lyric generation is charged separately.

Task queries

Free

Valid credentials and task permissions are required; you can view your own results even with a zero balance.

Pricing benchmark updated on 2026-11-17; actual pricing is affected by the plan used, discounts, and site pricing. No generation fee is charged for final generation failures or partial failures, and charged tasks are not automatically reissued.

Frequently asked questions

Can I play it immediately after generation is accepted?

Acceptance returns a task ID. Playback is available only after generation and audio delivery are complete. Please query the original task; do not treat acceptance as completion.

Can I edit the lyrics and generate again?

Yes. Use custom mode to submit a title, lyrics, and style; drafts provided by the lyrics assistant can also be edited first.

What happens if only one song is completed?

The successful playable candidate is retained, the final task is marked as partially failed, and no generation fee is charged for that set.

What outputs and subsequent processing are currently supported?

The current basic creation output is song audio, with MP3 download supported. Uploading, covers, continuation, stem separation, and voice capabilities are not included in this release.

Can it be used for commercial projects?

Please determine this based on the applicable terms of service and project context, and ensure that you have the necessary rights to the input content and intended use.

Explore more music and sound

Let your next song start here

Create directly with Studio, or integrate ACE Music into your application.

Get startedView API documentation