Model populer
Generasi image-to-video menggabungkan gambar input Anda dengan generasi gerakan. Output mempertahankan konsistensi visual dengan gambar sumber Anda sambil menambahkan gerakan yang realistis.
Langkah 1: Siapkan gambar Anda
Pertama, Anda perlu menyediakan gambar sumber. Anda dapat mengunggah berkas, mereferensikan URL, atau menyediakan 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";
Langkah 2: Hasilkan video
Buat permintaan POST ke /generate/video/kling/kling-2.5 dengan gambar dan parameter gerakan Anda.
// 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}`);
Ganti dengan API Token AndaUntuk mengganti placeholder YOUR_API_TOKEN pada contoh di atas, Anda perlu membuat API token di krea.ai/settings/api-tokens. Ikuti instruksi pada halaman API Keys & Billing jika Anda memerlukan bantuan.
Contoh respons
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"created_at": "2025-01-15T10:30:00.000Z",
"estimated_time": "60-120 seconds"
}
Langkah 3: Polling untuk hasil
Lakukan polling pada /jobs/{job_id} setiap 5 detik untuk memeriksa kemajuan generasi video.
// 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}`);
Contoh respons selesai
{
"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 tersedia!Atur webhook untuk menerima notifikasi ketika job selesai. Lihat Panduan Webhooks untuk memulai.
Parameter umum
Untuk daftar parameter detail untuk semua model, lihat halaman Model APIs.
| Parameter | Tipe | Deskripsi |
|---|
start_image | string | URL gambar sumber |
prompt | string | Deskripsi gerakan dan pergerakan kamera yang diinginkan |
duration | number | Panjang video dalam detik. Nilai yang didukung bergantung pada model. |
aspect_ratio | string | Rasio aspek video, seperti 16:9, 9:16, atau 1:1 |
end_image | string | URL frame akhir opsional untuk model yang didukung |
mode | string | Mode kualitas opsional untuk model yang menyediakannya |
Tips prompt gerakan:
- Deskripsikan pergerakan kamera (pan, zoom, dolly, tilt)
- Tentukan arah dan kecepatan gerakan
- Sebutkan efek kedalaman dan paralaks
- Gunakan bahasa kamera yang terkendali untuk animasi yang halus
- Gunakan kata kerja aksi yang lebih kuat untuk efek yang dramatis