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

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


يجمع التوليد من صورة إلى فيديو بين صورتك المُدخلة وتوليد الحركة. يحافظ الناتج على الاتساق البصري مع الصورة المصدر مع إضافة حركة واقعية.

الخطوة 1: تجهيز صورتك

أولاً، عليك توفير الصورة المصدر. يمكنك إما رفع ملف، أو الإشارة إلى عنوان URL، أو توفير base64 data URI.
// npm install @krea-ai/sdk
import { openAsBlob } from "node:fs";
import { Krea } from "@krea-ai/sdk";

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

// Option 1: Upload a local file and use the hosted asset URL
const file = await openAsBlob("./input-image.jpg", { type: "image/jpeg" });
const asset = await krea.assets.upload(file, {
  description: "Input image",
});
const imageUrl = asset.image_url;

// Option 2: Using image URL
// const imageUrl = "https://example.com/input-image.jpg";

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

أرسل طلب 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", {
  start_image: imageUrl,
  prompt: "gentle camera pan from left to right, subtle depth",
  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"
}

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

استعلم عن /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"]
  }
}
خطافات الويب متاحة!أعدّ خطافات الويب لتلقي إشعارات عند اكتمال المهام. راجع دليل خطافات الويب للبدء.

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

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