Перейти к основному содержанию

​
Популярные модели

Генерация image-to-video объединяет исходное изображение с генерацией движения. Результат сохраняет визуальную согласованность с исходным изображением, добавляя реалистичное движение.

​
Шаг 1. Подготовьте изображение

Сначала необходимо предоставить исходное изображение. Вы можете загрузить файл, указать URL или передать 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";

​
Шаг 2. Сгенерируйте видео

Отправьте POST-запрос к /generate/video/kling/kling-2.5 с изображением и параметрами движения. 
// 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}`);
Подставьте свой API-токенЧтобы заменить плейсхолдер YOUR_API_TOKEN в приведённых выше примерах, сгенерируйте API-токен на странице krea.ai/settings/api-tokens. Если нужна помощь, следуйте инструкциям на странице API-ключи и биллинг.
Пример ответа 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_time": "60-120 seconds"
}

​
Шаг 3. Опрашивайте результат

Запрашивайте /jobs/{job_id} каждые 5 секунд, чтобы отслеживать прогресс генерации видео. 
// 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"]
  }
}
Доступны вебхуки!Настройте вебхуки, чтобы получать уведомления о завершении заданий. Для начала ознакомьтесь с руководством по вебхукам.

​
Общие параметры

Подробный список параметров для всех моделей смотрите на странице Model APIs.
ПараметрТипОписание
start_imagestringURL исходного изображения
promptstringОписание желаемого движения и движения камеры
durationnumberДлительность видео в секундах. Поддерживаемые значения зависят от модели.
aspect_ratiostringСоотношение сторон видео, например 16:9, 9:16 или 1:1
end_imagestringНеобязательный URL конечного кадра для поддерживаемых моделей
modestringНеобязательный режим качества для моделей, где он доступен
Советы по промптам для движения:
  • Описывайте движение камеры (панорамирование, зум, проезд, наклон).
  • Указывайте направление и скорость движения.
  • Упоминайте эффекты глубины и параллакса.
  • Используйте сдержанные формулировки для тонкой анимации.
  • Используйте более выразительные глаголы действия для драматических эффектов.