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

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

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

אײַער 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.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.md. אַלע מאָדעלן און גוידעס: https://doitong.com/developers/llms.txt