Popüler modeller
Görselden videoya üretim, girdi görselinizi hareket üretimi ile birleştirir. Çıktı, kaynak görselinizle görsel tutarlılığı korurken gerçekçi hareket ekler.
Adım 1: Görselinizi hazırlayın
Önce kaynak görseli sağlamanız gerekir. Bir dosya yükleyebilir, bir URL’ye referans verebilir veya base64 data URI sağlayabilirsiniz.
// 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";
Adım 2: Videoyu üretin
Görseliniz ve hareket parametrelerinizle /generate/video/kling/kling-2.5 adresine bir POST isteği gönderin.
// 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}`);
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"created_at": "2025-01-15T10:30:00.000Z",
"estimated_time": "60-120 seconds"
}
Adım 3: Sonuçları yoklayın
Video üretim ilerlemesini kontrol etmek için /jobs/{job_id} adresini her 5 saniyede bir yoklayın.
// 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"]
}
}
Webhook’lar kullanılabilir!İşler tamamlandığında bildirim almak için webhook’ları ayarlayın. Başlamak için Webhook’lar rehberine bakın.
Yaygın parametreler
Tüm modellerin ayrıntılı parametre listesi için Model API’leri sayfasına bakın. | Parametre | Tür | Açıklama |
|---|
start_image | string | Kaynak görselin URL’si |
prompt | string | İstenen hareketin ve kamera hareketinin açıklaması |
duration | number | Video uzunluğu (saniye). Desteklenen değerler modele göre değişir. |
aspect_ratio | string | Video en-boy oranı; örneğin 16:9, 9:16 veya 1:1 |
end_image | string | Destekleyen modeller için isteğe bağlı bitiş karesinin URL’si |
mode | string | Sunan modeller için isteğe bağlı kalite modu |
Hareket prompt’u ipuçları:
- Kamera hareketini tanımlayın (kaydırma, yakınlaştırma, dolly, eğme)
- Hareket yönünü ve hızını belirtin
- Derinlik ve paralaks etkilerinden bahsedin
- İnce animasyonlar için ölçülü kamera dili kullanın
- Dramatik etkiler için daha güçlü eylem fiilleri kullanın
