ملی ای‌پی‌آی

API Gen-4.5

مدل ویدیویی Runway برای تدوینگر و تیم تولید محتوا که نمای بی‌صدای تمیز با حرکت طبیعی می‌خواهد و صدا و موسیقی را خودش در تدوین می‌گذارد.

ساخت حساب و دریافت کلید

مشخصات و قیمت API Gen-4.5

نام مدل در فراخوان
runwayml-gen-4.5
نوع
تبدیل متن به ویدیو و عکس به ویدیو
مدت ویدیو
۵، ۱۰ ثانیه
کیفیت
ثابت
صدا
بی‌صدا
نگه‌داری فایل
۷ روز
تنظیمهر ثانیهویدیوی ۵ ثانیه‌ایویدیوی ۱۰ ثانیه‌ای
هر ثانیه۴۰٬۱۹۴ تومان۲۰۰٬۹۷۰ تومان۴۰۱٬۹۴۰ تومان

قیمت‌ها شامل مالیات بر ارزش افزوده‌اند. مبلغ کامل ویدیو هنگام ثبت درخواست از موجودی قفل می‌شود؛ اگر ساخت موفق شود همان مبلغ کسر می‌شود و اگر ناموفق باشد، کامل به موجودی برمی‌گردد.

دربارهٔ Gen-4.5

Runway Gen-4.5 مدل تولید ویدیوی شرکت Runway است که در آذر ۱۴۰۴ (دسامبر

  1. معرفی شد. Runway سال‌هاست ابزار ساخت و ویرایش ویدیو برای

فیلم‌سازها و تدوینگرها می‌سازد و Gen-4.5 نسل تازهٔ مدل‌های Gen آن است. هم از توصیف متنی ویدیو می‌سازد و هم از یک تصویر به‌عنوان فریم اول. اگر «API رانوی» یا «API Runway Gen-4.5» جست‌وجو کرده‌ای، همین صفحه است.

ویدیوی بی‌صدا، و چرا این مهم است

خروجی Gen-4.5 صدا ندارد. این مهم‌ترین فرقش با بقیهٔ مدل‌های ویدیویی ماست: Veo 3.1 و Veo 3.1 Fast از Google، Grok Imagine Video و Grok Imagine Video 1.5 از xAI و Wan 3.0 از Alibaba همه صدا را همراه تصویر می‌سازند.

برای خیلی از کارها این ضعف نیست. تدوینگری که روی ویدیو موسیقی، گویندگی فارسی یا صدای برند می‌گذارد، صدای ساخته‌شدهٔ مدل را به‌هرحال دور می‌ریزد. برای او ویدیوی بی‌صدا یعنی پرداخت فقط برای چیزی که استفاده می‌کند.

طول و وضوح کلیپ

طول هر ویدیو فقط ۵ یا ۱۰ ثانیه است و عدد دیگری در duration پذیرفته نمی‌شود. Runway وضوح خروجی Gen-4.5 را 720p اعلام کرده و در درخواست پارامتری برای وضوح نیست. اگر کار نهایی‌ات در وضوح بالاتر پخش می‌شود، مثلاً تلویزیون یا نمایشگر بزرگ، این را از اول در نظر بگیر.

نماهایی که تدوینگر و فروشگاه از آن می‌گیرند

کاربرد اصلی‌اش نمای تکمیلی است، همان چیزی که تدوینگرها «بی‌رول» صدا می‌کنند:

  • نمای کوتاه برای لابه‌لای ویدیوی آموزشی یا گزارشی، جایی که فیلم واقعی

نداری.

  • متحرک‌کردن عکس محصول برای ریلز با موسیقی خود برند.
  • پس‌زمینهٔ متحرک برای ویدیوی گوینده‌محور یا اسلاید ارائه.
  • ساخت چند نمای پیشنهادی برای استوری‌بورد یک تیزر.

روند فراخوان و خواندن نتیجه

درخواست را با POST به /api/v1/ai/videos/ بفرست و model را runwayml-gen-4.5 بگذار، توصیف را در prompt و طول را بر حسب ثانیه در duration. برای ساخت از روی عکس، تصویر فریم اول را با نشانی https یا data URL در image بفرست. چون این مدل صدا ندارد، فیلد audio معنایی برایش ندارد.

پاسخ با کد HTTP 202 و شناسهٔ کار برمی‌گردد. هر چند ثانیه /api/v1/ai/videos/<id>/ را بخوان تا status به succeeded برسد و videoUrl بیاید. ساخت معمولاً از چند ده ثانیه تا چند دقیقه طول می‌کشد.

قیمت API رانوی و حساب ثانیه‌ای

تعرفه برای هر ثانیه ویدیو است و در جدول بالای همین صفحه آمده. هنگام ثبت درخواست، هزینهٔ کامل طولی که خواسته‌ای از موجودی رزرو می‌شود؛ اگر ساخت شکست بخورد کل آن برمی‌گردد و اگر موفق شود دقیقاً همان مبلغ کسر می‌شود. تعرفه هم یک عدد ثابت برای هر ثانیه است. پس کلیپ ۵ ثانیه‌ای را ۱۰ ثانیه نخواه به این امید که بعداً کوتاهش کنی؛ هزینهٔ ۱۰ ثانیه را می‌دهی.

توصیف خوب برای Gen-4.5

توصیف را مثل دستور فیلم‌برداری بنویس: موضوع، حرکت دوربین، نور و حال‌وهوا، هر کدام در یک عبارت کوتاه. در عمل توصیف انگلیسی معمولاً دقیق‌تر دنبال می‌شود. اگر از عکس شروع می‌کنی، توصیف را روی حرکت بگذار، نه روی دوباره‌گفتن آنچه در عکس هست.

نوشتهٔ فارسی داخل تصویر را از مدل نخواه؛ حروف پیوسته به‌هم‌ریخته درمی‌آیند. عنوان و زیرنویس را در تدوین اضافه کن. فایل را هم زود دانلود کن: ویدیو ۷ روز روی سرور ما می‌ماند و بعد پاک می‌شود. دانلود از videoUrl همان سرآیند Authorization با کلید API را می‌خواهد.

کجا نباید سراغ Gen-4.5 رفت

اگر ویدیو باید صدای محیط، افکت یا گفت‌وگو داشته باشد و نمی‌خواهی صدا را جدا بسازی، Veo 3.1 یا Grok Imagine Video این را در یک فراخوان می‌دهند. اگر کلیپ پیوستهٔ بلندتر از ۱۰ ثانیه یا وضوح 1080p لازم داری، Wan 3.0 را امتحان کن.

کاربردهای API Gen-4.5

  • نمای تکمیلی برای ویدیوی آموزشینمای کوتاه و بی‌صدا برای لابه‌لای ویدیوی گوینده‌محور می‌سازد، جایی که فیلم واقعی از موضوع در دست نیست.
  • ریلز محصول با موسیقی برندعکس محصول را متحرک می‌کند و چون خروجی صدا ندارد، موسیقی و گویندگی خود برند بی‌تداخل رویش گذاشته می‌شود.
  • استوری‌بورد متحرک تیزرچند نمای پیشنهادی برای یک تیزر می‌سازد تا پیش از فیلم‌برداری، ریتم و ترکیب نماها با تیم و مشتری مرور شود.

اتصال به API Gen-4.5

ساخت ویدیو ناهمگام است: درخواست، شناسهٔ کار را برمی‌گرداند و نه خود ویدیو. وضعیت را هر چند ثانیه با همان شناسه بپرسید تا succeeded شود و نشانی فایل (videoUrl) بیاید. دریافت فایل هم همان کلید API را می‌خواهد. برای ساخت ویدیو از عکس، نشانی https یا data URL تصویر آغازین را در فیلد image بفرستید.

# ۱. ثبت کار
curl -X POST 'https://melliapi.net/api/v1/ai/videos/' \
  -H 'Authorization: Bearer melli_live_…' \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "runwayml-gen-4.5",
    "prompt": "A slow cinematic drone shot over the Persian Gulf at sunset",
    "duration": 5
  }'
# → { "ok": true, "id": "vid_…", "status": "processing", … }

# ۲. پیگیری تا پایان
curl 'https://melliapi.net/api/v1/ai/videos/vid_…/' -H 'Authorization: Bearer melli_live_…'

# ۳. دریافت فایل
curl -L -o video.mp4 'https://melliapi.net/api/v1/ai/videos/vid_…/content/' \
  -H 'Authorization: Bearer melli_live_…'
import time, requests

API = "https://melliapi.net/api/v1/ai/videos/"
HEADERS = {"Authorization": "Bearer melli_live_…"}

job = requests.post(API, headers=HEADERS, json={"model":"runwayml-gen-4.5","prompt":"A slow cinematic drone shot over the Persian Gulf at sunset","duration":5}).json()
while job["status"] == "processing":
    time.sleep(5)
    job = requests.get(API + job["id"] + "/", headers=HEADERS).json()

if job["status"] == "succeeded":
    video = requests.get(job["videoUrl"], headers=HEADERS)
    open("video.mp4", "wb").write(video.content)
else:
    print(job["error"])

کدهای خطا و جزئیات صورتحساب در مستندات API هوش مصنوعی آمده است.

پرسش‌های متداول

آیا ویدیوی Runway Gen-4.5 صدا دارد؟

نه. خروجی Gen-4.5 بی‌صداست و صدا، موسیقی یا گویندگی را باید در تدوین اضافه کنید. اگر صدای ساخته‌شده همراه تصویر می‌خواهید، Veo 3.1، Grok Imagine Video 1.5 یا Wan 3.0 در همین سایت صدا را در همان فراخوان می‌سازند.

آیا API رانوی را می‌شود در ایران بدون کارت ارزی خرید؟

بله. حساب را در پنل ما با پرداخت ریالی شارژ می‌کنید و درخواست از سرور شما به سرور ما و از آنجا به Runway می‌رود. نه VPN لازم است و نه کارت بین‌المللی، و هزینهٔ هر ویدیو از همان موجودی کسر می‌شود.

ویدیوی Gen-4.5 چند ثانیه و با چه کیفیتی است؟

طول هر ویدیو فقط ۵ یا ۱۰ ثانیه است و Runway وضوح خروجی Gen-4.5 را 720p اعلام کرده. برای ویدیوی بلندتر چند کلیپ بسازید و در تدوین کنار هم بگذارید؛ شروع از یک عکس مشترک یکدستی نماها را بیشتر می‌کند.

هزینهٔ هر ویدیوی Gen-4.5 کی از موجودی کم می‌شود؟

هنگام ثبت درخواست، هزینهٔ کامل طول درخواستی رزرو می‌شود. اگر ساخت موفق شود همان مبلغ کسر می‌شود و اگر شکست بخورد کل آن برمی‌گردد. پس طول را همان‌قدر بخواهید که لازم دارید، نه بیشتر.

شروع