Мазмұнға өту

ACE Step

Интеграциялау

Модель идентификаторы 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"

Осы сұрау: 0,012 $ 12 API кредиті Осы бетте іске қосу

API кілтін алу
ACE Studio Мәтіннен музыкаға 5–240 с #text-to-audio#text-to-music

Жанр тегтері мен қалауыңызша мәтін бойынша ұзақтығы 5–240 секунд музыка құрастырады

ACE Studio · Аудио

Алғашқы нәтижеңіз осында пайда болады

Төменде сұрау құрып, оны API кілтіңізбен іске қосыңыз. Шығыстар сақтау орнымызға көшіріліп, мәңгі немесе 7 күн тегін сақталады.

Сұрау жасау

Басқару элементтері модель схемасынан жасалады. Оларды өзгерткен сайын код пен баға жаңартылады.

•міндетті

Үтірмен бөлінген жанрлар түрінде берілетін аудио стилінің тегтері; оларды берудің балама тәсілі ретінде `prompt` қолжетімді.

әдепкі 60

Генерацияланған аудионың секундпен берілген ұзақтығы.

Қосымша 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
әдепкі

[verse], [chorus] және [bridge] сияқты басқару элементтері арқылы ән бөлімдері ұйымдастырылған орындалатын мәтін. Орындалатын мәтіні жоқ аудио үшін бұл кірісті өткізіп жіберіңіз немесе тек [inst] не [instrumental] мәнін беріңіз.

scheduler әдепкі euler

Генерация кезінде қолданылатын жоспарлаушы.

guidance_type әдепкі apg

Генерация кезінде қолданылатын CFG түрі.

әдепкі 27

Аудио генерациясы кезінде қолданылатын қадамдар саны.

әдепкі 10

Генерация кезінде қолданылатын түйіршіктілік масштабы. Оны арттыру артефактілерді азайтуы мүмкін.

әдепкі 0.5

Нұсқау қолданылатын генерация кестесінің бөлігі: 0.5 мәнін таңдау оны 0.25 * infer_steps мәнінен 0.75 * infer_steps мәніне дейінгі қадамдармен шектейді, ал басы мен соңы нұсқаусыз қалады.

әдепкі 0

Генерация аралығындағы нұсқау бәсеңдеуі: 0.0 мәні бәсеңдеуді өшіреді; әйтпесе осы аралықта масштаб guidance_scale мәнінен min_guidance_scale мәніне дейін азаяды.

әдепкі 15

Генерация кезінде қолданылатын нұсқау масштабы.

әдепкі 3

Генерация кезінде бәсеңдеуден кейін жететін ең төменгі нұсқау масштабы.

әдепкі 5

Генерация кезінде тегтерге қолданылатын нұсқау масштабы.

әдепкі 1.5

Генерация кезінде мәтінге қолданылатын нұсқау масштабы.

Қайта өндіруге болатын генерацияға арналған seed; мән бермесеңіз, кездейсоқ таңдалады.

POST /run/ace-step?wait=20 бағасы → 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"

Осы сұрауды іске қосу

Кілтіңіз осы браузерде қалады: ол тек Doitong API-ге жіберіледі және Remember параметрін белгілеcеңіз ғана localStorage ішінде сақталады. API кілтін алу

ACE Step туралы

Үтірмен бөлінген стиль `tags` және қалауыңызша `lyrics` негізінде музыка трегін жасайды. [verse] және [chorus] сияқты бөлім белгілері ән құрылымын қалыптастырады, ал [inst] аспаптық нұсқаны береді. `duration` мәні 5–240 секунд аралығында. Үлгілеу параметрлеріне `scheduler` (euler немесе heun), `guidance_type` және 3–60 аралығындағы `number_of_steps` кіреді.

Параметрлер

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
tagsміндетті
Түріstring
Үтірмен бөлінген жанрлар түрінде берілетін аудио стилінің тегтері; оларды берудің балама тәсілі ретінде `prompt` қолжетімді.
lyricsміндетті емес
Түріstring
Әдепкі
[verse], [chorus] және [bridge] сияқты басқару элементтері арқылы ән бөлімдері ұйымдастырылған орындалатын мәтін. Орындалатын мәтіні жоқ аудио үшін бұл кірісті өткізіп жіберіңіз немесе тек [inst] не [instrumental] мәнін беріңіз.
durationміндетті емес
Түріnumber
Әдепкі60
5 – 240
Генерацияланған аудионың секундпен берілген ұзақтығы.
number_of_stepsміндетті емес
Түріinteger
Әдепкі27
3 – 60
Аудио генерациясы кезінде қолданылатын қадамдар саны.
seedміндетті емес
Түріinteger | null
Қайта өндіруге болатын генерацияға арналған seed; мән бермесеңіз, кездейсоқ таңдалады.
schedulerміндетті емес
Түріenum
Әдепкіeuler
eulerheun
Генерация кезінде қолданылатын жоспарлаушы.
guidance_typeміндетті емес
Түріenum
Әдепкіapg
cfgapgcfg_star
Генерация кезінде қолданылатын CFG түрі.
granularity_scaleміндетті емес
Түріinteger
Әдепкі10
-100 – 100
Генерация кезінде қолданылатын түйіршіктілік масштабы. Оны арттыру артефактілерді азайтуы мүмкін.
guidance_intervalміндетті емес
Түріnumber
Әдепкі0.5
0 – 1
Нұсқау қолданылатын генерация кестесінің бөлігі: 0.5 мәнін таңдау оны 0.25 * infer_steps мәнінен 0.75 * infer_steps мәніне дейінгі қадамдармен шектейді, ал басы мен соңы нұсқаусыз қалады.
guidance_interval_decayміндетті емес
Түріnumber
Әдепкі0
0 – 1
Генерация аралығындағы нұсқау бәсеңдеуі: 0.0 мәні бәсеңдеуді өшіреді; әйтпесе осы аралықта масштаб guidance_scale мәнінен min_guidance_scale мәніне дейін азаяды.
guidance_scaleміндетті емес
Түріnumber
Әдепкі15
0 – 200
Генерация кезінде қолданылатын нұсқау масштабы.
minimum_guidance_scaleміндетті емес
Түріnumber
Әдепкі3
0 – 200
Генерация кезінде бәсеңдеуден кейін жететін ең төменгі нұсқау масштабы.
tag_guidance_scaleміндетті емес
Түріnumber
Әдепкі5
0 – 10
Генерация кезінде тегтерге қолданылатын нұсқау масштабы.
lyric_guidance_scaleміндетті емес
Түріnumber
Әдепкі1.5
0 – 10
Генерация кезінде мәтінге қолданылатын нұсқау масштабы.
міндетті

Шығыс

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"
  }
}
Файлдарыңыз — таңдауыңызӘр outputs[].url — сақтау орнымыздағы көшірме: мәңгі (әр GB-ай үшін ақылы) немесе аккаунт параметрі не ?storage= арқылы 7 күн тегін сақталады.
Әр модельдегі пішім бірдейtype, url, content_type, width, height және duration — кескіндерге, бейнеге және аудиоға ортақ. output — модельдің өз нәтижелер нысаны.
Шығыс өрістері
audio
object {url, content_type, file_name, file_size}Генерация нәтижесінде алынған аудио файлы.
seed
integerГенерация кезінде қолданылған кездейсоқ seed.
tags
stringГенерация кезінде қолданылған жанр тегтері.
lyrics
stringГенерация кезінде қолданылған мәтін.

Қосымша модельдер: Мәтіннен музыкаға

AI агенттеріне: бұл беттің Markdown нұсқасы мына жерде: https://doitong.com/kk/developers/models/ace-step.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt