Przejdź do treści

ACE Step

Integracja

Identyfikator modelu 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"

To żądanie: 0,012 $ 12 kredytów API · ≈ 1,27 ₽ Uruchom na tej stronie

Uzyskaj klucz API
ACE Studio Tekst na muzykę 5–240 s #text-to-audio#text-to-music

Komponuje muzykę na podstawie tagów gatunkowych i opcjonalnego tekstu, o długości od 5 do 240 sekund

ACE Studio · Audio

Tutaj pojawi się pierwszy wynik

Zbuduj poniżej żądanie i uruchom je za pomocą klucza API. Wyniki są kopiowane do naszej przestrzeni dyskowej i przechowywane bezterminowo lub 7 dni bezpłatnie.

Zbuduj żądanie

Elementy sterujące są generowane ze schematu modelu. Kod i cena aktualizują się podczas ich zmiany.

•wymagane

Tagi stylu audio podane jako gatunki rozdzielone przecinkami; alternatywnie można użyć `prompt`.

domyślnie 60

Długość wygenerowanego audio w sekundach.

Zaawansowane 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
domyślnie

Śpiewany tekst, z sekcjami utworu oznaczonymi za pomocą elementów takich jak [verse], [chorus] i [bridge]. W przypadku audio bez śpiewanego tekstu pomiń te dane wejściowe albo podaj wyłącznie [inst] lub [instrumental].

scheduler domyślnie euler

Harmonogram używany podczas generowania.

guidance_type domyślnie apg

Typ CFG używany podczas generowania.

domyślnie 27

Liczba kroków używanych podczas generowania audio.

domyślnie 10

Skala granularności stosowana podczas generowania. Jej zwiększenie może ograniczyć artefakty.

domyślnie 0.5

Część harmonogramu generowania, do której stosowane są wskazówki: wybranie 0.5 ogranicza ją do kroków od 0.25 * infer_steps do 0.75 * infer_steps, pozostawiając początek i koniec bez wskazówek.

domyślnie 0

Wygaszanie wskazówek w interwale generowania: 0.0 wyłącza wygaszanie; w przeciwnym razie skala maleje w tym interwale od guidance_scale do min_guidance_scale.

domyślnie 15

Skala wskazówek stosowanych podczas generowania.

domyślnie 3

Najniższa skala wskazówek osiągana po wygaszeniu podczas generowania.

domyślnie 5

Skala wskazówek dotyczących tagów stosowanych podczas generowania.

domyślnie 1.5

Skala wskazówek dotyczących tekstu utworu stosowanych podczas generowania.

Ziarno zapewniające powtarzalność generowania; wybierane losowo, jeśli nie podasz wartości.

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

Uruchom to żądanie

Klucz pozostaje w tej przeglądarce: jest wysyłany tylko do Doitong API i zapisywany (localStorage) tylko po zaznaczeniu opcji Zapamiętaj. Uzyskaj klucz API

Informacje o ACE Step

Tworzy utwór muzyczny na podstawie rozdzielanych przecinkami stylów `tags` i opcjonalnego tekstu `lyrics`. Znaczniki sekcji, takie jak [verse] i [chorus], kształtują strukturę utworu, a [inst] tworzy wersję instrumentalną. `duration` przyjmuje wartości od 5 do 240 sekund. Ustawienia próbkowania obejmują `scheduler` (euler lub heun), `guidance_type` oraz `number_of_steps` od 3 do 60.

Parametry

NazwaTyp DomyślneDozwolone Opis
tagswymagane
Typstring
Tagi stylu audio podane jako gatunki rozdzielone przecinkami; alternatywnie można użyć `prompt`.
lyricsopcjonalne
Typstring
Domyślne
Śpiewany tekst, z sekcjami utworu oznaczonymi za pomocą elementów takich jak [verse], [chorus] i [bridge]. W przypadku audio bez śpiewanego tekstu pomiń te dane wejściowe albo podaj wyłącznie [inst] lub [instrumental].
durationopcjonalne
Typnumber
Domyślne60
5 – 240
Długość wygenerowanego audio w sekundach.
number_of_stepsopcjonalne
Typinteger
Domyślne27
3 – 60
Liczba kroków używanych podczas generowania audio.
seedopcjonalne
Typinteger | null
Ziarno zapewniające powtarzalność generowania; wybierane losowo, jeśli nie podasz wartości.
scheduleropcjonalne
Typenum
Domyślneeuler
eulerheun
Harmonogram używany podczas generowania.
guidance_typeopcjonalne
Typenum
Domyślneapg
cfgapgcfg_star
Typ CFG używany podczas generowania.
granularity_scaleopcjonalne
Typinteger
Domyślne10
-100 – 100
Skala granularności stosowana podczas generowania. Jej zwiększenie może ograniczyć artefakty.
guidance_intervalopcjonalne
Typnumber
Domyślne0.5
0 – 1
Część harmonogramu generowania, do której stosowane są wskazówki: wybranie 0.5 ogranicza ją do kroków od 0.25 * infer_steps do 0.75 * infer_steps, pozostawiając początek i koniec bez wskazówek.
guidance_interval_decayopcjonalne
Typnumber
Domyślne0
0 – 1
Wygaszanie wskazówek w interwale generowania: 0.0 wyłącza wygaszanie; w przeciwnym razie skala maleje w tym interwale od guidance_scale do min_guidance_scale.
guidance_scaleopcjonalne
Typnumber
Domyślne15
0 – 200
Skala wskazówek stosowanych podczas generowania.
minimum_guidance_scaleopcjonalne
Typnumber
Domyślne3
0 – 200
Najniższa skala wskazówek osiągana po wygaszeniu podczas generowania.
tag_guidance_scaleopcjonalne
Typnumber
Domyślne5
0 – 10
Skala wskazówek dotyczących tagów stosowanych podczas generowania.
lyric_guidance_scaleopcjonalne
Typnumber
Domyślne1.5
0 – 10
Skala wskazówek dotyczących tekstu utworu stosowanych podczas generowania.
wymagane

Wynik

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"
  }
}
Twoje pliki, Twój wybórKażdy outputs[].url to kopia w naszej przestrzeni dyskowej: przechowywana bezterminowo (opłata za GB-miesiąc) lub 7 dni bezpłatnie, zgodnie z ustawieniem konta lub ?storage=.
Taki sam format w każdym modelutype, url, content_type, width, height i duration — tak samo dla obrazów, filmów i dźwięku. output to własny obiekt wyniku modelu.
Pola wyniku
audio
object {url, content_type, file_name, file_size}Plik audio utworzony podczas generowania.
seed
integerLosowe ziarno używane podczas generowania.
tags
stringTagi gatunków stosowane podczas generowania.
lyrics
stringTekst utworu stosowany podczas generowania.

Więcej modeli: Tekst na muzykę

Dla agentów AI: ta strona w formacie Markdown jest dostępna pod adresem https://doitong.com/pl/developers/models/ace-step.md. Wszystkie modele i przewodniki: https://doitong.com/developers/llms.txt