Video Modelskling-ai

معرفی و مستندات مدل هوش مصنوعی v1.6-pro-effects

مستندات مدل v1.6-pro-effects از kling-ai، ارائه شده توسط ای ای کار (AI-KAR)

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

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

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

مدل v1.6-pro-effects از kling-ai یک مدل تخصصی تولید ویدیو است که کلیپ‌های کوتاهی را بر اساس تصاویر مرجع افراد تولید می‌کند. این مدل قادر است یکی از چندین سناریوی از پیش تعیین شده را اعمال کند: دو نفر که یکدیگر را در آغوش می‌گیرند، همدیگر را می‌بوسند، یا با دستان خود شکل قلب را درست می‌کنند (به 2 تصویر مرجع نیاز دارد)، یا یک نفر به طور خنده‌داری مانند خمیر له می‌شود یا مانند یک بادکنک باد می‌شود (به 1 تصویر مرجع نیاز دارد).

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

با این حال، اگر سعی کنید از چنین عکس‌هایی با جلوه‌های hug، kiss یا heart_gesture استفاده کنید، خطایی دریافت خواهید کرد که می‌گوید "Could not detect face in the image".

این مدل با استفاده از API قابل دسترسی است و امکان تولید ویدیوهای خلاقانه و جذاب را فراهم می‌کند. پارامترهای مختلفی برای کنترل نحوه تولید ویدیو وجود دارد، از جمله انتخاب مدل، ارائه تصاویر ورودی، تعیین مدت زمان ویدیو و انتخاب جلوه ویژه. با استفاده از این پارامترها، می‌توانید ویدیوهایی تولید کنید که دقیقاً مطابق با نیازهای شما باشند.

مدل v1.6-pro-effects به طور خاص برای تولید ویدیوهای کوتاه و سرگرم‌کننده طراحی شده است. این مدل برای استفاده در شبکه‌های اجتماعی، تبلیغات و سایر کاربردهایی که نیاز به ویدیوهای جذاب و کوتاه دارند، ایده‌آل است. با استفاده از این مدل، می‌توانید به سرعت و به آسانی ویدیوهایی تولید کنید که توجه مخاطبان را به خود جلب کنند.

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

در ویدیوهایی که یک نفر در آن حضور دارد (جلوه‌های squish و expansion)، یک قطعه صوتی نیز تولید می‌شود - ترکیبی از موسیقی و صداهای تعامل مواد، مانند صدای جیر جیر لاستیک و جلوه‌های مشابه.

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

پارامترنوعتوضیحات و مقادیر
model
stringRequired
نام مدل. باید `klingai/kling-video-v1.6-pro-effects` باشد.
مقادیر مجاز (کلیک برای کپی):
type
string
نوع مدل. مقدار پیش‌فرض `effects` است.
مقادیر مجاز (کلیک برای کپی):
effect_scene
stringRequired
نوع صحنه جلوه ویدیویی. یکی از مقادیر enum را انتخاب کنید.
مقادیر مجاز (کلیک برای کپی):
image_url
string | string[]Required
آدرس URL تصویر یا تصاویر. برای جلوه‌های hug، kiss و heart_gesture، یک آرایه شامل دقیقاً دو آدرس URL تصویر ارسال کنید. برای squish یا expansion، فقط یک آدرس URL تصویر مورد نیاز است.
duration
integer
طول ویدیوی خروجی بر حسب ثانیه.
مقادیر مجاز (کلیک برای کپی):

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

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

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

import requests
import time
base_url = "https://api.ai-kar.com/v1"
api_key = "<YOUR_AI-KARAPI_KEY>"
ref_img_url1 = "https://images.pexels.com/photos/733872/pexels-photo-733872.jpeg"
ref_img_url2 = "https://storage.googleapis.com/falserverless/juggernaut_examples/QEW5VrzccxGva7mPfEXjf.png"
# Creating and sending a video generation task to the server
def generate_video():
    url = f"{base_url}/generate/video/kling/generation"
    headers = {
        "Authorization": f"Bearer {api_key}",
    }
    data = {
        "model": "klingai/kling-video-v1.6-pro-effects",
        "image_url": [ref_img_url1, ref_img_url2],
        "duration": 5,
        "effect_scene": "heart_gesture"
    }
    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/kling/generation"
    params = {
        "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, 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 = 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
    }
  }
}