Siirry sisältöön

ACE Step

Integroi

Mallin tunniste 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"

Tämä pyyntö: 0,012 $ 12 API-krediittiä · ≈ 1,27 ₽ Suorita tällä sivulla

Hanki API-avain
ACE Studio Tekstistä musiikiksi 5–240 s #text-to-audio#text-to-music

Säveltää musiikkia lajityylitunnisteista ja valinnaisista sanoituksista, pituus 5–240 sekuntia

ACE Studio · Ääni

Ensimmäinen tuloksesi tulee tähän

Muodosta pyyntö alla ja suorita se API-avaimellasi. Tulosteet kopioidaan tallennustilaamme, jossa ne säilytetään ikuisesti tai 7 päivää ilmaiseksi.

Muodosta pyyntö

Säätimet luodaan mallin skeemasta. Koodi ja hinta päivittyvät, kun muutat arvoja.

•pakollinen

Äänityylitunnisteet pilkuilla eroteltuina genreinä; vaihtoehtoisesti ne voi antaa `prompt`-parametrilla.

oletus 60

Generoidun äänen pituus sekunteina.

Lisäasetukset 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
oletus

Laulutetut sanat, joiden osiot järjestetään ohjaimilla, kuten [verse], [chorus] ja [bridge]. Jos äänessä ei ole laulettuja sanoja, jätä tämä syöte pois tai anna vain [inst] tai [instrumental].

scheduler oletus euler

Generoinnissa käytettävä ajoitin.

guidance_type oletus apg

Generoinnissa käytettävä CFG-tyyppi.

oletus 27

Äänen generoinnissa käytettävä vaiheiden määrä.

oletus 10

Generoinnissa käytettävä rakeisuusskaala. Sen suurentaminen voi vähentää artefakteja.

oletus 0.5

Ohjausta saavan generointiaikataulun osa: arvon 0.5 valitseminen rajoittaa ohjauksen vaiheisiin välillä 0.25 * infer_steps–0.75 * infer_steps, jolloin alku ja loppu jäävät ilman ohjausta.

oletus 0

Ohjauksen vaimeneminen generointivälillä: 0.0 pitää vaimenemisen pois käytöstä; muussa tapauksessa skaala pienenee kyseisellä välillä arvosta guidance_scale arvoon min_guidance_scale.

oletus 15

Generoinnin aikana käytettävän ohjauksen skaala.

oletus 3

Generoinnin aikaisen vaimenemisen jälkeen saavutettava pienin ohjausskaala.

oletus 5

Generoinnin aikana käytettävän tunnisteohjauksen skaala.

oletus 1.5

Generoinnin aikana käytettävän sanoitusohjauksen skaala.

Toistettavan generoinnin siemen, joka valitaan satunnaisesti, ellet anna arvoa.

POST /run/ace-step?wait=20 hinta → 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"

Suorita tämä pyyntö

Avaimesi säilyy tässä selaimessa: se lähetetään vain Doitong APIlle ja tallennetaan localStorageen vain, jos valitset Muista. Hanki API-avain

Tietoja: ACE Step

Luo musiikkikappaleen pilkuilla erotelluista tyylin `tags`-tunnisteista ja valinnaisista `lyrics`-sanoituksista. Osioilmaisimet, kuten [verse] ja [chorus], määrittävät kappaleen rakenteen, ja [inst] tuottaa instrumentaaliversion. `duration` on 5–240 sekuntia. Näytteenoton asetuksiin kuuluvat `scheduler` (euler tai heun), `guidance_type` ja `number_of_steps` välillä 3–60.

Parametrit

NimiTyyppi OletusSallitut Kuvaus
tagspakollinen
Tyyppistring
Äänityylitunnisteet pilkuilla eroteltuina genreinä; vaihtoehtoisesti ne voi antaa `prompt`-parametrilla.
lyricsvalinnainen
Tyyppistring
Oletus
Laulutetut sanat, joiden osiot järjestetään ohjaimilla, kuten [verse], [chorus] ja [bridge]. Jos äänessä ei ole laulettuja sanoja, jätä tämä syöte pois tai anna vain [inst] tai [instrumental].
durationvalinnainen
Tyyppinumber
Oletus60
5 – 240
Generoidun äänen pituus sekunteina.
number_of_stepsvalinnainen
Tyyppiinteger
Oletus27
3 – 60
Äänen generoinnissa käytettävä vaiheiden määrä.
seedvalinnainen
Tyyppiinteger | null
Toistettavan generoinnin siemen, joka valitaan satunnaisesti, ellet anna arvoa.
schedulervalinnainen
Tyyppienum
Oletuseuler
eulerheun
Generoinnissa käytettävä ajoitin.
guidance_typevalinnainen
Tyyppienum
Oletusapg
cfgapgcfg_star
Generoinnissa käytettävä CFG-tyyppi.
granularity_scalevalinnainen
Tyyppiinteger
Oletus10
−100 – 100
Generoinnissa käytettävä rakeisuusskaala. Sen suurentaminen voi vähentää artefakteja.
guidance_intervalvalinnainen
Tyyppinumber
Oletus0.5
0 – 1
Ohjausta saavan generointiaikataulun osa: arvon 0.5 valitseminen rajoittaa ohjauksen vaiheisiin välillä 0.25 * infer_steps–0.75 * infer_steps, jolloin alku ja loppu jäävät ilman ohjausta.
guidance_interval_decayvalinnainen
Tyyppinumber
Oletus0
0 – 1
Ohjauksen vaimeneminen generointivälillä: 0.0 pitää vaimenemisen pois käytöstä; muussa tapauksessa skaala pienenee kyseisellä välillä arvosta guidance_scale arvoon min_guidance_scale.
guidance_scalevalinnainen
Tyyppinumber
Oletus15
0 – 200
Generoinnin aikana käytettävän ohjauksen skaala.
minimum_guidance_scalevalinnainen
Tyyppinumber
Oletus3
0 – 200
Generoinnin aikaisen vaimenemisen jälkeen saavutettava pienin ohjausskaala.
tag_guidance_scalevalinnainen
Tyyppinumber
Oletus5
0 – 10
Generoinnin aikana käytettävän tunnisteohjauksen skaala.
lyric_guidance_scalevalinnainen
Tyyppinumber
Oletus1.5
0 – 10
Generoinnin aikana käytettävän sanoitusohjauksen skaala.
pakollinen

Tulos

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"
  }
}
Tiedostosi, valintasiJokainen outputs[].url on kopio tallennustilassamme: säilytetään ikuisesti (maksetaan gigatavu-kuukauden mukaan) tai 7 päivää ilmaiseksi tiliasetuksesi tai ?storage= perusteella.
Sama rakenne kaikissa malleissatype, url, content_type, width, height ja duration kuville, videolle ja äänelle. output on mallin oma tulosobjekti.
Tuloksen kentät
audio
object {url, content_type, file_name, file_size}Generoinnissa tuotettu äänitiedosto.
seed
integerGeneroinnissa käytetty satunnaissiemen.
tags
stringGeneroinnin aikana käytetyt genretunnisteet.
lyrics
stringGeneroinnin aikana käytetty sanoitus.

Lisää malleja: Tekstistä musiikiksi

Tekoälyagenteille: tämän sivun Markdown-muoto on osoitteessa https://doitong.com/fi/developers/models/ace-step.md. Kaikki mallit ja oppaat: https://doitong.com/developers/llms.txt