Modelos populares
La generación de imagen a video combina tu imagen de entrada con la generación de movimiento. La salida mantiene la consistencia visual con tu imagen de origen mientras añade movimiento realista.
Paso 1: Prepara tu imagen
Primero, debes proporcionar la imagen de origen. Puedes subir un archivo, referenciar una URL o proporcionar un URI de datos base64.
// 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";
Paso 2: Genera el video
Realiza una solicitud POST a /generate/video/kling/kling-2.5 con tu imagen y parámetros de movimiento.
// 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"
}
Paso 3: Consulta los resultados
Consulta /jobs/{job_id} cada 5 segundos para verificar el progreso de la generación del 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}`);
{
"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"]
}
}
¡Webhooks disponibles!Configura webhooks para recibir notificaciones cuando los trabajos se completen. Consulta la guía de Webhooks para empezar.
Parámetros comunes
Para ver una lista detallada de parámetros de todos los modelos, consulta la página APIs de modelos. | Parámetro | Tipo | Descripción |
|---|
start_image | string | URL de la imagen de origen |
prompt | string | Descripción del movimiento deseado y el movimiento de cámara |
duration | number | Duración del video en segundos. Los valores admitidos dependen del modelo. |
aspect_ratio | string | Relación de aspecto del video, como 16:9, 9:16 o 1:1 |
end_image | string | URL opcional del fotograma final para los modelos compatibles |
mode | string | Modo de calidad opcional para los modelos que lo expongan |
Consejos para el prompt de movimiento:
- Describe el movimiento de cámara (paneo, zoom, dolly, tilt)
- Especifica la dirección y la velocidad del movimiento
- Menciona efectos de profundidad y paralaje
- Usa lenguaje de cámara contenido para animaciones sutiles
- Usa verbos de acción más fuertes para efectos dramáticos
