Pular para o conteúdo principal

​
Modelos populares

A geração de imagem para vídeo combina a sua imagem de entrada com geração de movimento. O resultado mantém consistência visual com a imagem de origem enquanto adiciona movimento realista.

​
Etapa 1: prepare sua imagem

Primeiro, você precisa fornecer a imagem de origem. Você pode enviar um arquivo, referenciar uma URL ou fornecer um data URI em 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";

​
Etapa 2: gere o vídeo

Faça uma requisição POST para /generate/video/kling/kling-2.5 com sua imagem e parâmetros de movimento. 
// 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}`);
Substitua pelo seu token de APIPara substituir o placeholder YOUR_API_TOKEN nos exemplos acima, você precisará gerar um token de API em krea.ai/settings/api-tokens. Siga as instruções da página Chaves de API e cobrança caso precise de ajuda.
Exemplo de resposta 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_time": "60-120 seconds"
}

​
Etapa 3: faça polling pelos resultados

Faça polling em /jobs/{job_id} a cada 5 segundos para acompanhar o progresso da geração do vídeo. 
// 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}`);
Exemplo de resposta concluída 
{
  "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 disponíveis!Configure webhooks para receber notificações quando os jobs forem concluídos. Veja o guia de Webhooks para começar.

​
Parâmetros comuns

Para uma lista de parâmetros detalhados de todos os modelos, veja a página APIs de modelos.
ParâmetroTipoDescrição
start_imagestringURL da imagem de origem
promptstringDescrição do movimento e da movimentação de câmera desejados
durationnumberDuração do vídeo em segundos. Os valores aceitos dependem do modelo.
aspect_ratiostringProporção do vídeo, como 16:9, 9:16 ou 1:1
end_imagestringURL opcional do frame final para modelos compatíveis
modestringModo de qualidade opcional para modelos que oferecem essa opção
Dicas para prompts de movimento:
  • Descreva a movimentação de câmera (pan, zoom, dolly, tilt)
  • Especifique a direção e a velocidade do movimento
  • Mencione efeitos de profundidade e parallax
  • Use uma linguagem de câmera contida para animações sutis
  • Use verbos de ação mais fortes para efeitos dramáticos