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

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.ru/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.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

هذا الطلب: ⁨‏0.012 $⁩ 12 رصيد API · ≈ ⁨‏1.27 ₽⁩ تشغيله في هذه الصفحة

الحصول على مفتاح 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

مقياس توجيه الكلمات المطبّق أثناء التوليد.

بذرة للتوليد القابل لإعادة الإنتاج، تُختار عشوائيًا ما لم تقدّم قيمة.

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.ru/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.ru/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
بذرة للتوليد القابل لإعادة الإنتاج، تُختار عشوائيًا ما لم تقدّم قيمة.
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.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.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt