Skip to main content

​
Modelos populares

A geração de vídeo geralmente demora mais que a de imagem. Esteja preparado para tempos de processamento maiores, dependendo da duração e das configurações de qualidade do vídeo.

​
Passo 1: Gerar um vídeo

Faça uma requisição POST para /generate/video/kling/kling-2.5 com seu prompt e parâmetros de vídeo. A API retorna um ID de job imediatamente. 
// 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}`);
Substitua pelo seu token de APIPara substituir o placeholder YOUR_API_TOKEN nos exemplos acima, gere um token de API em krea.ai/settings/api-tokens. Siga as instruções da página API Keys & Billing se precisar 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"
}

​
Passo 2: Fazer polling dos resultados

A geração de vídeo demora mais do que a de imagem. Faça polling em /jobs/{job_id} a cada 5 segundos para verificar o progresso.
Webhooks disponíveis!Configure webhooks para receber notificações quando os jobs forem concluídos. Consulte o guia de Webhooks para começar.
// 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. Consulte o guia de Webhooks para começar.

​
Parâmetros comuns

Para uma lista detalhada dos parâmetros de todos os modelos, consulte a página Model APIs.
ParâmetroTipoDescrição
promptstringDescrição detalhada do conteúdo do vídeo
durationnumberDuração do vídeo em segundos. Os valores suportados dependem do modelo.
aspect_ratiostringProporção do vídeo, como 16:9, 9:16 ou 1:1
start_imagestringURL opcional da imagem de origem para modelos de imagem para vídeo
end_imagestringURL opcional do quadro final para modelos compatíveis
modestringModo de qualidade opcional para modelos que o expõem
modelstringModelo de geração de vídeo a ser usado
Dicas de prompt para melhores vídeos:
  • Seja específico sobre o movimento e a movimentação de câmera
  • Descreva a cena, a iluminação e a atmosfera
  • Mencione o ritmo (por exemplo, “panorâmica lenta”, “zoom rápido”)
  • Inclua referências de estilo (por exemplo, “cinematográfico”, “estilo documentário”)
A geração de vídeo custa mais do que a de imagem. Consulte API Keys & Billing para preços por modelo e para saber como adicionar saldo à sua API.