واجهة API لتوليد الفيديو بالذكاء الاصطناعي من النصوص أو الصور

لمحة سريعة

واجهة Mage API لتوليد الفيديو هي واجهة REST على العنوان https://api.mage.space/v1 تشغّل 12 نموذجًا لتحويل النص إلى فيديو والصورة إلى فيديو، منها Cherry 2 Pro وLemon وPlum وMelon وMiniMax-H3 وGrok Video وWan. أرسل وصفًا مع إطارات أو مراجع اختيارية، وتابع حالة الطلب، ثم نزّل ملف MP4. ويُدفع ثمن كل مقطع بالـ Gems بحسب النموذج والدقة والمدة.

• 12

  نماذج فيديو

• $0.02

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

• 20

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

• $0

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

النماذج

جميع نماذج الفيديو في Mage API

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

بداية سريعة

أنشئ فيديو باستخدام Berry 2

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

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "berry-2"
}' | 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('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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

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

ماذا يبني المطورون بواجهة API للفيديو

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

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

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

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

ذات صلة

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