Video Modelsluma-ai

معرفی و مستندات مدل هوش مصنوعی luma-ai-v2

مستندات مدل luma-ai-v2 برای تولید و ویرایش ویدیوهای تولید شده توسط هوش مصنوعی، ارائه شده توسط ای آی کار (AI-KAR).

معرفی و بررسی فنی

⚡ وضعیت پشتیبانی از زبان فارسی

این مدل از زبان فارسی به صورت متوسط پشتیبانی می‌کند. برای دریافت بهترین نتیجه، توصیه می‌شود از توضیحات انگلیسی استفاده کنید.

مدل Luma AI Dream Machine API به توسعه‌دهندگان این امکان را می‌دهد تا ویدیوهای تولید شده توسط هوش مصنوعی را بر اساس توضیحات متنی ایجاد و گسترش دهند. هر بار تولید یا گسترش ویدیو، 500,000 توکن AI/ML هزینه دارد. برای شروع، نیاز به یک کلید API دارید. اگر کلید API برای AI/ML ندارید، می‌توانید از راهنمای شروع سریع ما استفاده کنید. برای تولید ویدیو با استفاده از این مدل، باید دو درخواست API متوالی ارسال کنید. اولین درخواست برای ایجاد و ارسال یک وظیفه تولید ویدیو به سرور است (که یک شناسه تولید برمی‌گرداند). این می‌تواند یک تولید از یک تصویر/توضیح مرجع یا یک عملیات گسترش ویدیو باشد که طول یک ویدیوی موجود را افزایش می‌دهد. درخواست دوم برای دریافت ویدیوی تولید شده یا گسترش یافته از سرور با استفاده از شناسه تولید دریافتی از نقطه پایانی اول است. در این درخواست API، می‌توانید از نقطه پایانی استاندارد برای دریافت ویدیوی تولید شده/گسترش یافته یا یک نقطه پایانی ویژه برای درخواست چندین تولید به طور همزمان استفاده کنید. در زیر، می‌توانید سه طرح API و مثال‌های مربوطه را برای تمام فراخوانی‌های نقطه پایانی پیدا کنید. این مدل از قابلیت‌های متنوعی برخوردار است که شامل تولید ویدیو از متن، گسترش ویدیوهای موجود، و کنترل دقیق بر جنبه‌های مختلف ویدیو مانند نسبت تصویر، طول، و کیفیت می‌شود. با استفاده از پارامترهای مختلف API، کاربران می‌توانند ویدیوهایی با کیفیت بالا و مطابق با نیازهای خود ایجاد کنند. این مدل به ویژه برای تولید محتوای تبلیغاتی، آموزشی، و سرگرمی مناسب است. همچنین، امکان استفاده از تصاویر و ویدیوهای موجود به عنوان مرجع، این مدل را به ابزاری قدرتمند برای ویرایش و بهبود ویدیوها تبدیل کرده است. با توجه به پشتیبانی از فرمت‌های مختلف ویدیو و امکان تنظیم دقیق پارامترها، کاربران می‌توانند ویدیوهایی با کیفیت و جذابیت بالا تولید کنند. این مدل با ارائه APIهای ساده و قابل فهم، به توسعه‌دهندگان این امکان را می‌دهد تا به راحتی از قابلیت‌های آن در برنامه‌های خود استفاده کنند.

مشخصات فنی (API References)

پارامتر	نوع	توضیحات و مقادیر
prompt	stringRequired	توضیحات متنی صحنه، موضوع یا عملی که می‌خواهید در ویدیو تولید شود.
aspect_ratio	string	نسبت تصویر ویدیوی تولید شده. مقادیر مجاز (کلیک برای کپی):
loop	boolean	مشخص می‌کند که آیا ویدیو به صورت حلقوی پخش شود یا خیر. مقدار پیش‌فرض: false
keyframes	object	فریم‌های کلیدی برای تصویر به ویدیو، گسترش یا درون‌یابی.
model	stringRequired	مدل مورد استفاده برای تولید ویدیو. مقادیر مجاز (کلیک برای کپی):
resolution	string	رزولوشن ویدیوی خروجی، که عدد به ضلع کوتاه‌تر بر حسب پیکسل اشاره دارد. مقادیر مجاز (کلیک برای کپی):
duration	integer	طول ویدیوی خروجی بر حسب ثانیه. مقادیر مجاز (کلیک برای کپی):
generation_type	string	نوع تولید. مقادیر مجاز (کلیک برای کپی):
callback_url	string	آدرس وب‌سایتی که پس از اتمام تولید ویدیو، به آن اطلاع داده می‌شود.
concepts	string	مفاهیم

نمونه کدهای درخواست

نکته مهم برای توسعه‌دهندگان:

برای احراز هویت، حتما کلید API خود را جایگزین YOUR_API_KEY کنید. هدر Authorization الزامی است.

import requests

def main():
    url = "https://api.ai-kar.com/v1/v2/video/generations"
    payload = {
        "model": "luma/ray-1-6",
        "prompt": "A menacing evil dragon appears in a distance above the tallest mountain, then rushes toward the camera with its jaws open, revealing massive fangs. We see it's coming."
    }
    headers = {
        "Authorization": "Bearer <YOUR_API_KEY>",
        "Content-Type": "application/json"
    }

    response = requests.post(url, json=payload, headers=headers)
    print("Generation:", response.json())

if __name__ == "__main__":
    main()

نمونه پاسخ موفق (JSON)

RESPONSE (200 OK)

{
  "id": "60ac7c34-3224-4b14-8e7d-0aa0db708325",
  "status": "completed",
  "video": {
    "url": "#",
    "duration": 8
  },
  "duration": 8,
  "error": null,
  "meta": {
    "usage": {
      "tokens_used": 120000
    }
  }
}