رفتن به محتوا

Mage API · مدل ویدیو

Kiwi API

ویدیوی روزمره، بدون نیاز به راه‌اندازی

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

در یک نگاه

Kiwi API مدل Kiwi را از طریق مایج روی POST https://api.mage.space/v1/kiwi/generate اجرا می‌کند. یک درخواست با تنظیمات پیش‌فرض 270 Gems (حدود $0.27) هزینه دارد، بدون اشتراک. Kiwi اشاره با @handle را نمی‌پذیرد.

  • ویدیوخروجی
  • 1نسخه
  • 270Gems برای هر کلیپ، پیش‌فرض
  • $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نامپیش‌فرض
kiwiKiwiبله

گزینه‌ها

پارامترهای Kiwi

مقادیر مجاز برای همه نسخه‌ها؛ ممکن است یک نسخه گزینه‌های کمتری داشته باشد. گزینه‌های هر نسخه در مستندات آمده است.

فیلدمقادیر
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration5, 10

ورودی‌ها

ورودی‌های رسانه‌ای که Kiwi می‌پذیرد

هرکدام را به‌صورت URL با https، data URL یا آپلود تا 100 MB بفرستید.

فیلدنقش
first_imageتصویر فریم اول.

مدل‌های ویدیویی بیشتر

سایر APIهای ساخت ویدیو در Mage

  • ویدیو · از ۲۴۵ Gem

    Lemon API

    همه‌ی قابلیت‌های ویدیو با قیمتی مناسب‌تر

  • ویدیو · از 20 Gems

    LTX Video API

    ویدیوی سریع با وزن‌های باز برای آزمون و خطا

  • ویدیو · از 147 Gems

    Melon API

    انیمه در حرکت، با صدای اختیاری

  • ویدیو · از ۳۰ Gem

    MiniMax-H3 API

    ویدیوی متن‌باز سریع با صدای استریو

  • ویدیو · از ۳۳۸ Gem

    Plum API

    صدا برای هر کلیپ، تا 2K

  • ویدیو · از 360 Gems

    Raspberry API

    شخصیت‌هایی که از یک فریم اول زنده می‌شوند

سؤالات متداول

سؤالات متداول

هزینه Kiwi API چقدر است؟
یک درخواست Kiwi با تنظیمات پیش‌فرض (Kiwi) 270 Gems هزینه دارد، حدود $0.27. رزولوشن، مدت و نسخه‌های دیگر قیمت را تغییر می‌دهند و مبلغ دقیق در پاسخ اعلام می‌شود. اگر تولید ناموفق باشد هزینه برگردانده می‌شود، اما اگر سیاست محتوایی Mage جلوی آن را بگیرد برگردانده نمی‌شود.
اندپوینت Kiwi API چیست؟
درخواست POST به https://api.mage.space/v1/kiwi/generate بفرستید و کلید API مایج خود را در هدر Authorization: Bearer قرار دهید. پاسخ شامل یک status_url است که برای گرفتن نتیجه باید آن را مرتب بررسی کنید.
کدام مدل‌های Kiwi را می‌توانم فراخوانی کنم؟
kiwi. مدل پیش‌فرض Kiwi است.
آیا Kiwi از تصویر مرجع یا کاراکتر پشتیبانی می‌کند؟
Kiwi ورودی first_image را می‌پذیرد. اشاره با @handle را نمی‌پذیرد.
آیا می‌توانم از Claude یا ChatGPT از Kiwi استفاده کنم؟
بله. سرور MCP مایج را به Claude، ChatGPT، Claude Code، Grok یا Cursor وصل کنید و Kiwi را با نام بخواهید. دستیار شما گزینه‌های آن را با get_model می‌خواند و پیش از تولید، قیمت را اعلام می‌کند.
نتیجه‌های Kiwi تا چه مدت نگهداری می‌شوند؟
نتایج و ورودی‌ها 30 روز نگهداری می‌شوند. هر چیزی را که می‌خواهید نگه دارید، در فضای ذخیره‌سازی خودتان دانلود کنید.

ساختن با Mage را شروع کن

یک حساب، یک موجودی Gems، همهٔ مدل‌ها. فقط برای چیزی که تولید می‌کنی هزینه بپرداز.