Мазмұнға өту

ACE Step Audio Inpaint

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

Модель идентификаторы ace-step/audio-inpaint
# 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/audio-inpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "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,002 $ 2 API кредиті файлдарыңыз іске қосу алдында өлшенеді Осы бетте іске қосу

API кілтін алу
ACE Studio Мәтіннен музыкаға #audio-to-audio#audio-inpaint#audio-repaint

Жаңа тегтер мен мәтін арқылы бар аудио файлдың таңдалған уақыт бөлігін қайта жасайды

ACE Studio · Аудио

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

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

Сұрау жасау

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

•міндетті audio_url
Файлды тастаңыз немесе

Inpainting үшін аудио файлының URL мекенжайы.

•міндетті

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

Қосымша lyrics · start_time_relative_to · end_time_relative_to · scheduler · guidance_type · start_time · end_time · variance · 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] мәнін беріңіз.

start_time_relative_to әдепкі start

Басталу уақытының анықтамалық нүктесі: аудионың басы немесе соңы.

end_time_relative_to әдепкі start

Аяқталу уақытының анықтамалық нүктесі: аудионың басы немесе соңы.

scheduler әдепкі euler

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

guidance_type әдепкі apg

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

әдепкі 0

Секундпен өлшенетін inpainting басталу уақыты.

әдепкі 30

Секундпен өлшенетін inpainting аяқталу уақыты.

әдепкі 0.5

Inpainting дисперсиясы нәтижелердің әртүрлілік деңгейін басқарады; оны арттыру қосымша вариация енгізуі мүмкін.

әдепкі 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/audio-inpaint?wait=20 бағасы → 0,002 $
# 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/audio-inpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "audio": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3",
    "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 Audio Inpaint туралы

`audio_url` арқылы берілген аудионың тек `start_time` мен `end_time` арасындағы бөлігін қайта жазады, олардың әрқайсысы 0-ден 240-қа дейінгі секундпен өлшенеді. Уақытты клиптің басына немесе соңына қатысты орнатуға болады. Жаңа `tags` пен `lyrics` ауыстырылатын бөлікті бағыттайды, ал `variance` нәтиженің әртүрлілік деңгейін басқарады. Әдеттегі нұсқаулар мен қадам параметрлері қолжетімді.

Параметрлер

Канондық атауды немесе төл атауды жіберіңіз, екеуін қатар жібермеңіз. Канондық атаулар

АтауыТүрі ӘдепкіРұқсат етілген Сипаттама
audio_urlміндетті audio
Түріurl · audio
Inpainting үшін аудио файлының URL мекенжайы.
start_time_relative_toміндетті емес
Түріenum
Әдепкіstart
startend
Басталу уақытының анықтамалық нүктесі: аудионың басы немесе соңы.
start_timeміндетті емес
Түріnumber
Әдепкі0
0 – 240
Секундпен өлшенетін inpainting басталу уақыты.
end_time_relative_toміндетті емес
Түріenum
Әдепкіstart
startend
Аяқталу уақытының анықтамалық нүктесі: аудионың басы немесе соңы.
end_timeміндетті емес
Түріnumber
Әдепкі30
0 – 240
Секундпен өлшенетін inpainting аяқталу уақыты.
tagsміндетті
Түріstring
Үтірмен бөлінген жанрлар түрінде берілетін аудио стилінің тегтері; оларды берудің балама тәсілі ретінде `prompt` қолжетімді.
lyricsміндетті емес
Түріstring
Әдепкі
[verse], [chorus] және [bridge] сияқты басқару элементтері арқылы ән бөлімдері ұйымдастырылған орындалатын мәтін. Орындалатын мәтіні жоқ аудио үшін бұл кірісті өткізіп жіберіңіз немесе тек [inst] не [instrumental] мәнін беріңіз.
varianceміндетті емес
Түріnumber
Әдепкі0.5
0 – 1
Inpainting дисперсиясы нәтижелердің әртүрлілік деңгейін басқарады; оны арттыру қосымша вариация енгізуі мүмкін.
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
Генерация кезінде мәтінге қолданылатын нұсқау масштабы.
міндетті Канондық атау, бұл да қабылданады

Файл параметрлері жалпыға қолжетімді https:// URL мекенжайын, 10 MB-қа дейінгі data: URI мекенжайын немесе жүктеп салынған файлдың file_url мәнін қабылдайды. Файлдар

Шығыс

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ace-step/audio-inpaint",
  "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": 2,
    "usd": "0.002",
    "charged": 2,
    "refunded": 0
  },
  "input": {
    "tags": "lofi, hiphop, drum and bass, trap, chill",
    "audio_url": "https://content.doitong.com/audio/showcase/v3/tools/dub_es.mp3"
  },
  "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/audio-inpaint.md. Барлық модельдер мен нұсқаулықтар: https://doitong.com/developers/llms.txt