Modèles populaires
La génération image vers vidéo combine votre image d’entrée avec la génération de mouvement. La sortie conserve la cohérence visuelle avec votre image source tout en ajoutant un mouvement réaliste.
Étape 1 : préparer votre image
Vous devez d’abord fournir l’image source. Vous pouvez soit téléverser un fichier, référencer une URL, soit fournir un data URI 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";
Étape 2 : générer la vidéo
Effectuez une requête POST vers /generate/video/kling/kling-2.5 avec votre image et vos paramètres de mouvement.
// 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}`);
Remplacez par votre jeton d’APIPour remplacer l’espace réservé YOUR_API_TOKEN dans les exemples ci-dessus, vous devez générer un jeton d’API sur krea.ai/settings/api-tokens. Suivez les instructions de la page Clés d’API et facturation si vous avez besoin d’aide. {
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"created_at": "2025-01-15T10:30:00.000Z",
"estimated_time": "60-120 seconds"
}
Étape 3 : interroger les résultats
Interrogez /jobs/{job_id} toutes les 5 secondes pour vérifier la progression de la génération vidéo.
// 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 !Configurez des webhooks pour recevoir des notifications lorsque les tâches sont terminées. Consultez le guide des Webhooks pour commencer.
Paramètres courants
Pour une liste détaillée des paramètres de tous les modèles, consultez la page API des modèles. | Paramètre | Type | Description |
|---|
start_image | string | URL de l’image source |
prompt | string | Description du mouvement souhaité et du mouvement de caméra |
duration | number | Durée de la vidéo en secondes. Les valeurs prises en charge dépendent du modèle. |
aspect_ratio | string | Ratio d’aspect de la vidéo, par exemple 16:9, 9:16 ou 1:1 |
end_image | string | URL facultative de l’image de fin pour les modèles compatibles |
mode | string | Mode de qualité facultatif pour les modèles qui en exposent un |
Conseils pour le prompt de mouvement :
- Décrivez le mouvement de caméra (panoramique, zoom, travelling, inclinaison)
- Précisez la direction et la vitesse du mouvement
- Mentionnez la profondeur et les effets de parallaxe
- Utilisez un langage de caméra retenu pour les animations subtiles
- Utilisez des verbes d’action plus forts pour des effets spectaculaires
