שפּרינגען צו אינהאַלט

ACE Step Audio Inpaint

אינטעגרירן

מאָדעל־id 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
לייגט אַרײַן אַ טעקע, אָדער

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

אינפּיינטינג־אָנהייבצײַט, געמאסטן אין סעקונדעס.

סטאַנדאַרט 30

אינפּיינטינג־סוףצײַט, געמאסטן אין סעקונדעס.

סטאַנדאַרט 0.5

אינפּיינטינג־וואַריאַנץ קאָנטראָלירט ווי דייווערס די רעזולטאַטן קענען זײַן; איר פאַרגרעסערן קען צוגעבן מער וואַריאַציע.

סטאַנדאַרט 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/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"

לויפֿן דעם ריקוועסט

אײַער key בלײַבט אין דעם בלעטערער: זי ווערט געשיקט נאָר צום Doitong API און אָפּגעהיט (localStorage) נאָר אויב איר טיקט אָן געדענקען. באַקומען אַן API שליסל

וועגן ACE Step Audio Inpaint

נעמט אַן `audio_url` און שרײַבט איבער בלויז דעם אָפּטייל צווישן `start_time` און `end_time`, וואָס ווערן ביידע געמאסטן אין סעקונדעס פֿון 0 ביז 240. יעדער צייט קען ווערן באַשטימט רעלאַטיוו צו דעם אָנהייב אָדער סוף פֿונעם קליפּ. נײַע `tags` און `lyrics` פירן דעם איבערגעביטענעם טייל, און `variance` קאָנטראָלירט ווי פֿאַרשיידנאַרטיק דער רעזולטאַט איז. די געוויינטלעכע גיידאַנס־ און סטעפּ־באַשטעטיקונגען זענען בנימצא.

פּאַראַמעטערס

שיקט אָדער דעם קאַנאָנישן נאָמען אָדער דעם נאַטיוון נאָמען, נישט ביידע. קאַנאָנישע נעמען

נאָמעןטיפּ סטאַנדאַרטערלויבט באַשרײַבונג
audio_urlפארלאנגט audio
טיפּurl · audio
URL פון דער אַודיאָ־פֿײַל פֿאַר אינפּיינטינג.
start_time_relative_toאָפּציאָנעל
טיפּenum
סטאַנדאַרטstart
startend
רעפֿערענץ־פּונקט פֿאַר דער אָנהייב־צײַט: אָדער דער אָנהייב פון אַודיאָ, אָדער זײַן סוף.
start_timeאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0
0 – 240
אינפּיינטינג־אָנהייבצײַט, געמאסטן אין סעקונדעס.
end_time_relative_toאָפּציאָנעל
טיפּenum
סטאַנדאַרטstart
startend
רעפֿערענץ־פּונקט פֿאַר דער סוף־צײַט: אָדער דער אָנהייב פון אַודיאָ, אָדער זײַן סוף.
end_timeאָפּציאָנעל
טיפּnumber
סטאַנדאַרט30
0 – 240
אינפּיינטינג־סוףצײַט, געמאסטן אין סעקונדעס.
tagsפארלאנגט
טיפּstring
אַודיאָ-סטיל־טאַגס, צוגעשטעלט ווי קאָמאַ־אָפּגעטיילטע זשאַנערס; `prompt` איז אַן אַלטערנאַטיווע וועג זיי צו צושטעלן.
lyricsאָפּציאָנעל
טיפּstring
סטאַנדאַרט
געזונגעןע ליריקס, מיט ליד־אָפּטיילן אָרגאַניזירט דורך קאָנטראָלן ווי [verse], [chorus] און [bridge]. פֿאַר אַודיאָ אָן געזונגעןע ליריקס, לאזט דעם אַרײַנגעבונג אויס אָדער צושטעלט בלויז [inst] אָדער [instrumental].
varianceאָפּציאָנעל
טיפּnumber
סטאַנדאַרט0.5
0 – 1
אינפּיינטינג־וואַריאַנץ קאָנטראָלירט ווי דייווערס די רעזולטאַטן קענען זײַן; איר פאַרגרעסערן קען צוגעבן מער וואַריאַציע.
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
סקאלה פון ליריקס־גיידאַנס וואָס ווערט געווענדט בעת גענערירונג.
פארלאנגט קאַנאָנישער נאָמען, אויך אַקצעפּטירט

טעקע־פּאַראַמעטערס נעמען אַן עפֿנטלעכע https:// URL, אַ data: URI ביז 10 MB, אָדער דעם 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־חודש) אָדער 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/yi/developers/models/ace-step/audio-inpaint.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt