لمحة سريعة
يشغّل Kiwi API نموذج Kiwi عبر Mage على POST https://api.mage.space/v1/kiwi/generate. يكلّف الطلب بالإعدادات الافتراضية 270 Gem (نحو 0.27 دولار) دون اشتراك. لا يدعم Kiwi الإشارات بـ @handle.
فيديو
المخرجات
1
النسخة
270
Gems لكل مقطع، افتراضيًا
$0.27
التكلفة التقريبية بالدولار
نظرة عامة
ماذا يقدّم Kiwi API
فيديو بسيط وموثوق من نص أو من إطار البداية، دون أي إعدادات أخرى. مدته 5 أو 10 ثوانٍ بدقة تصل إلى 1080p.
فيديو يومي من نص أو من إطار بداية واحد، دون أي إعداد إضافي.
يقبل first_image كمدخل.
بداية سريعة
استدعاء Kiwi API
عيّن MAGE_API_KEY، وأرسل الطلب إلى /kiwi/generate، ثم استعلم عن status_url بشكل متكرر حتى يكتمل الطلب.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/kiwi/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": "5",
"model_id": "kiwi"
}' | 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('kiwi', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '5',
model_id: 'kiwi',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("kiwi", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "5",
"model_id": "kiwi",
})
print(request["result"]["url"])النماذج
قيم model_id في Kiwi
أرسل model_id لاختيار إصدار. الطلب الذي لا يتضمنه يستخدم الإصدار الافتراضي.
| model_id | الاسم | افتراضي |
|---|---|---|
| kiwi | Kiwi | نعم |
الخيارات
معاملات Kiwi
القيم المسموح بها في جميع الإصدارات؛ وقد يوفّر أحد الإصدارات عددًا أقل منها. تسرد الوثائق الخيارات لكل إصدار.
| الحقل | القيم |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 480p, 720p, 1080p |
| duration | 5, 10 |
المدخلات
مدخلات الوسائط التي يقبلها Kiwi
أرسل كل مدخل كرابط https أو رابط بيانات (data URL) أو ملف مرفوع بحجم يصل إلى 100 MB.
| الحقل | الدور |
|---|---|
| first_image | صورة الإطار الأول. |
المزيد من نماذج الفيديو
واجهات برمجة أخرى لتوليد الفيديو على Mage
فيديو · من 245 Gems
واجهة Lemon API
كل ميزات الفيديو بسعر أنسب
فيديو · من 20 Gems
LTX Video API
فيديو سريع بأوزان مفتوحة للتجارب المتكررة
فيديو · من 147 Gems
Melon API
أنمي متحرك، مع صوت اختياري
فيديو · ابتداءً من 30 Gems
MiniMax-H3 API
فيديو مفتوح سريع بصوت ستيريو
فيديو · من 338 Gems
واجهة Plum API
صوت مع كل مقطع، حتى 2K
فيديو · من 360 Gems
Raspberry API
شخصيات تنبض بالحياة من الإطار الأول
الأسئلة الشائعة
الأسئلة الشائعة
كم تبلغ تكلفة Kiwi API؟
يكلّف طلب Kiwi بالإعدادات الافتراضية (Kiwi) 270 Gem، أي نحو 0.27 دولار. تؤثر الدقة والمدة والإصدارات الأخرى في السعر، وتوضّح الاستجابة المبلغ الدقيق. يُعاد المبلغ عند فشل التوليد، أما التوليد الذي تحظره سياسة المحتوى في Mage فلا يُعاد مبلغه.
ما نقطة نهاية Kiwi API؟
أرسل طلب POST إلى https://api.mage.space/v1/kiwi/generate مع ترويسة Authorization: Bearer تحمل مفتاح Mage API الخاص بك. تتضمن الاستجابة status_url للاستعلام عنه بشكل متكرر إلى أن تصل النتيجة.
ما نماذج Kiwi التي يمكنني استدعاؤها؟
kiwi. النموذج الافتراضي هو Kiwi.
هل يدعم Kiwi الصور المرجعية أو الشخصيات؟
يقبل Kiwi المدخل first_image. ولا يدعم الإشارات بـ @handle.
هل يمكنني استخدام Kiwi من Claude أو ChatGPT؟
نعم. اربط خادم Mage MCP بـ Claude أو ChatGPT أو Claude Code أو Grok أو Cursor واطلب Kiwi بالاسم. يقرأ مساعدك خياراته عبر get_model ويذكر السعر قبل التوليد.
كم تُحفظ نتائج Kiwi؟
يُحتفظ بالنتائج والمدخلات لمدة 30 يومًا. نزّل كل ما تريد الاحتفاظ به إلى مساحة التخزين الخاصة بك.
ابدأ البناء مع Mage
حساب واحد، ورصيد Gems واحد، وكل النماذج. ادفع فقط مقابل ما تنشئه.