Video Modelsluma-ai

معرفی و مستندات مدل هوش مصنوعی luma-ai-text-to-video-v1-legacy

مستندات مدل luma-ai-text-to-video-v1-legacy ارائه شده توسط ای آی کار (AI-KAR).

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

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

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

مدل luma-ai-text-to-video-v1-legacy یک مدل تولید ویدیو از متن است که توسط Luma AI توسعه داده شده است. این مدل به کاربران اجازه می‌دهد تا با ارائه یک متن (prompt)، ویدیوهای کوتاه و خلاقانه تولید کنند. این مدل از طریق API قابل دسترسی است و به توسعه‌دهندگان امکان می‌دهد تا آن را در برنامه‌های خود ادغام کنند. این مدل از دو مرحله اصلی تشکیل شده است: مرحله اول، ایجاد و ارسال یک درخواست تولید ویدیو به سرور است که یک شناسه تولید (generation ID) را برمی‌گرداند. این مرحله می‌تواند شامل تولید از یک تصویر مرجع/متن یا یک عملیات توسعه ویدیو باشد که طول یک ویدیوی موجود را افزایش می‌دهد. مرحله دوم، درخواست ویدیوی تولید شده یا توسعه یافته از سرور با استفاده از شناسه تولید دریافت شده از مرحله اول است. این مدل از پارامترهای مختلفی برای کنترل جنبه‌های مختلف تولید ویدیو پشتیبانی می‌کند، از جمله نسبت تصویر (aspect ratio)، گسترش متن (expand prompt)، و URL تصاویر مرجع. این مدل برای کاربردهای خلاقانه مانند تولید محتوای بصری از متن، ایجاد ویدیوهای تبلیغاتی کوتاه، و تولید محتوای آموزشی مناسب است. با استفاده از این مدل، کاربران می‌توانند به سرعت و به آسانی ویدیوهای جذاب و منحصر به فرد تولید کنند. این مدل یک ابزار قدرتمند برای تولیدکنندگان محتوا، بازاریابان، و هر کسی است که به دنبال راهی سریع و آسان برای تولید ویدیوهای با کیفیت است. مدل luma-ai-text-to-video-v1-legacy به عنوان یک مدل قدیمی‌تر، همچنان می‌تواند برای برخی از کاربردها مفید باشد، اما ممکن است به اندازه مدل‌های جدیدتر Luma AI پیشرفته نباشد. با این حال، سادگی و سهولت استفاده از آن، آن را به یک گزینه جذاب برای کاربرانی که به دنبال یک راه حل ساده و کارآمد برای تولید ویدیو از متن هستند، تبدیل می‌کند. این مدل به توسعه‌دهندگان اجازه می‌دهد تا به سرعت و به آسانی ویدیوهای جذاب و منحصر به فرد تولید کنند. این مدل یک ابزار قدرتمند برای تولیدکنندگان محتوا، بازاریابان، و هر کسی است که به دنبال راهی سریع و آسان برای تولید ویدیوهای با کیفیت است.

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

پارامتر	نوع	توضیحات و مقادیر
model	string	مدل مورد استفاده برای تولید ویدیو. مقدار پیش‌فرض ray-1-6 است. مقادیر مجاز (کلیک برای کپی):
aspect_ratio	stringRequired	نسبت تصویر ویدیو. مقادیر مجاز: 1:1، 16:9، 9:16، 4:3، 3:4، 21:9، 9:21. مقادیر مجاز (کلیک برای کپی):
expand_prompt	boolean	مشخص می‌کند که آیا متن ورودی (prompt) گسترش یابد یا خیر. مقدار پیش‌فرض false است. مقادیر مجاز (کلیک برای کپی):
image_end_url	string	URL تصویر پایانی. این تصویر در انتهای ویدیو نمایش داده می‌شود.
image_url	string	URL تصویر اصلی. این تصویر به عنوان مرجع برای تولید ویدیو استفاده می‌شود.
user_prompt	stringRequired	متن ورودی (prompt) ارائه شده توسط کاربر برای تولید ویدیو. این متن باید به صورت واضح و مختصر بیان شود.
ids	stringRequired	آرایه‌ای از رشته‌های UUID یا رشته‌ای با UUIDهای جدا شده با کاما.
taskId	stringRequired	شناسه وظیفه (Task ID) برای توسعه ویدیو.

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

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

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

import requests

url = "https://api.ai-kar.com/v1/luma-ai/generations"

payload = {
    "aspect_ratio": "16:9",
    "expand_prompt": True,
    "user_prompt": "Flying jellyfish"
}
headers = {
    "Authorization": "Bearer <YOUR_AI-KARAPI_KEY>",
    "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.json())

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

RESPONSE (200 OK)

{}