דילוג לתוכן

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 ונשמר ב-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
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-חודש) או למשך 7 ימים ללא תשלום, בהתאם להגדרת החשבון או ל־?storage=.
אותו מבנה בכל מודלtype, url, content_type, width, height ו-duration, עבור תמונות, וידאו ואודיו כאחד. output הוא אובייקט התוצאה של המודל עצמו.
שדות הפלט
audio
object {url, content_type, file_name, file_size}קובץ האודיו שנוצר.
seed
integerSeed אקראי המשמש במהלך היצירה.
tags
stringתגיות ז'אנר המוחלות במהלך היצירה.
lyrics
stringמילים המוחלות במהלך היצירה.

מודלים נוספים: טקסט למוזיקה

לסוכני AI: דף זה בפורמט Markdown נמצא בכתובת https://doitong.com/he/developers/models/ace-step.md. כל המודלים והמדריכים: https://doitong.com/developers/llms.txt