Skip to content

ACE Step

Integrate

Model id ace-step
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ace-step?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

This request: $0.012 12 API credits · ≈ ₽1.27 Run it on this page

Get API key
ACE Studio Text to Music 5–240 s #text-to-audio#text-to-music

Composes music from genre tags and optional lyrics, with a length of 5 to 240 seconds

ACE Studio · Audio

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required

Audio style tags supplied as comma-separated genres, with `prompt` available as an alternative way to provide them.

default 60

Length, in seconds, of the generated audio.

Advanced lyrics · scheduler · guidance_type · number_of_steps · granularity_scale · guidance_interval · guidance_interval_decay · guidance_scale · minimum_guidance_scale · tag_guidance_scale · lyric_guidance_scale · seed
default

Sung lyrics, with song sections organized using controls such as [verse], [chorus], and [bridge]. For audio without sung lyrics, omit this input or supply only [inst] or [instrumental].

scheduler default euler

Scheduler used during generation.

guidance_type default apg

CFG type used during generation.

default 27

Step count used during audio generation.

default 10

Granularity scale applied during generation. Increasing it may reduce artifacts.

default 0.5

Portion of the generation schedule that receives guidance: choosing 0.5 restricts it to steps from 0.25 * infer_steps through 0.75 * infer_steps, leaving the beginning and end unguided.

default 0

Guidance decay within the generation interval: 0.0 keeps decay disabled; otherwise, the scale decreases over that interval from guidance_scale to min_guidance_scale.

default 15

Scale of guidance applied during generation.

default 3

Lowest guidance scale reached after decay during generation.

default 5

Scale of tag guidance applied during generation.

default 1.5

Scale of lyric guidance applied during generation.

Seed for reproducible generation, chosen randomly unless you supply a value.

POST /run/ace-step?wait=20 quote → $0.012
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ace-step?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About ACE Step

Creates a music track from comma-separated style `tags` and optional `lyrics`. Section markers such as [verse] and [chorus] shape the song structure, and [inst] yields an instrumental. `duration` runs from 5 to 240 seconds. Sampling controls include `scheduler` (euler or heun), `guidance_type`, and `number_of_steps` from 3 to 60.

Parameters

NameType DefaultAllowed Description
tagsrequired
Typestring
Audio style tags supplied as comma-separated genres, with `prompt` available as an alternative way to provide them.
lyricsoptional
Typestring
Default
Sung lyrics, with song sections organized using controls such as [verse], [chorus], and [bridge]. For audio without sung lyrics, omit this input or supply only [inst] or [instrumental].
durationoptional
Typenumber
Default60
5 – 240
Length, in seconds, of the generated audio.
number_of_stepsoptional
Typeinteger
Default27
3 – 60
Step count used during audio generation.
seedoptional
Typeinteger | null
Seed for reproducible generation, chosen randomly unless you supply a value.
scheduleroptional
Typeenum
Defaulteuler
eulerheun
Scheduler used during generation.
guidance_typeoptional
Typeenum
Defaultapg
cfgapgcfg_star
CFG type used during generation.
granularity_scaleoptional
Typeinteger
Default10
-100 – 100
Granularity scale applied during generation. Increasing it may reduce artifacts.
guidance_intervaloptional
Typenumber
Default0.5
0 – 1
Portion of the generation schedule that receives guidance: choosing 0.5 restricts it to steps from 0.25 * infer_steps through 0.75 * infer_steps, leaving the beginning and end unguided.
guidance_interval_decayoptional
Typenumber
Default0
0 – 1
Guidance decay within the generation interval: 0.0 keeps decay disabled; otherwise, the scale decreases over that interval from guidance_scale to min_guidance_scale.
guidance_scaleoptional
Typenumber
Default15
0 – 200
Scale of guidance applied during generation.
minimum_guidance_scaleoptional
Typenumber
Default3
0 – 200
Lowest guidance scale reached after decay during generation.
tag_guidance_scaleoptional
Typenumber
Default5
0 – 10
Scale of tag guidance applied during generation.
lyric_guidance_scaleoptional
Typenumber
Default1.5
0 – 10
Scale of lyric guidance applied during generation.
required

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ace-step",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 12,
    "usd": "0.012",
    "charged": 12,
    "refunded": 0
  },
  "input": {
    "tags": "lofi, hiphop, drum and bass, trap, chill"
  },
  "output": {
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_name": "0-output.mp3",
      "file_size": 1843200
    },
    "seed": 42,
    "tags": "lofi, hiphop, drum and bass, trap, chill",
    "lyrics": "[inst]"
  },
  "outputs": [
    {
      "type": "audio",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp3",
      "content_type": "audio/mpeg",
      "file_size": 1843200,
      "duration": 12,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
audio
object {url, content_type, file_name, file_size}Audio file produced by generation.
seed
integerRandom seed used during generation.
tags
stringGenre tags applied during generation.
lyrics
stringLyrics applied during generation.

More models: Text to Music

For AI agents: this page as Markdown is at https://doitong.com/en-GB/developers/models/ace-step.md. All models and guides: https://doitong.com/developers/llms.txt