الانتقال إلى المحتوى الرئيسي

نظرة عامة

توفر LemonData إمكانية الوصول إلى أكثر من 69 نموذجاً لإنشاء الفيديو من 11 مزوداً من خلال API موحد واحد. عملية إنشاء الفيديو غير متزامنة (asynchronous) — حيث تقوم بإرسال طلب وتتلقى معرف مهمة task_id، ثم تقوم بالاستعلام عن النتيجة.
يتم تحديث قائمة النماذج بشكل متكرر. للحصول على أحدث النماذج المتاحة والأسعار، قم بزيارة صفحة النماذج أو استخدم Models API.

سير العمل غير المتزامن

import requests
import time

API_KEY = "sk-your-api-key"
BASE = "https://api.lemondata.cc/v1"
headers = {"Authorization": f"Bearer {API_KEY}"}

# Step 1: Submit generation request
resp = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "kling-v2.6-pro",
        "prompt": "A golden retriever running on a beach at sunset, cinematic 4K",
        "duration": 5,
        "aspect_ratio": "16:9"
    }
)
task_id = resp.json()["task_id"]

# Step 2: Poll for result
while True:
    status = requests.get(f"{BASE}/videos/generations/{task_id}", headers=headers).json()
    if status["status"] in ("completed", "succeeded"):
        print(f"Video URL: {status['video_url']}")
        break
    elif status["status"] == "failed":
        print(f"Failed: {status.get('error')}")
        break
    time.sleep(10)

مصفوفة قدرات النماذج

تتفوق النماذج المختلفة في مهام مختلفة. استخدم هذه المصفوفة لاختيار النموذج المناسب لحالة الاستخدام الخاصة بك. مفتاح الرموز: ✅ مدعوم | ❌ غير مدعوم
السلسلةالمزودT2VI2VKeyframeExtensionEditingأقصى مدة
SoraOpenAI~20s
KlingKuaishou10s
VeoGoogle8s
SeedanceByteDance10s
HailuoMiniMax6s
WanAlibaba5s
RunwayRunway10s
LumaLuma5s
ViduVidu8s
GrokxAI~10s
HiggsfieldHiggsfield~5s

تعريفات القدرات

  • T2V (Text-to-Video): إنشاء فيديو من وصف نصي.
  • I2V (Image-to-Video): تحريك صورة ثابتة إلى فيديو باستخدام image_url أو image.
  • Keyframe: التحكم في إطارات البداية والنهاية باستخدام start_image + end_image.
  • Extension: تمديد مدة فيديو موجود.
  • Editing: تعديل جوانب محددة من فيديو موجود.

النماذج المتاحة حسب السلسلة

Sora (OpenAI)

النموذجالجودةملاحظات
sora-2Standardالنموذج الافتراضي، توازن جيد بين الجودة والسرعة
sora-2-proHighجودة أعلى، وقت إنشاء أطول
sora-2-charactersStandardإنشاء يركز على الشخصيات

Kling (Kuaishou)

النموذجالقدرةملاحظات
kling-v2.6-proT2Vأحدث جيل، جودة احترافية
kling-v2.6-stdT2Vأحدث جيل، سريع
kling-v2.5-turbo-proT2Vسرعة فائقة (Turbo)، جودة احترافية
kling-v2.1-masterT2V/I2Vجودة Master
kling-v2.1-proT2V/I2Vجودة احترافية
kling-v2.1-standardT2V/I2Vجودة قياسية
kling-videoT2V/I2Vالنموذج الأساسي
kling-video-extendExtensionتمديد مقاطع الفيديو الموجودة
kling-video-o1-proT2Vاستنتاج O1، جودة احترافية
kling-video-o1-stdT2Vاستنتاج O1، جودة قياسية
kling-effectsEffectsتطبيق تأثيرات بصرية
kling-omni-videoT2Vنموذج Omni
kling-motion-controlT2Vإنشاء مع التحكم في الحركة

Veo (Google)

النموذجالجودةملاحظات
veo3.1Standardأحدث نموذج فيديو من Google
veo3.1-proHighجودة احترافية
veo3.1-4kUltraمخرجات بدقة 4K
veo3.1-fastFastإنشاء أسرع
veo3.1-fast-4kFast + 4Kإنشاء سريع مع مخرجات 4K
veo3.1-componentsStandardإنشاء يعتمد على المكونات
veo3Standardالجيل السابق
veo3-proHighالجيل السابق، احترافي
veo3-fastFastالجيل السابق، سريع

Seedance (ByteDance)

النموذجالقدرةملاحظات
seedance-2-0T2V/I2V/Keyframe/Extension/Editingالأحدث والأكثر قدرة
seedance-1-5-proT2V/I2Vالجيل السابق، جودة احترافية
seedance-1-0-proT2V/I2Vالجيل الأول، احترافي
seedance-1-0-pro-fastT2V/I2Vالجيل الأول، سريع
seedance-1-0-lite-t2vT2Vتحويل النص إلى فيديو خفيف الوزن
seedance-1-0-lite-i2vI2Vتحويل الصورة إلى فيديو خفيف الوزن
يدعم Seedance 2.0 أوسع مجموعة من القدرات بما في ذلك تحويل الوسائط المتعددة إلى فيديو، وتمديد الفيديو، وتحرير الفيديو — كل ذلك من خلال نفس نقطة نهاية API.

Hailuo (MiniMax)

النموذجالجودةملاحظات
hailuo-2.3Standardجودة جيدة
hailuo-2.3-proHighمخرجات بجودة أعلى
hailuo-2.3-fastFastإنشاء أسرع
hailuo-2.3-standardStandardالفئة القياسية
video-01StandardMiniMax video-01
video-01-liveStandardإنشاء بأسلوب البث المباشر

Wan (Alibaba)

النموذجالقدرةملاحظات
wan-2.6T2Vأحدث تحويل للنص إلى فيديو
wan2.6-i2vI2Vأحدث تحويل للصورة إلى فيديو
wan-2.5T2Vالجيل السابق
wan2.5-i2v-previewI2Vالجيل السابق I2V
wan-2.2-plusT2Vجيل أقدم
vace-14bT2Vمعمارية VACE

Runway

النموذجالمدةملاحظات
runwayml-gen4-turbo-55sإنشاء سريع
runwayml-gen4-turbo-1010sمقاطع أطول

Luma

النموذجالقدرةملاحظات
luma-video-apiT2Vتحويل النص إلى فيديو
luma-video-extend-apiExtensionتمديد مقاطع الفيديو الموجودة

Vidu (Shengshu)

النموذجالجودةملاحظات
viduq3-proHighأحدث جيل
viduq2-proHighالجيل السابق، احترافي
viduq2-pro-fastFastالجيل السابق، احترافي سريع
viduq2Standardالجيل السابق، قياسي
viduq2-turboFastسرعة فائقة (Turbo)
vidu2.0Standardالنموذج الأساسي

Grok (xAI)

النموذجملاحظات
grok-video-3نموذج إنشاء الفيديو من xAI
grok-video-3-10sنسخة بمدة 10 ثوانٍ

Higgsfield

النموذجملاحظات
higgsfield-turboالأسرع، تكلفة أقل
higgsfield-standardجودة قياسية
higgsfield-liteخفيف الوزن

أمثلة على الاستخدام

تحويل النص إلى فيديو (T2V)

حالة الاستخدام الأكثر شيوعاً. تدعم جميع النماذج هذه الميزة.
# مثال على تحويل النص إلى فيديو
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "veo3.1-pro",
        "prompt": "Aerial drone shot of a coastal city at golden hour, waves crashing against cliffs",
        "duration": 5,
        "aspect_ratio": "16:9",
        "resolution": "1080p"
    }
)

تحويل الصورة إلى فيديو (I2V)

تحريك صورة ثابتة. استخدم image_url لرابط أو image لبيانات base64.
# استخدام رابط الصورة
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "wan2.6-i2v",
        "prompt": "The person slowly turns and smiles at the camera",
        "image_url": "https://example.com/portrait.jpg"
    }
)

# استخدام صورة base64
import base64
with open("photo.jpg", "rb") as f:
    image_b64 = base64.b64encode(f.read()).decode()

response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "kling-v2.1-master",
        "prompt": "Gentle wind blows through the scene",
        "image": f"data:image/jpeg;base64,{image_b64}"
    }
)

التحكم في الإطارات الرئيسية (صورة البداية + النهاية)

التحكم في كل من الإطارات الأولى والأخيرة لانتقالات دقيقة. مدعوم حالياً بواسطة Seedance 2.0.
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "seedance-2-0",
        "prompt": "Smooth transition from day to night, city lights gradually turning on",
        "start_image": "https://example.com/city-day.jpg",
        "end_image": "https://example.com/city-night.jpg",
        "duration": 5
    }
)

تمديد الفيديو

تمديد مدة فيديو موجود. استخدم النماذج التي تدعم قدرة التمديد.
response = requests.post(f"{BASE}/videos/generations",
    headers=headers,
    json={
        "model": "kling-video-extend",
        "prompt": "Continue the scene naturally",
        "image_url": "https://example.com/last-frame.jpg"
    }
)

مرجع المعلمات

المعلمةالنوعالوصف
modelstringمعرف النموذج (الافتراضي: sora-2)
promptstringمطلوب. وصف نصي للفيديو
image_urlstringرابط صورة البداية (لتحويل I2V)
imagestringصورة مبرمجة بترميز Base64 مع بادئة data URL (لتحويل I2V)
durationintegerمدة الفيديو بالثواني (1-60، يعتمد على النموذج)
aspect_ratiostring16:9, 9:16, 1:1, إلخ.
resolutionstring1080p, 720p, 4k
fpsintegerعدد الإطارات في الثانية (1-120)
negative_promptstringما يجب تجنبه في الإنشاء
seedintegerبذرة عشوائية لإعادة إنتاج النتائج
cfg_scalenumberمقياس التوجيه (0-20)
motion_strengthnumberكثافة الحركة (0-1)
start_imagestringرابط إطار البداية الرئيسي
end_imagestringرابط إطار النهاية الرئيسي
ليست كل المعلمات مدعومة من قبل كل نموذج. يتم تجاهل المعلمات غير المدعومة تلقائياً. تحقق من وثائق النموذج لمعرفة المعلمات المدعومة.

دليل اختيار النموذج

أفضل جودة

Seedance 2.0 أو Kling v2.6 Pro — جودة سينمائية، تفاصيل غنية، وحركة طبيعية.

أسرع إنشاء

Higgsfield Turbo أو Hailuo 2.3 — نتائج سريعة للنماذج الأولية والتكرار.

الأكثر تنوعاً

Seedance 2.0 — يدعم T2V، I2V، الإطارات الرئيسية، التمديد، والتحرير في نموذج واحد.

أفضل قيمة

Wan 2.6 أو Hailuo 2.3 — جودة تنافسية بتكلفة أقل لكل عملية إنشاء.

الفوترة

يستخدم إنشاء الفيديو تسعيراً ثابتاً لكل عملية إنشاء. يتم محاسبتك مرة واحدة عند إرسال المهمة، بغض النظر عن مدة الفيديو. إذا فشلت عملية الإنشاء، يتم استرداد المبلغ تلقائياً. تحقق من الأسعار الحالية في صفحة النماذج أو عبر Pricing API.