Mage API · توليد الصوت
واجهة API لتوليد الصوت بالذكاء الاصطناعي: أصوات وموسيقى ومؤثرات
كلام وتعليق صوتي وموسيقى ومؤثرات صوتية من وصف واحد مع Seed Audio، مع مراجع صوتية وتحكم في سرعة الكلام وارتفاع الصوت ودرجته.
POST https://api.mage.space/v1/{model}/generateلمحة سريعة
تشغّل واجهة Mage API لتوليد الصوت نموذج Seed Audio على https://api.mage.space/v1/seed_audio/generate. أرسل وصفًا نصيًا، مع مراجع صوتية أو صورة إن أردت، لتحصل على ملف صوتي يصل إلى 120 ثانية يضم أصواتًا أو موسيقى أو مؤثرات صوتية. يُدفع ثمن كل مقطع بالـ Gems، من دون اشتراك.
- 4نماذج صوتية
- $0.019أرخص خيار افتراضي لكل مقطع
- 20عمليات توليد متزامنة
- $0الرسوم الشهرية
النماذج
جميع النماذج الصوتية في Mage API
الأسعار لكل عملية توليد، بـ Gems. يكلّف 1,000 Gems دولارًا واحدًا في الباقة القياسية، وتضيف الباقات الأكبر Gems إضافية. يعتمد السعر على النموذج والدقة والمدة؛ ويظهر السعر بالإعدادات الافتراضية، وتوضح كل استجابة الرسوم الدقيقة في billing.gems_charged. تُسترد تكلفة عملية التوليد الفاشلة، أما التي تحظرها سياسة المحتوى في Mage فلا تُسترد.
| النموذج | الأنسب لـ | قيم model_id | السعر الافتراضي |
|---|---|---|---|
| Eleven Music | أغانٍ من ElevenLabs، بأصوات غنائية أو بدونها | eleven-music-v2.5 | 113 Gems ($0.113) |
| Eleven Speech | ElevenLabs v4: كلام واقعي يمكنك توجيهه | eleven-v4 | 30 Gems ($0.03) |
| MiniMax Music 3 | أغانٍ كاملة من كلماتك، بأوزان مفتوحة | minimax-music-3 | 125 Gems ($0.125) |
| Seed Audio | أصوات وموسيقى ومؤثرات صوتية من وصف واحد | seed-audio-1.0 | 19 Gems ($0.019) |
بداية سريعة
ولّد الصوت باستخدام Eleven Music v2.5
عيّن MAGE_API_KEY، وأرسل الطلب، ثم استعلم دوريًا حتى يكتمل. استبدل eleven_music في عنوان URL بأي نموذج من النماذج أعلاه.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/eleven_music/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('eleven_music', {
prompt: 'An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.',
duration: '30',
model_id: 'eleven-music-v2.5',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("eleven_music", {
"prompt": "An upbeat indie pop song about a summer road trip, bright guitars, handclaps, female vocals, 110 BPM.",
"duration": "30",
"model_id": "eleven-music-v2.5",
})
print(request["result"]["url"])كيف يعمل
من مفتاح API إلى وسائط جاهزة في ثلاث طلبات
تشترك جميع النماذج في نظام مصادقة واحد، ودورة طلب غير متزامنة واحدة، وأسماء الحقول نفسها.
أنشئ مفتاح API
سجّل الدخول إلى Mage، وافتح API ← API Keys، وأنشئ مفتاحًا. يبدأ بـ mage_sk_ ويظهر مرة واحدة فقط. يمكن للحساب الواحد الاحتفاظ بـ 10 مفاتيح نشطة.
أرسل طلب توليد
أرسل طلب POST بجسم JSON إلى https://api.mage.space/v1/{model}/generate مع ترويسة Authorization: Bearer. تعود الاستجابة فورًا مع request_id وstatus وstatus_url. أضف ترويسة Idempotency-Key حتى لا تدفع مرتين عند إعادة المحاولة.
تحقّق ثم نزّل
استعلم عن status_url إلى أن تصبح الحالة completed أو failed أو cancelled. يحتوي الطلب المكتمل على result.url الذي يشير إلى ملف الصورة أو الفيديو أو الصوت، ويُحفظ لمدة 30 يومًا.
جاهزة للإنتاج
ما يحصل عليه كل طلب إلى Mage API
مفتاح واحد لكل النماذج
37 نموذجًا للصور والفيديو والصوت عبر واجهة REST API واحدة ورصيد Gems واحد. بدّل النموذج بتغيير مسار الرابط.
ادفع مقابل كل عملية إنشاء
بلا اشتراك وبلا حد أدنى للإنفاق. تشتري Gems ويُحتسب على كل طلب سعره المعلن. وإذا فشلت عملية الإنشاء يُسترد المبلغ، إلا إذا حظرتها سياسة المحتوى في Mage.
إعادة محاولة آمنة
تتيح مفاتيح عدم التكرار (Idempotency keys) إعادة إرسال الطلب لتحصل على الطلب الأصلي نفسه دون خصم جديد.
شخصيات متسقة
احفظ شخصية أو مرجعًا مرة واحدة، ثم اكتب @handle في أي أمر لاستخدامه مع كل نموذج يدعم ذلك.
مدخلات كبيرة
أرسل مدخلات الصور والفيديو والصوت كروابط URL أو data URL، أو ارفع ملفات حتى 100 MB عبر رفع موقّع.
20 عملية إنشاء متزامنة
يمكن لكل حساب تشغيل 20 عملية إنشاء في وقت واحد، ويمكن رفع هذا الحد بما يناسب حالتك. الطلبات المرفوضة لا تُحتسب أبدًا.
حالات الاستخدام
ماذا يبني المطورون بواجهة الصوت
التعليق الصوتي والسرد
ولّد تعليقًا صوتيًا لمقاطع الفيديو والشروحات والكتب الصوتية، مع التحكم في سرعة الكلام وارتفاع الصوت ودرجته.
أصوات ثابتة
احفظ مقطعًا صوتيًا كمرجع واذكره بواسطة @handle للحفاظ على الصوت نفسه عبر المقاطع.
مؤثرات صوتية
أنشئ أجواء صوتية ومؤثرات فولي وأصوات واجهات من وصف نصي للألعاب والتطبيقات.
موسيقى خلفية
أنتج موسيقى خلفية لمقاطع التواصل الاجتماعي والإعلانات انطلاقًا من وصف نصي.
موسيقى تصويرية للفيديو المولَّد
اجمع Seed Audio مع واجهة الفيديو لإضافة الصوت إلى المقاطع الصادرة من نماذج صامتة.
وكلاء يتكلمون
دع Claude أو ChatGPT أو وكيلك الخاص ينتج الصوت عبر خادم MCP أو واجهة REST API.
الأسئلة الشائعة
الأسئلة الشائعة
هل تدعم واجهة الصوت تحويل النص إلى كلام؟
ما أقصى مدة للصوت المولَّد؟
كم تبلغ تكلفة Mage API؟
هل أحتاج إلى عضوية في Mage لاستخدام API؟
هل يمكنني استخدام مخرجات API تجاريًا؟
ما حدود معدّل الطلبات؟
هل يمكن لوكيل الذكاء الاصطناعي الخاص بي استخدام واجهة Mage API؟
هل توجد حزمة SDK لواجهة Mage API؟
أستخدم واجهة توليد أخرى بالفعل. ماذا عليّ أن أغيّر؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.