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

Elevenlabs Music v2

التكامل

معرّف النموذج elevenlabs/music/v2
# 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/elevenlabs/music/v2?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"

ملفات مثل المثال: ⁨‏1.20 $⁩ 1,200 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
ElevenLabs تحويل النص إلى موسيقى #music#text-to-music

يؤلف موسيقى من مطالبة نصية أو خطة تأليف قائمة على المقاطع، مع وضع اختياري للموسيقى الآلية فقط

ElevenLabs · صوت

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

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

إنشاء طلب

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

88 / 4100

وصف نصي للموسيقى المطلوبة.

مدة الأغنية الاختيارية بالمللي ثانية، وتتراوح من 3000 ms إلى 600000 ms، وتنطبق فقط عند استخدام موجّه. عند حذفها، يحدد النموذج المدة من الموجّه.

متقدم output_format · seed · force_instrumental · composition_plan
الافتراضي mp3_48000_192

اختر تنسيق الصوت المُولّد باستخدام النمط codec_sample_rate_bitrate. تستخدم مدخلات صوت Twilio عادةً μ-law، ويُكتب أيضًا mu-law أو يُقرَّب إلى u-law؛ ومن أمثلة MP3 `mp3_22050_32`، الذي يحدد معدل أخذ عينات 22.05 kHz ومعدل بت 32 kbs.

بذرة تهيئة لتوليد الموسيقى، ولا يمكن استخدامها إلا مع `composition_plan`، لتحسين الاتساق بين عمليات التشغيل ذات المعلمات والبذرة المتطابقة. النتائج غير مضمونة للتكرار التام.

خطة تكوين الموسيقى منظمة في مقاطع.

POST /run/elevenlabs/music/v2?wait=20 عرض السعر → ⁨‏1.20 $⁩
# 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/elevenlabs/music/v2?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

حول Elevenlabs Music v2

ينشئ موسيقى من مطالبة نصية `prompt` تصل إلى 4100 حرف، أو من `composition_plan` منظمة. يحدد `music_length_ms` المدة بين 3000 و600000 ms عند استخدام مطالبة، ويزيل `force_instrumental` الغناء. يحدد `output_format` برنامج الترميز ومعدل أخذ العينات ومعدل البت، بما في ذلك خياري MP3 وPCM. يعمل `seed` فقط مع خطة تأليف.

المعاملات

الاسمالنوع الافتراضيمسموح الوصف
promptاختياري
النوعstring | null
≤ 4,100 حرف
وصف نصي للموسيقى المطلوبة.
composition_planاختياري
النوعobject
خطة تكوين الموسيقى منظمة في مقاطع.
composition_plan.chunksمطلوب
النوعobject[]
1 – 30 items
المقاطع المرتبة المستخدمة للتوليد، بحد أقصى 30 مقطعًا وبمدة إجمالية من 3000 ms إلى 600000 ms.
composition_plan.chunks[].textمطلوب
النوعstring
نص توليد المقطع، بحد أقصى 30 سطرًا، يصل كل منها إلى 200 حرف. يمكن أن تتضمن الكلمات توجيهات مضمنة بين أقواس معقوفة، مثل {scratching}، وقد تسبقها تسمية قسم افتتاحي اختيارية بين أقواس مربعة، مثل [Verse 1]. يجب أن تحتوي تسمية القسم على 1–100 حرف.
composition_plan.chunks[].duration_msمطلوب
النوعinteger
3,000 – 120,000
طول المقطع بالمللي ثانية، ويتراوح من 3000 ms إلى 120000 ms.
composition_plan.chunks[].positive_stylesمطلوب
النوعstring[]
الأنماط والتوجيهات الموسيقية المطلوبة لهذا المقطع، مع التأثير الأكبر لاختيارات المقطع الأول؛ إذ تحدد نوع الأغنية ونبرتها العامة. قد تطوّر المقاطع اللاحقة الموسيقى أو تضيف تفاصيل أو تغيّر الاتجاه؛ وتعمل الأوصاف الإنجليزية بأفضل شكل.
composition_plan.chunks[].negative_stylesاختياري
النوعstring[]
الأنماط والتوجيهات الموسيقية المطلوب تجنبها في هذا المقطع؛ حدّد العناصر للاستبعادات الصريحة فقط، وإلا فإن ترك القائمة فارغة يُعد قيمة افتراضية جيدة.
composition_plan.chunks[].context_adherenceاختياري
النوعenum
lowmediumhigh
توازن مراعاة السياق بين الحرية الإبداعية والاتساق مع المقاطع المجاورة: اختر قيمة عالية للاتساق، أو منخفضة للسماح بانحرافات إبداعية أكبر.
composition_plan.chunks[].audio_referenceاختياري
النوعobject
مقطع صوتي لتكييف النمط لهذا المقطع؛ ولتشكيل الأغنية بأكملها، وفّره في المقطع الأول. لهذا الموضع التأثير الأكبر لأن مرجعه يؤثر في كل مقطع لاحق.
music_length_msاختياري
النوعinteger | null
3,000 – 600,000
مدة الأغنية الاختيارية بالمللي ثانية، وتتراوح من 3000 ms إلى 600000 ms، وتنطبق فقط عند استخدام موجّه. عند حذفها، يحدد النموذج المدة من الموجّه.
force_instrumentalاختياري
النوعboolean
الافتراضيfalse
عنصر تحكم للموسيقى الآلية فقط، ومتاح عند استخدام موجّه فقط. يضمن تعيينه إلى true أن يكون المخرج موسيقى آلية؛ بينما يسمح false بموسيقى آلية أو غير آلية وفقًا للموجّه.
seedاختياري
النوعinteger | null
بذرة تهيئة لتوليد الموسيقى، ولا يمكن استخدامها إلا مع `composition_plan`، لتحسين الاتساق بين عمليات التشغيل ذات المعلمات والبذرة المتطابقة. النتائج غير مضمونة للتكرار التام.
output_formatاختياري
النوعenum
الافتراضيmp3_48000_192
mp3_22050_32mp3_24000_48mp3_44100_32mp3_44100_64mp3_44100_96mp3_44100_128mp3_44100_192mp3_48000_128mp3_48000_192mp3_48000_240mp3_48000_320pcm_8000pcm_16000pcm_22050pcm_24000pcm_32000
+9 أخرىpcm_44100pcm_48000ulaw_8000alaw_8000opus_48000_32opus_48000_64opus_48000_96opus_48000_128opus_48000_192
اختر تنسيق الصوت المُولّد باستخدام النمط codec_sample_rate_bitrate. تستخدم مدخلات صوت Twilio عادةً μ-law، ويُكتب أيضًا mu-law أو يُقرَّب إلى u-law؛ ومن أمثلة MP3 `mp3_22050_32`، الذي يحدد معدل أخذ عينات 22.05 kHz ومعدل بت 32 kbs.
مطلوب

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "elevenlabs/music/v2",
  "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": 1200,
    "usd": "1.20",
    "charged": 1200,
    "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
    }
  },
  "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}ملف الموسيقى المُولّدة بترميز صوت MP3.

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

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