Video Modelsgoogle

معرفی و مستندات مدل هوش مصنوعی veo-3-fast-text-to-video

مستندات مدل تولید ویدیو از متن veo-3-fast-text-to-video از گوگل، ارائه شده توسط ای آی کار (AI-KAR).

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

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

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

معرفی مدل هوش مصنوعی veo-3-fast-text-to-video

مدل veo-3-fast-text-to-video یک مدل پیشرفته تولید ویدیو از متن است که توسط گوگل توسعه داده شده است. این مدل قادر است ویدیوهای واقع‌گرایانه با کیفیت 720p و 1080p با جزئیات بصری و صوتی تولید کند. این مدل به طور خاص برای سرعت و هزینه بهینه شده است، که آن را به یک انتخاب عالی برای کاربردهایی تبدیل می‌کند که نیاز به تولید سریع ویدیو با هزینه کم دارند.

این مدل در مقایسه با مدل Veo 3 (Text-to-Video) سریع‌تر و مقرون به صرفه‌تر است. با استفاده از این مدل، کاربران می‌توانند به راحتی با ارائه یک متن توصیفی، ویدیوهای جذاب و با کیفیتی تولید کنند.

نحوه استفاده از مدل

برای استفاده از این مدل، باید از طریق API درخواست ارسال کنید. فرآیند تولید ویدیو شامل دو مرحله است:

  1. ایجاد و ارسال یک وظیفه تولید ویدیو به سرور (که یک شناسه تولید را برمی‌گرداند).
  2. درخواست ویدیو تولید شده از سرور با استفاده از شناسه تولید دریافت شده از مرحله اول.

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

قابلیت‌ها و ویژگی‌ها

  • تولید ویدیوهای واقع‌گرایانه: این مدل قادر است ویدیوهایی با جزئیات بصری بالا و صدا تولید کند.
  • کیفیت بالا: پشتیبانی از رزولوشن‌های 720p و 1080p.
  • سرعت بالا: بهینه‌سازی شده برای تولید سریع ویدیو.
  • هزینه کم: مقرون به صرفه‌تر از مدل‌های مشابه.
  • کنترل پارامترها: امکان تنظیم پارامترهایی مانند نسبت تصویر، رزولوشن، طول ویدیو و غیره.

پارامترهای API

برای تولید ویدیو، می‌توانید پارامترهای مختلفی را تنظیم کنید. این پارامترها به شما امکان می‌دهند تا ویدیوهای سفارشی‌تری تولید کنید. به عنوان مثال، می‌توانید نسبت تصویر، رزولوشن و طول ویدیو را تعیین کنید. همچنین، می‌توانید یک متن منفی ارائه دهید تا از نمایش عناصر خاصی در ویدیو جلوگیری کنید.

این مدل برای تولید محتوای ویدیویی متنوعی مناسب است، از جمله تبلیغات، آموزش، سرگرمی و غیره. با استفاده از این مدل، می‌توانید به راحتی ایده‌های خود را به ویدیو تبدیل کنید.

تیم ای آی کار (AI-KAR) این مدل را به شما پیشنهاد می‌کند تا از امکانات تولید ویدیوی خودکار بهره‌مند شوید.

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

پارامترنوعتوضیحات و مقادیر
model
stringRequired
مدل مورد استفاده برای تولید ویدیو. مقدار این پارامتر باید `google/veo-3.0-fast` باشد.
مقادیر مجاز (کلیک برای کپی):
prompt
stringRequired
توضیحات متنی صحنه، موضوع یا عملی که می‌خواهید در ویدیو تولید شود.
aspect_ratio
string
نسبت تصویر ویدیوی تولید شده.
مقادیر مجاز (کلیک برای کپی):
resolution
string
رزولوشن ویدیوی تولید شده. مقدار پیش‌فرض `720P` است.
مقادیر مجاز (کلیک برای کپی):
duration
integer
طول ویدیوی خروجی بر حسب ثانیه.
مقادیر مجاز (کلیک برای کپی):
negative_prompt
string
توضیحات عناصری که باید از نمایش در ویدیوی تولید شده اجتناب شود.
seed
integer
تغییر مقدار seed یک راه برای دریافت نتایج مختلف برای پارامترهای درخواست یکسان است. استفاده از مقدار یکسان برای یک درخواست مشابه، نتایج مشابهی تولید می‌کند. اگر مشخص نشود، یک عدد تصادفی انتخاب می‌شود.
enhance_prompt
boolean
تعیین اینکه آیا تولید ویدیو بهبود یابد یا خیر. مقدار پیش‌فرض `true` است.
generate_audio
boolean
تعیین اینکه آیا صدا برای ویدیو تولید شود یا خیر. مقدار پیش‌فرض `true` است.

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

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

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

import requests
import time

# Insert your AI-KAR API Key instead of <YOUR_AI-KARAPI_KEY>:
AI-KARapi_key = "<YOUR_AI-KARAPI_KEY>"
base_url = "https://api.ai-kar.com/v1"

# Creating and sending a video generation task to the server
def generate_video():
    url = f"{base_url}/generate/video/google/generation"
    headers = {
        "Authorization": f"Bearer {AI-KARapi_key}",
    }
    data = {
        "model": "google/veo-3.0-fast",
        "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.
'''
    }
    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()
        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}/generate/video/google/generation"
    params = {
        "generation_id": gen_id,
    }
    headers = {
        "Authorization": f"Bearer {AI-KARapi_key}",
        "Content-Type": "application/json"
    }
    response = requests.get(url, params=params, headers=headers)
    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 = 1000
        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
    }
  }
}