Saltar al cuntegna

ACE Step

Integrar

ID dal model ace-step
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Questa dumonda: $0,012 12 credits API Lantschar sin questa pagina

Obtegna ina clav API
ACE Studio Text a musica 5–240 s #text-to-audio#text-to-music

Cumpona musica da tags da geners e lyrics opziunals, cun ina lunghezza da 5 fin 240 secundas

ACE Studio · Audio

Tes emprim resultat vegn qua

Construis ina dumonda sutvart e l'exequescha cun tia clav API. Outputs vegnan copiads en nossa memorisaziun, conservads per adina u 7 dis gratuitamain.

Construir ina dumonda

Ils controls vegnan generads dal schema dal model. Il code e ​​il pretsch s'actualiseschan durant che ti als midas.

•obligatori

Tags da stil audio furnids sco genres separads cun commas, cun `prompt` sco alternativa per als furnir.

standard 60

Durada, en secundas, da l'audio generà.

Avanzà 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
standard

Text chantà, cun las parts da la chanzun organisadas cun controllas sco [verse], [chorus] e [bridge]. Per audio senza text chantà, ometta quest input u furnescha mo [inst] u [instrumental].

scheduler standard euler

Scheduler utilisà durant la generaziun.

guidance_type standard apg

Tip CFG utilisà durant la generaziun.

standard 27

Dumber da pass utilisà durant la generaziun audio.

standard 10

Scala da granularitad applitgada durant la generaziun. Augmentarla po reducir artifacts.

standard 0.5

Part dal program da generaziun che survegn guida: la tscherna da 0.5 la restrenscha als pass da 0.25 * infer_steps fin a 0.75 * infer_steps, laschond l'inizial e la fin senza guida.

standard 0

Decadiment da la guida entaifer l'interval da generaziun: 0.0 lascha il decadiment disactivà; autramain sa reducescha la scala durant quest interval da guidance_scale a min_guidance_scale.

standard 15

Scala da la guida applitgada durant la generaziun.

standard 3

Scala minimala da la guida cuntanschida suenter il decadiment durant la generaziun.

standard 5

Scala da la guida da tags applitgada durant la generaziun.

standard 1.5

Scala da la guida dal text chantà applitgada durant la generaziun.

Seed per ina generaziun reproducibla, tschernì casualmain sche ti na furneschas nagina valur.

POST /run/ace-step?wait=20 calculaziun → $0,012
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Executar questa dumonda

Tia clav resta en quest browser: ella vegn tramessa mo al Doitong API e memorisada (localStorage) mo sch'ella scheccas Tiar a memoria. Obtegnair ina clav API

Davart ACE Step

Crea ina pista musicala a partir da `tags` da stil separads cun commas e `lyrics` opziunals. Marcaders da secziun sco [verse] e [chorus] structuran la chanzun, e [inst] producescha musica instrumentala. `duration` va da 5 fin 240 secundas. Ils parameters da sampling includan `scheduler` (euler u heun), `guidance_type` e `number_of_steps` da 3 fin 60.

Parameters

NumTip StandardPermess Descripziun
tagsobligatori
Tipstring
Tags da stil audio furnids sco genres separads cun commas, cun `prompt` sco alternativa per als furnir.
lyricsopziunal
Tipstring
Standard
Text chantà, cun las parts da la chanzun organisadas cun controllas sco [verse], [chorus] e [bridge]. Per audio senza text chantà, ometta quest input u furnescha mo [inst] u [instrumental].
durationopziunal
Tipnumber
Standard60
5 – 240
Durada, en secundas, da l'audio generà.
number_of_stepsopziunal
Tipinteger
Standard27
3 – 60
Dumber da pass utilisà durant la generaziun audio.
seedopziunal
Tipinteger | null
Seed per ina generaziun reproducibla, tschernì casualmain sche ti na furneschas nagina valur.
scheduleropziunal
Tipenum
Standardeuler
eulerheun
Scheduler utilisà durant la generaziun.
guidance_typeopziunal
Tipenum
Standardapg
cfgapgcfg_star
Tip CFG utilisà durant la generaziun.
granularity_scaleopziunal
Tipinteger
Standard10
-100 – 100
Scala da granularitad applitgada durant la generaziun. Augmentarla po reducir artifacts.
guidance_intervalopziunal
Tipnumber
Standard0.5
0 – 1
Part dal program da generaziun che survegn guida: la tscherna da 0.5 la restrenscha als pass da 0.25 * infer_steps fin a 0.75 * infer_steps, laschond l'inizial e la fin senza guida.
guidance_interval_decayopziunal
Tipnumber
Standard0
0 – 1
Decadiment da la guida entaifer l'interval da generaziun: 0.0 lascha il decadiment disactivà; autramain sa reducescha la scala durant quest interval da guidance_scale a min_guidance_scale.
guidance_scaleopziunal
Tipnumber
Standard15
0 – 200
Scala da la guida applitgada durant la generaziun.
minimum_guidance_scaleopziunal
Tipnumber
Standard3
0 – 200
Scala minimala da la guida cuntanschida suenter il decadiment durant la generaziun.
tag_guidance_scaleopziunal
Tipnumber
Standard5
0 – 10
Scala da la guida da tags applitgada durant la generaziun.
lyric_guidance_scaleopziunal
Tipnumber
Standard1.5
0 – 10
Scala da la guida dal text chantà applitgada durant la generaziun.
obligatori

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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Tias datotecas, tia decisiunMintga outputs[].url è ina copia en nossa memorisaziun: conservada per adina (pajà per GB-mes) u 7 dis gratuitamain, tenor la configuraziun dal conto u ?storage=.
La medema structura per mintga modeltype, url, content_type, width, height e duration, tant per maletgs sco per video e audio. output è l'object da resultat dal model sez.
Champs da l'output
audio
object {url, content_type, file_name, file_size}Datoteca audio producida da la generaziun.
seed
integerSeed casual utilisà durant la generaziun.
tags
stringTags da gener durant la generaziun.
lyrics
stringText chantà applitgà durant la generaziun.

Dapli models: Text a musica

Per agents AI: questa pagina sco Markdown è disponibla sut https://doitong.com/rm/developers/models/ace-step.md. Tut ils models e las guidas: https://doitong.com/developers/llms.txt