رفتن به محتوا

MAGI-1 (Distilled) · Image to Video

یکپارچه‌سازی

شناسه مدل magi-distilled/image-to-video
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/magi-distilled/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

فایل‌هایی مانند نمونه: ⁨‎$۰٫۳۲⁩ ۳۲۰ اعتبار API فایل‌های شما پیش از اجرا اندازه‌گیری می‌شوند اجرای آن در این صفحه

دریافت کلید API
Sand AI تصویر به ویدیو سریعحداکثر 720p #image-to-video

یک تصویر ثابت را به‌عنوان فریم اول ویدیویی 96 تا 192 فریمی، با هدایت پرامپت، متحرک می‌کند

Sand AI · ویدیو

اولین نتیجه شما اینجا قرار می‌گیرد

درخواست را در زیر بسازید و با کلید API خود اجرا کنید. خروجی‌ها در فضای ذخیره‌سازی ما کپی می‌شوند و برای همیشه یا به‌مدت ۷ روز رایگان نگه‌داری می‌شوند.

ساخت درخواست

کنترل‌ها از شِمای مدل تولید می‌شوند. با تغییر آن‌ها، کد و قیمت به‌روزرسانی می‌شوند.

•الزامی

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

•الزامی image_url
یک فایل بیندازید، یا

URL تأمین‌کننده تصویر آغازین ویدیو؛ در صورت نیاز برای تطبیق با نسبت تصویر انتخاب‌شده، اندازه آن تغییر کرده و از مرکز بریده می‌شود.

resolution پیش‌فرض 720p

وضوح ویدیوی خروجی، 480p یا 720p.

num_inference_steps پیش‌فرض 16

تعداد گام‌های نمونه‌برداری؛ با افزایش تعداد، زمان پردازش بیشتر و کیفیت بهتر می‌شود.

aspect_ratio پیش‌فرض auto

تناسبات ویدیوی تولیدشده که وقتی روی 'auto' تنظیم شوند، به‌طور خودکار از تصویر ورودی انتخاب می‌شوند.

پیش‌فرض 96

تعداد فریم خروجی، با حداقل 96 و حداکثر 192.

پیشرفته seed · enable_safety_checker

Seed برای تکرارپذیر کردن تولید. تنظیم آن روی None، Seed را به‌صورت تصادفی انتخاب می‌کند.

POST /run/magi-distilled/image-to-video?wait=20 قیمت → ⁨‎$۰٫۳۲⁩
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/magi-distilled/image-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

اجرای این درخواست

کلید شما در این مرورگر باقی می‌ماند: فقط به Doitong API ارسال می‌شود و فقط در صورت فعال‌کردن گزینه «یادآوری»، در localStorage ذخیره می‌شود. دریافت کلید API

درباره MAGI-1 (Distilled) · Image to Video

از `image_url` به‌عنوان فریم اول و از یک `prompt` الزامی برای توصیف حرکت استفاده می‌کند. تصاویری که با نسبت تصویر انتخاب‌شده سازگار نیستند تغییر اندازه داده شده و از مرکز برش می‌خورند. `num_frames` از 96 تا 192، `resolution` برابر 480p یا 720p و `num_inference_steps` برابر 4، 8، 16 یا 32 است.

پارامترها

نام استاندارد یا نام بومی را ارسال کنید، نه هر دو. نام‌های استاندارد

نامنوع پیش‌فرضمجاز توضیحات
promptالزامی
نوعstring
دستورهای متنی برای هدایت تولید ویدیو.
image_urlالزامی image
نوعurl · image
URL تأمین‌کننده تصویر آغازین ویدیو؛ در صورت نیاز برای تطبیق با نسبت تصویر انتخاب‌شده، اندازه آن تغییر کرده و از مرکز بریده می‌شود.
num_framesاختیاری
نوعinteger | null
پیش‌فرض96
۹۶ – ۱۹۲
تعداد فریم خروجی، با حداقل 96 و حداکثر 192.
seedاختیاری
نوعinteger | null
Seed برای تکرارپذیر کردن تولید. تنظیم آن روی None، Seed را به‌صورت تصادفی انتخاب می‌کند.
resolutionاختیاری
نوعenum
پیش‌فرض720p
480p720p
وضوح ویدیوی خروجی، 480p یا 720p.
num_inference_stepsاختیاری
نوعenum
پیش‌فرض16
481632
تعداد گام‌های نمونه‌برداری؛ با افزایش تعداد، زمان پردازش بیشتر و کیفیت بهتر می‌شود.
enable_safety_checkerاختیاری
نوعboolean
پیش‌فرضtrue
کلید بررسی ایمنی که حالت خاموش آن به مجوز حساب نیاز دارد. بدون این مجوز، هر درخواست صرف‌نظر از تنظیم بررسی می‌شود؛ true بررسی‌کننده را فعال می‌کند.
aspect_ratioاختیاری
نوعenum
پیش‌فرضauto
auto16:99:161:1
تناسبات ویدیوی تولیدشده که وقتی روی 'auto' تنظیم شوند، به‌طور خودکار از تصویر ورودی انتخاب می‌شوند.
الزامی نام استاندارد، همچنین پذیرفته می‌شود

پارامترهای فایل یک URL عمومی https://، یک URI از نوع data: تا سقف 10 MB، یا file_url یک فایل بارگذاری‌شده را می‌پذیرند. فایل‌ها

خروجی

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "magi-distilled/image-to-video",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 320,
    "usd": "0.32",
    "charged": 320,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
فایل‌های شما، انتخاب شماهر outputs[].url کپی‌ای در فضای ذخیره‌سازی ماست: برای همیشه (با هزینه به‌ازای هر GB-ماه) یا به‌مدت ۷ روز رایگان، بر اساس تنظیم حساب شما یا ?storage=.
ساختار یکسان در همه مدل‌هاtype، url، content_type، width، height و duration برای تصاویر، ویدیو و صدا یکسان هستند. output شیء نتیجه اختصاصی مدل است.
فیلدهای خروجی
video
object {url, content_type, file_name, file_size}فایل ویدیویی تولیدشده.
seed
integerمقدار Seed اعمال‌شده هنگام تولید.

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

برای عامل‌های هوش مصنوعی: این صفحه به‌صورت Markdown در دسترس است https://doitong.com/fa/developers/models/magi-distilled/image-to-video.md. همه مدل‌ها و راهنماها: https://doitong.com/developers/llms.txt