ACE Step API

ACE Step is the most advanced open-source AI music model with 3.5 billion parameters, enabling users to generate high-quality music from text lyrics. We have retrained it for pop music and female vocals. In addition to providing an API, FoxAIHub also allows you to experience ACE Step directly on this page.

ACE Step music generator Free Online

ACE-Step API Document

Billing Rule

Each generate requestion returns 1 task id, and each task id can be used to query 1 song and 1 cover image. Each generate requestion costs $0.008.

How to use it ?

BaseUrl : https://api.foxaihub.com/api/v2

Headers Parameters

{"api-key": "Your API Key"}

You can find your api key on the dashboard.

Submit generation task

Path: /acestep/task

Method: POST

Content-Type: application/json

HTTP Body

{"task_type": "generate","lyrics": "","tags": "pop, female vocals, drum & bass, piano","negative_prompt": "drum & bass","duration": 122,"seed": 759249325}
ParameterTypeRequired Description
task_typestringYesGeneration task type, should be "generate"
lyricsstringYesThe lyrics for the song to be generated
tagsstringYesMusic style tags, comma separated
negative_promptstringNoTags to be avoided in generation, but now it doesn't works, so you send an empty string
durationnumberYesDuration of the song in seconds, from 0 to 240 seconds. If you set it to 0, it will be a random duration
seednumberNoSame seed will generate the same song. If you set it to 0, it will be a random seed

How to generate a intrumental music?

You can set lyrics to [instrumental] or [inst]

Response

{"success": true,"task_id": "0196ecef-1550-7000-b332-89ded5ca66db",}

Get Results

Path: /acestep/task/{task_id}

Method: GET

Content-Type: application/json

Response

{"status": "completed","task_id": "0196ebe0-4afd-7000-9a7b-67cf208209fd","gen_params": {"seed": 0, "tags": "pop, female vocals, drum & bass, piano", "lyrics": "", "duration": 120, "task_type": "generate", "negative_prompt": "drum & bass"},"data": { "seed": 3842775294, "end_time": "2025-05-20T04:08:06.852Z", "audio_url": "https://cdn2.foxai.me/acestep-songs/0196ebe0-4afd-7000-9a7b-67cf208209fd.mp3", "image_url": "https://cdn.foxai.me/image_c5a29c236cb96c2a9e9365690ceec649.jpeg"},"created_at": "2025-05-20T04:07:47.000Z"}