تخطّي إلى المحتوى

ACE Step Audio Outpaint

التكامل

معرّف النموذج ace-step/audio-outpaint
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ace-step/audio-outpaint?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

ملفات مثل المثال: ⁨‏0.006 $⁩ 6 أرصدة API · ≈ ⁨‏0.64 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
ACE Studio تحويل النص إلى موسيقى 0–107 ث #audio-to-audio#audio-outpaint#audio-extend

يمدّد مقطعًا صوتيًا موجودًا قبل بدايته أو بعد نهايته بموسيقى مؤلفة حديثًا

ACE Studio · صوت

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب audio_url
أفلت ملفًا، أو

عنوان URL لملف الصوت لإجراء outpainting.

•مطلوب

وسوم نمط الصوت المقدمة كأنواع مفصولة بفواصل، مع توفر `prompt` كطريقة بديلة لتقديمها.

الافتراضي 0

مدة الامتداد قبل بداية الصوت، بالثواني.

الافتراضي 30

مدة الامتداد بعد نهاية الصوت، بالثواني.

متقدم 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/audio-outpaint?wait=20 عرض السعر → ⁨‏0.006 $⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ace-step/audio-outpaint?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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول ACE Step Audio Outpaint

يواصل مسارًا مقدمًا عبر `audio_url`. يضيف كل من `extend_before_duration` و`extend_after_duration` مدة تصل إلى 107 ثوانٍ في البداية أو النهاية، والقيمة الافتراضية هي 30 ثانية بعد النهاية. يأتي الأسلوب من `tags`، مع إمكانية إضافة `lyrics` للأجزاء الجديدة. تتطابق إعدادات عدد الخطوات والمجدول والتوجيه مع نماذج ACE Step الأخرى.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
audio_urlمطلوب audio
النوعurl · audio
عنوان URL لملف الصوت لإجراء outpainting.
extend_before_durationاختياري
النوعnumber
الافتراضي0
0 – 107
مدة الامتداد قبل بداية الصوت، بالثواني.
extend_after_durationاختياري
النوعnumber
الافتراضي30
0 – 107
مدة الامتداد بعد نهاية الصوت، بالثواني.
tagsمطلوب
النوعstring
وسوم نمط الصوت المقدمة كأنواع مفصولة بفواصل، مع توفر `prompt` كطريقة بديلة لتقديمها.
lyricsاختياري
النوعstring
الافتراضي
كلمات الأغنية المغنّاة، مع تنظيم أقسام الأغنية باستخدام عناصر تحكم مثل [verse] و[chorus] و[bridge]. بالنسبة إلى الصوت من دون كلمات مغنّاة، احذف هذا المدخل أو قدّم [inst] أو [instrumental] فقط.
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
مقياس توجيه الكلمات المطبّق أثناء التوليد.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ace-step/audio-outpaint",
  "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": 6,
    "usd": "0.006",
    "charged": 6,
    "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.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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الكلمات المطبّقة أثناء التوليد.

مزيد من النماذج: تحويل النص إلى موسيقى

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/ace-step/audio-outpaint.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt