Skip to main content
Video generation typically takes longer than image generation. Be prepared for longer processing times depending on video length and quality settings.

​
Step 1: Generate a Video

Make a POST request to /generate/video/kling/kling-2.5 with your prompt and video parameters. The API returns a job ID immediately. 
// 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}`);
Replace with your API TokenTo replace the YOUR_API_TOKEN placeholder in the above examples, you’ll need to generate an API token in krea.ai/settings/api-tokens. Follow the instructions on the API Keys & Billing page if you need help.
Example Response 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_time": "60-120 seconds"
}

​
Step 2: Poll for Results

Video generation takes longer than image generation. Poll /jobs/{job_id} every 5 seconds to check progress.
Webhooks available!Set up webhooks to receive notifications when jobs complete. See the Webhooks guide to get started.
// 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}`);
Example Completed Response 
{
  "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 available!Set up webhooks to receive notifications when jobs complete. See the Webhooks guide to get started.

​
Common Parameters

For a list of detailed parameters for all models, see the Model APIs page.
ParameterTypeDescription
promptstringDetailed description of the video content
durationnumberVideo length in seconds. Supported values depend on the model.
aspect_ratiostringVideo aspect ratio, such as 16:9, 9:16, or 1:1
start_imagestringOptional source image URL for image-to-video models
end_imagestringOptional ending frame URL for supported models
modestringOptional quality mode for models that expose one
modelstringVideo generation model to use
Prompt Tips for Better Videos:
  • Be specific about motion and camera movement
  • Describe the scene, lighting, and atmosphere
  • Mention timing (e.g., “slowly panning”, “quick zoom”)
  • Include style references (e.g., “cinematic”, “documentary style”)
Video generation costs more than image generation. See API Keys & Billing for per-model pricing and how to top up your API balance.