Modelos populares
La generación de video suele tardar más que la de imagen. Prepárate para tiempos de procesamiento más largos según la duración y la calidad configuradas.
Paso 1: Generar un video
Realiza una solicitud POST a /generate/video/kling/kling-2.5 con tu prompt y los parámetros de video. La API devuelve un ID de trabajo de inmediato.
// 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}`);
Reemplaza con tu token de APIPara reemplazar el marcador YOUR_API_TOKEN de los ejemplos anteriores, necesitarás generar un token de API en krea.ai/settings/api-tokens. Sigue las instrucciones de la página API Keys & Billing si necesitas ayuda.
Ejemplo de respuesta
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"created_at": "2025-01-15T10:30:00.000Z",
"estimated_time": "60-120 seconds"
}
Paso 2: Consultar los resultados
La generación de video tarda más que la de imagen. Consulta /jobs/{job_id} cada 5 segundos para verificar el progreso.
¡Webhooks disponibles!Configura webhooks para recibir notificaciones cuando los trabajos se completen. Consulta la guía de Webhooks para comenzar.
// 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}`);
Ejemplo de respuesta completada
{
"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 comenzar.
Parámetros comunes
Para ver la lista detallada de parámetros de todos los modelos, consulta la página de Model APIs.
| Parámetro | Tipo | Descripción |
|---|
prompt | string | Descripción detallada del contenido del video |
duration | number | Duración del video en segundos. Los valores admitidos dependen del modelo. |
aspect_ratio | string | Proporción del video, por ejemplo 16:9, 9:16 o 1:1 |
start_image | string | URL opcional de la imagen fuente para modelos de imagen a video |
end_image | string | URL opcional del fotograma final para los modelos que lo admiten |
mode | string | Modo de calidad opcional para los modelos que lo exponen |
model | string | Modelo de generación de video a usar |
Consejos de prompt para mejores videos:
- Sé específico sobre el movimiento y el movimiento de cámara
- Describe la escena, la iluminación y la atmósfera
- Menciona la temporización (por ejemplo, “panorámica lenta”, “zoom rápido”)
- Incluye referencias de estilo (por ejemplo, “cinematográfico”, “estilo documental”)
La generación de video cuesta más que la de imagen. Consulta API Keys & Billing para ver los precios por modelo y cómo recargar el saldo de tu API.