Перейти к содержимому

ACE Step

Интеграция

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"

Этот запрос: 0,012 $ 12 API-кредитов · ≈ 1,27 ₽ Запустить на этой странице

Получить 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

Масштаб управления текстом песни, применяемого при генерации.

Сид для воспроизводимой генерации; выбирается случайным образом, если значение не указано.

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.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"

Запустить этот запрос

Ваш ключ хранится в этом браузере: он отправляется только в Doitong API и сохраняется в localStorage только при включении параметра «Запомнить». Получить API-ключ

О ACE Step

Создаёт музыкальный трек из разделённых запятыми стилевых `tags` и необязательных `lyrics`. Маркеры секций, такие как [verse] и [chorus], формируют структуру песни, а [inst] создаёт инструментальную композицию. `duration` может быть от 5 до 240 секунд. Параметры сэмплирования включают `scheduler` (euler или heun), `guidance_type` и `number_of_steps` от 3 до 60.

Параметры

ИмяТип По умолчаниюДопустимые значения Описание
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
Сид для воспроизводимой генерации; выбирается случайным образом, если значение не указано.
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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Ваши файлы — ваш выборКаждый URL из outputs[].url — это копия в нашем хранилище: она хранится навсегда (оплата за ГБ в месяц) или 7 дней бесплатно — в зависимости от настройки вашего аккаунта или параметра ?storage=.
Одинаковая структура у каждой моделиtype, url, content_type, width, height и duration — одинаково для изображений, видео и аудио. output — собственный объект результата модели.
Поля результата
audio
object {url, content_type, file_name, file_size}Аудиофайл, созданный в результате генерации.
seed
integerСлучайный сид, использованный при генерации.
tags
stringЖанровые теги, применённые при генерации.
lyrics
stringТекст песни, применённый при генерации.

Другие модели: Текст в музыку

Для AI-агентов: эта страница в формате Markdown доступна по адресу https://doitong.com/ru/developers/models/ace-step.md. Все модели и руководства: https://doitong.com/developers/llms.txt