Video Modelsluma-ai

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

مستندات مدل luma-ray-2 ارائه شده توسط ای آی کار (AI-KAR)

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

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

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

مدل luma-ray-2 از luma-ai یک مدل پیشرفته تولید ویدیو است که توسط ای آی کار (AI-KAR) ارائه شده است. این مدل قادر است کلیپ‌های ویدیویی تا 9 ثانیه را با کیفیت 4K تولید کند. در مقایسه با مدل قبلی (Ray 1.6)، luma-ray-2 رزولوشن‌های بالاتر و مدت زمان طولانی‌تری را پشتیبانی می‌کند. یکی از ویژگی‌های برجسته این مدل، امکان تعیین فریم‌های اول و آخر ویدیو با استفاده از تصاویر است. همچنین، می‌توان ویدیوهای تولید شده قبلی را با استفاده از شناسه تولید (generation ID) آن‌ها گسترش داد. این قابلیت به کاربران اجازه می‌دهد تا ویدیوهای طولانی‌تر و پیچیده‌تری را به صورت مرحله‌ای ایجاد کنند. علاوه بر این، luma-ray-2 از ویدیوهای حلقه‌ای (looped videos) نیز پشتیبانی می‌کند که برای ایجاد محتوای تکراری و جذاب بسیار مفید است.

برای استفاده از این مدل، ابتدا باید یک کلید API معتبر از ای آی کار (AI-KAR) دریافت کنید. سپس، با استفاده از API، یک درخواست تولید ویدیو به سرور ارسال می‌کنید. این درخواست شامل پارامترهایی مانند متن توضیحات صحنه (prompt)، نسبت تصویر (aspect ratio)، و مدت زمان ویدیو (duration) است. پس از ارسال درخواست، یک شناسه تولید (generation ID) دریافت می‌کنید که برای پیگیری وضعیت تولید ویدیو استفاده می‌شود.

برای دریافت ویدیوی تولید شده، باید از شناسه تولید (generation ID) استفاده کنید و یک درخواست به سرور ارسال کنید. اگر وضعیت تولید ویدیو complete باشد، پاسخ شامل URL ویدیوی تولید شده و اطلاعات اضافی مانند مدت زمان ویدیو و میزان مصرف توکن‌ها خواهد بود. این مدل با بهره‌گیری از الگوریتم‌های پیشرفته هوش مصنوعی، قادر است ویدیوهایی با کیفیت بالا و جزئیات دقیق تولید کند. کاربران می‌توانند با استفاده از این مدل، محتوای ویدیویی متنوعی ایجاد کنند، از جمله ویدیوهای تبلیغاتی، ویدیوهای آموزشی، و ویدیوهای هنری. luma-ray-2 یک ابزار قدرتمند برای تولید محتوای ویدیویی است که به کاربران امکان می‌دهد تا ایده‌های خود را به واقعیت تبدیل کنند. این مدل به طور مداوم در حال بهبود است و ویژگی‌های جدیدی به آن اضافه می‌شود تا نیازهای کاربران را به بهترین شکل ممکن برآورده کند.

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

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

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

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

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

import requests
import time

# replace <YOUR_AI-KARAPI_KEY> with your actual ای آی کار (AI-KAR) key
api_key = "<YOUR_AI-KARAPI_KEY>"
base_url = "https://api.ai-kar.com/v1/video/generations"

# Creating and sending a video generation task to the server
def generate_video():
    url = f"{base_url}"
    headers = {
        "Authorization": f"Bearer {api_key}",
    }
    data = {
        "model": "luma/ray-2",
        "prompt": "The camera moves down, dives underwater and moves through a dark, moody world of greenish light and drifting plants. Giant white koi fish emerge from the shadows and turn curiously toward the camera as it passes, their scales shimmering faintly in the murky depths.",
        "keyframes":{
            "frame0": {
                "type": "image",
                "url": "https://raw.githubusercontent.com/AI-KARapi/api-docs/main/reference-files/landscape.jpg",
            },
            "frame1": {
                "type": "image",
                "url": "https://cdn.AI-KARapi.com/assets/content/white-fish.png",
            },
        },
        "duration": "5",
    }
    response = requests.post(url, json=data, headers=headers)
    if response.status_code >= 400:
        print(f"Error: {response.status_code} - {response.text}")
    else:
        response_data = response.json()
        # print(response_data)
        return response_data

# Requesting the result of the task from the server using the generation_id
def get_video(gen_id):
    url = f"{base_url}?generation_id={gen_id}"
    # Insert your AI-KAR API Key instead of <YOUR_AI-KARAPI_KEY>:
    headers = {
        "Authorization": f"Bearer {api_key}",
        "Content-Type": "application/json"
    }
    response = requests.get(url, headers=headers)
    # print("Generation:", response.json())
    return response.json()

def main():
    # Running video generation and getting a task id
    gen_response = generate_video()
    gen_id = gen_response.get("id")
    print("Generation ID:  ", gen_id)

    # Trying to retrieve the video from the server every 10 sec
    if gen_id:
        start_time = time.time()
        timeout = 600
        while time.time() - start_time < timeout:
            response_data = get_video(gen_id)
            if response_data is None:
                print("Error: No response from API")
                break
            status = response_data.get("status")
            print("Status:", status)
            if status == "waiting" or status == "active" or  status == "queued" or status == "generating":
                print("Still waiting... Checking again in 10 seconds.")
                time.sleep(10)
            else:
                print("Processing complete:/n", response_data)
                return response_data
        print("Timeout reached. Stopping.")
        return None

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
    }
  }
}