واجهة API لتوليد الصوت بالذكاء الاصطناعي: أصوات وموسيقى ومؤثرات

لمحة سريعة

تشغّل واجهة Mage API لتوليد الصوت نموذج Seed Audio على https://api.mage.space/v1/seed_audio/generate. أرسل وصفًا نصيًا، مع مراجع صوتية أو صورة إن أردت، لتحصل على ملف صوتي يصل إلى 120 ثانية يضم أصواتًا أو موسيقى أو مؤثرات صوتية. يُدفع ثمن كل مقطع بالـ Gems، من دون اشتراك.

• 1

  نماذج صوتية

• $0.019

  أرخص خيار افتراضي لكل مقطع

• 20

  عمليات توليد متزامنة

• $0

  الرسوم الشهرية

النماذج

جميع النماذج الصوتية في Mage API

الأسعار لكل عملية توليد، بـ Gems. يكلّف 1,000 Gems دولارًا واحدًا في الباقة القياسية، وتضيف الباقات الأكبر Gems إضافية. يعتمد السعر على النموذج والدقة والمدة؛ ويظهر السعر بالإعدادات الافتراضية، وتوضح كل استجابة الرسوم الدقيقة في billing.gems_charged. تُسترد تكلفة عملية التوليد الفاشلة، أما التي تحظرها سياسة المحتوى في Mage فلا تُسترد.

بداية سريعة

ولّد الصوت باستخدام Seed Audio

عيّن MAGE_API_KEY، وأرسل الطلب، ثم تحقق من حالته حتى يكتمل. استبدل seed_audio في الرابط باسم أي نموذج من النماذج أعلاه.

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"])

كيف يعمل

من مفتاح API إلى وسائط جاهزة في ثلاث طلبات

تشترك جميع النماذج في نظام مصادقة واحد، ودورة طلب غير متزامنة واحدة، وأسماء الحقول نفسها.

1. 01

   أنشئ مفتاح API

   سجّل الدخول إلى Mage، وافتح API ← API Keys، وأنشئ مفتاحًا. يبدأ بـ mage_sk_ ويظهر مرة واحدة فقط. يمكن للحساب الواحد الاحتفاظ بـ 10 مفاتيح نشطة.

2. 02

   أرسل طلب توليد

   أرسل طلب POST بجسم JSON إلى https://api.mage.space/v1/{model}/generate مع ترويسة Authorization: Bearer. تعود الاستجابة فورًا مع request_id وstatus وstatus_url. أضف ترويسة Idempotency-Key حتى لا تدفع مرتين عند إعادة المحاولة.

3. 03

   تحقّق ثم نزّل

   استعلم عن status_url إلى أن تصبح الحالة completed أو failed أو cancelled. يحتوي الطلب المكتمل على result.url الذي يشير إلى ملف الصورة أو الفيديو أو الصوت، ويُحفظ لمدة 30 يومًا.

جاهزة للإنتاج

ما يحصل عليه كل طلب إلى Mage API

حالات الاستخدام

ماذا يبني المطورون بواجهة الصوت

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

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

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

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

ذات صلة

• واجهة API لتوليد الصور بالذكاء الاصطناعي
• واجهة API لتوليد الفيديو بالذكاء الاصطناعي
• خادم Mage MCP
• حزم Mage SDK
• Mage لـ ComfyUI
• جميع نماذج API
• ساحة تجربة API
• وثائق API