انتقل إلى المحتوى

Mage API · نموذج فيديو

Cherry API

عائلة نماذج الفيديو الرائدة لدينا

POST https://api.mage.space/v1/cherry/generate

لمحة سريعة

تشغّل Cherry API النموذج Cherry 2 Pro و4 إصدارات أخرى عبر Mage على POST https://api.mage.space/v1/cherry/generate. يكلّف الطلب بالإعدادات الافتراضية 618 Gems (حوالي 0.618$)، بدون اشتراك. يقبل Cherry الشخصيات المحفوظة والمراجع والمراجع الصوتية عبر @handle في الوصف النصي.

  • فيديوالمخرجات
  • 5الإصدارات
  • 618Gems لكل مقطع، افتراضيًا
  • $0.618التكلفة التقريبية بالدولار

نظرة عامة

ماذا تقدّم Cherry API

فيديو سينمائي بصوت، من Cherry Mini للمسودات إلى Cherry 2 Pro، أقوى نماذجنا، بمقاطع تصل إلى 30 ثانية ومراجع أو Characters متعددة وتعديلات على فيديو مصدر.

سلسلة الفيديو الرائدة من Mage، بحركة سينمائية وصوت: Cherry Mini وCherry وCherry Pro وCherry 2 وCherry 2 Pro الأقوى بينها. تنتج نماذج Cherry 2 مقاطع تصل مدتها إلى 30 ثانية.

تقبل المدخلات image وadditional_images وvideos.

بداية سريعة

استدعاء Cherry API

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/cherry/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": "4",
  "model_id": "cherry-2-pro"
}' | 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('cherry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'cherry-2-pro',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

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

print(request["result"]["url"])

النماذج

قيم model_id في Cherry

أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.

model_idالاسمافتراضي
cherry-miniCherry Mini
cherryCherry
cherry-proCherry Pro
cherry-2Cherry 2
cherry-2-proCherry 2 Proنعم

الخيارات

معلمات Cherry

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

الحقلالقيم
aspect_ratio16:9, 9:16, 1:1
resolution480p, 720p, 1080p, 4k
duration4, 5, 8, 10, 15, 20, 25, 30

المدخلات

مدخلات الوسائط التي يقبلها Cherry

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

الحقلالدور
imageالصورة المرجعية.
additional_imagesصور مرجعية إضافية.
videosمقاطع الفيديو المصدر.

القواعد

القيود التي تفرضها Cherry API

  • يتطلب تعديل الفيديو فيديو مصدر واحدًا فقط، مدته من 4 إلى 30 ثانية في `cherry-2` و`cherry-2-pro`، ومن 2 إلى 15 ثانية في النماذج الأخرى.
  • في `cherry-2` و`cherry-2-pro` يحافظ التعديل على مدة الفيديو المصدر ونسبة أبعاده: يتم تجاهل `duration` و`aspect_ratio`، ويتبع السعر مدة الفيديو.

المزيد من نماذج الفيديو

واجهات برمجة أخرى لتوليد الفيديو على Mage

  • فيديو · من 375 Gems

    Grok Video API

    Grok Imagine في حالة حركة

  • فيديو · من 270 Gems

    Kiwi API

    فيديو للاستخدام اليومي دون أي إعداد

  • فيديو · من 245 Gems

    واجهة Lemon API

    كل ميزات الفيديو بسعر أنسب

  • فيديو · من 20 Gems

    LTX Video API

    فيديو سريع بأوزان مفتوحة للتجارب المتكررة

  • فيديو · من 1,856 Gem

    Magejutsu API

    أعِد تمثيل أي فيديو مع الحفاظ على حركته

  • فيديو · من 147 Gems

    Melon API

    أنمي متحرك، مع صوت اختياري

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

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

كم تبلغ تكلفة Cherry API؟
يكلّف طلب Cherry بالإعدادات الافتراضية (Cherry 2 Pro) ‏618 Gems، أي حوالي 0.618$. تؤثر الدقة والمدة والنماذج الأخرى في السعر، وتعرض الاستجابة التكلفة الدقيقة. يُعاد المبلغ عند فشل التوليد، ولا يُعاد إذا حجبته سياسة المحتوى في Mage.
ما هو عنوان نقطة نهاية Cherry API؟
POST https://api.mage.space/v1/cherry/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عن النتيجة.
ما نماذج Cherry التي يمكنني استدعاؤها؟
cherry-mini (Cherry Mini)، cherry (Cherry)، cherry-pro (Cherry Pro)، cherry-2 (Cherry 2)، cherry-2-pro (Cherry 2 Pro). النموذج الافتراضي هو Cherry 2 Pro.
هل يدعم Cherry الصور المرجعية أو الشخصيات؟
يقبل Cherry المدخلات image وadditional_images وvideos. ويأخذ الشخصيات والمراجع والمراجع الصوتية المحفوظة عبر @handle في الوصف.
هل يمكنني استخدام Cherry من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP مع Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Cherry بالاسم. سيقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
كم مدة الاحتفاظ بنتائج Cherry؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.

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

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

Charactersالمجتمع