Mage API · نموذج صوتي
Seed Audio API
أصوات وموسيقى ومؤثرات صوتية من وصف واحد
POST https://api.mage.space/v1/seed_audio/generateلمحة سريعة
تشغّل Seed Audio API النموذج Seed Audio عبر Mage على POST https://api.mage.space/v1/seed_audio/generate. يكلّف الطلب بالإعدادات الافتراضية 19 Gems (نحو 0.019 دولار)، بلا اشتراك. يقبل Seed Audio المراجع الصوتية المحفوظة عبر @handle داخل الوصف.
- صوتالمخرجات
- 1النسخة
- 19Gems لكل مقطع، افتراضيًا
- $0.019التكلفة التقريبية بالدولار
نظرة عامة
ما الذي تقدمه Seed Audio API
كلام وحوار وموسيقى ومؤثرات صوتية من وصف واحد، بصيغة MP3 بالمدة التي تطلبها تمامًا، من 5 ثوانٍ إلى دقيقتين. طابق صوتًا معيّنًا من خلال ما يصل إلى 3 مقاطع صوتية.
أصوات وحوار وموسيقى ومؤثرات صوتية من وصف واحد، بصيغة MP3 بالمدة المطلوبة تمامًا.
يقبل image كمدخل.
بداية سريعة
استدعاء Seed Audio API
عيّن MAGE_API_KEY، وأرسل الطلب إلى /seed_audio/generate، ثم استعلم عن status_url حتى يكتمل الطلب.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/seed_audio/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0"
}' | 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('seed_audio', {
prompt: 'A calm narrator reading a short weather report',
duration: '5',
model_id: 'seed-audio-1.0',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("seed_audio", {
"prompt": "A calm narrator reading a short weather report",
"duration": "5",
"model_id": "seed-audio-1.0",
})
print(request["result"]["url"])النماذج
قيم model_id في Seed Audio
أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.
| model_id | الاسم | افتراضي |
|---|---|---|
| seed-audio-1.0 | Seed Audio | نعم |
الخيارات
معاملات Seed Audio
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| duration | 5, 10, 30, 60, 120 |
المدخلات
المدخلات الوسائطية التي يقبلها Seed Audio
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| image | الصورة المرجعية. |
القواعد
القيود التي تفرضها Seed Audio API
- لا يمكن الجمع بين مرجع صورة ومراجع صوتية: أرسل نوعًا واحدًا فقط.
- الحد الأقصى للوصف هو 2986 حرفًا.
- قيمة `sample_rate` إحدى القيم: 8000 أو 16000 أو 24000 أو 32000 أو 44100 أو 48000.
- قيمة `speech_rate` عدد صحيح من -50 إلى 100.
- قيمة `loudness_rate` عدد صحيح من -50 إلى 100.
- قيمة `pitch_rate` عدد صحيح من -12 إلى 12.
المزيد من النماذج الصوتية
واجهات توليد الصوت الأخرى على Mage
Eleven Music API
أغانٍ من ElevenLabs، بأصوات غنائية أو بدونها
واجهة Eleven Speech API
ElevenLabs v4: كلام واقعي يمكنك توجيهه
MiniMax Music 3 API
أغانٍ كاملة من كلماتك، بأوزان مفتوحة
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Seed Audio API؟
ما نقطة نهاية Seed Audio API؟
ما نماذج Seed Audio التي يمكنني استدعاؤها؟
هل يدعم Seed Audio الصور المرجعية أو الشخصيات؟
هل يمكنني استخدام Seed Audio من Claude أو ChatGPT؟
ما مدة الاحتفاظ بنتائج Seed Audio؟
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.