معرفی و مستندات مدل هوش مصنوعی 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 درخواست ارسال کنید. فرآیند تولید ویدیو شامل دو مرحله است:
- ایجاد و ارسال یک وظیفه تولید ویدیو به سرور (که یک شناسه تولید را برمیگرداند).
- درخواست ویدیو تولید شده از سرور با استفاده از شناسه تولید دریافت شده از مرحله اول.
برای شروع، شما نیاز به یک کلید 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)
{
"id": "60ac7c34-3224-4b14-8e7d-0aa0db708325",
"status": "completed",
"video": {
"url": "#",
"duration": 8
},
"duration": 8,
"error": null,
"meta": {
"usage": {
"tokens_used": 120000
}
}
}