Skip to main content

النماذج الشائعة


عادةً ما يستغرق توليد الفيديو وقتًا أطول من توليد الصور. كن مستعدًا لأوقات معالجة أطول اعتمادًا على طول الفيديو وإعدادات الجودة.

الخطوة 1: توليد فيديو

أرسل طلب POST إلى /generate/video/kling/kling-2.5 مع نصك الوصفي ومعلمات الفيديو. تُرجع الواجهة معرّف المهمة فورًا.
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

const job = await krea.video("kling/kling-2.5", {
  prompt: "a majestic eagle soaring over snow-capped mountains at sunrise",
  duration: 5,
  aspect_ratio: "16:9"
});

console.log(`Job ID: ${job.job_id}`);
استبدل بمفتاح API الخاص بكلاستبدال العنصر النائب YOUR_API_TOKEN في الأمثلة السابقة، ستحتاج إلى إنشاء رمز API من krea.ai/settings/api-tokens. اتبع التعليمات في صفحة مفاتيح API والفوترة إذا احتجت إلى مساعدة.
مثال على الاستجابة
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_time": "60-120 seconds"
}

الخطوة 2: الاستعلام عن النتائج

يستغرق توليد الفيديو وقتًا أطول من توليد الصور. استعلم عن /jobs/{job_id} كل 5 ثوانٍ للتحقق من التقدم.
الويب هوك متاح!قم بإعداد الويب هوك لتلقّي إشعارات عند اكتمال المهام. راجع دليل الويب هوك للبدء.
// npm install @krea-ai/sdk
import { Krea } from "@krea-ai/sdk";

const krea = new Krea({ apiKey: process.env.KREA_API_KEY });

async function waitForVideo(jobId) {
  const completed = await krea.jobs.wait(jobId, { intervalMs: 5000 });
  return completed.result.urls[0];
}

const videoUrl = await waitForVideo(job.job_id);
console.log(`Video ready: ${videoUrl}`);
مثال على استجابة مكتملة
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "completed",
  "created_at": "2025-01-15T10:30:00.000Z",
  "completed_at": "2025-01-15T10:31:45.000Z",
  "result": {
    "urls": ["https://gen.krea.ai/videos/your-video.mp4"]
  }
}
الويب هوك متاح!قم بإعداد الويب هوك لتلقّي إشعارات عند اكتمال المهام. راجع دليل الويب هوك للبدء.

المعلمات الشائعة

للاطلاع على قائمة تفصيلية بالمعلمات لجميع النماذج، راجع صفحة واجهات API للنماذج.
المعلمةالنوعالوصف
promptstringوصف تفصيلي لمحتوى الفيديو
durationnumberطول الفيديو بالثواني. تعتمد القيم المدعومة على النموذج.
aspect_ratiostringنسبة عرض الفيديو، مثل 16:9 أو 9:16 أو 1:1
start_imagestringرابط اختياري لصورة المصدر لنماذج تحويل الصورة إلى فيديو
end_imagestringرابط اختياري للإطار النهائي للنماذج المدعومة
modestringوضع جودة اختياري للنماذج التي تُتيحه
modelstringنموذج توليد الفيديو المستخدم
نصائح للنصوص الوصفية للحصول على فيديوهات أفضل:
  • كن محددًا بشأن الحركة وحركة الكاميرا
  • صِف المشهد والإضاءة والأجواء
  • اذكر التوقيت (مثلًا: “بانوراما بطيئة”، “تكبير سريع”)
  • ضمّن مراجع للأسلوب (مثلًا: “سينمائي”، “بأسلوب وثائقي”)
تكلفة توليد الفيديو أعلى من تكلفة توليد الصور. راجع مفاتيح API والفوترة للاطلاع على أسعار كل نموذج وكيفية شحن رصيد API الخاص بك.