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

ACE Step Audio To Audio

التكامل

معرّف النموذج ace-step/audio-to-audio
# 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-to-audio?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",
    "original_tags": "lofi, hiphop, drum and bass, trap, chill",
    "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-edit

يعيد مزج مسار موجود أو يستبدل كلماته، مسترشدًا بالوسوم الأصلية والجديدة

ACE Studio · صوت

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

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

إنشاء طلب

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

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

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

•مطلوب

الوسوم المرتبطة أصلاً بملف الصوت.

•مطلوب

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

متقدم original_lyrics · lyrics · edit_mode · 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 · original_seed
الافتراضي

الكلمات المرتبطة أصلاً بملف الصوت.

الافتراضي

كلمات الأغنية المغنّاة، مع تنظيم أقسام الأغنية باستخدام عناصر تحكم مثل [verse] و[chorus] و[bridge]. بالنسبة إلى الصوت من دون كلمات مغنّاة، احذف هذا المدخل أو قدّم [inst] أو [instrumental] فقط.

edit_mode الافتراضي remix

وضع التحرير: تغيير الكلمات فقط أو إعادة مزج الصوت.

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-to-audio?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-to-audio?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",
    "original_tags": "lofi, hiphop, drum and bass, trap, chill",
    "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 To Audio

يبدأ من `audio_url` مع `original_tags` الخاصة به، ويطبق `tags` جديدة لإعادة أسلوبه. تكون `edit_mode` إما remix لتغيير الصوت العام، أو lyrics لتحرير ما يُغنى فقط. يمكنك توفير `original_lyrics` و`lyrics` جديدة، إضافة إلى `original_seed` إن كان معروفًا. معلمات الخطوات والتوجيه مماثلة لبقية العائلة.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
audio_urlمطلوب audio
النوعurl · audio
عنوان URL لملف الصوت لإجراء outpainting.
edit_modeاختياري
النوعenum
الافتراضيremix
lyricsremix
وضع التحرير: تغيير الكلمات فقط أو إعادة مزج الصوت.
original_tagsمطلوب
النوعstring
الوسوم المرتبطة أصلاً بملف الصوت.
original_lyricsاختياري
النوعstring
الافتراضي
الكلمات المرتبطة أصلاً بملف الصوت.
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
مقياس توجيه الكلمات المطبّق أثناء التوليد.
original_seedاختياري
النوعinteger | null
البذرة المرتبطة أصلاً بملف الصوت.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ace-step/audio-to-audio",
  "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",
    "original_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 هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 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-to-audio.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt