Seed Audio API

لمحة سريعة

تشغّل Seed Audio API النموذج Seed Audio عبر Mage على POST https://api.mage.space/v1/seed_audio/generate. يكلّف الطلب بالإعدادات الافتراضية 19 Gems (نحو 0.019 دولار)، بلا اشتراك. يقبل Seed Audio المراجع الصوتية المحفوظة عبر @handle داخل الوصف.

• صوت

  المخرجات

• 1

  النسخة

• 19

  Gems لكل مقطع، افتراضيًا

• $0.019

  التكلفة التقريبية بالدولار

نظرة عامة

ما الذي تقدمه Seed Audio API

كلام وحوار وموسيقى ومؤثرات صوتية من وصف واحد، بصيغة MP3 بالمدة التي تطلبها تمامًا، من 5 ثوانٍ إلى دقيقتين. طابق صوتًا معيّنًا من خلال ما يصل إلى 3 مقاطع صوتية.

أصوات وحوار وموسيقى ومؤثرات صوتية من وصف واحد، بصيغة MP3 بالمدة المطلوبة تمامًا.

يقبل image كمدخل.

بداية سريعة

استدعاء Seed Audio API

عيّن MAGE_API_KEY، وأرسل الطلب إلى /seed_audio/generate، ثم استعلم عن status_url حتى يكتمل الطلب.

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"

// 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);

# 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 لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

الخيارات

معاملات Seed Audio

القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.

المدخلات

المدخلات الوسائطية التي يقبلها Seed Audio

أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.

القواعد

القيود التي تفرضها 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

الأسئلة الشائعة

الأسئلة الشائعة

ابدأ البناء مع Mage

حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.

ذات صلة

• واجهة API لتوليد الصوت بالذكاء الاصطناعي
• مرجع Seed Audio API
• ملعب Seed Audio
• جميع نماذج API
• خادم Mage MCP