דילוג לתוכן

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
גרור קובץ, או

כתובת 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

סולם הנחיית המילים המוחל במהלך היצירה.

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 ונשמר ב-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
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
סולם הנחיית המילים המוחל במהלך היצירה.
חובה שם קנוני, מתקבל גם הוא

פרמטרים של קבצים מקבלים URL ציבורי מסוג https://, כתובת URI מסוג data: בגודל של עד 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
integerSeed אקראי המשמש במהלך היצירה.
tags
stringתגיות ז'אנר המוחלות במהלך היצירה.
lyrics
stringמילים המוחלות במהלך היצירה.

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

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