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

ACE Step Prompt To Audio

التكامل

معرّف النموذج ace-step/prompt-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/prompt-to-audio?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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

يحوّل مطالبة نصية عادية إلى أغنية، ويستنتج العلامات والكلمات تلقائيًا، مع مفتاح للموسيقى الآلية

ACE Studio · صوت

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

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

إنشاء طلب

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

•مطلوب

تعليمات النمط التي تُولّد منها الوسوم والكلمات لتشكيل الصوت الناتج.

الافتراضي 60

مدة الصوت المُولّد، بوحدة الثواني.

متقدم 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 · 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/prompt-to-audio?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/prompt-to-audio?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  }'

# 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 Prompt To Audio

يحتاج فقط إلى `prompt` واحدة تصف الموسيقى. تُنتج العلامات والكلمات منها تلقائيًا، وتزيل علامة `instrumental` الغناء الصوتي. تتراوح `duration` من 5 إلى 240 ثانية، والقيمة الافتراضية 60. تشمل الخيارات المتقدمة `number_of_steps` و`scheduler` و`guidance_type` و`seed`.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
تعليمات النمط التي تُولّد منها الوسوم والكلمات لتشكيل الصوت الناتج.
instrumentalاختياري
النوعboolean
الافتراضيfalse
يتحكم فيما إذا كان الصوت المُولّد نسخة موسيقية آلية.
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/prompt-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": 12,
    "usd": "0.012",
    "charged": 12,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field"
  },
  "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/prompt-to-audio.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt