Skip to main content

​
热门模型

视频生成通常比图像生成耗时更长。请根据视频时长和质量设置准备较长的处理时间。

​
步骤 1：生成视频

向 /generate/video/kling/kling-2.5 发送 POST 请求，附带你的提示词和视频参数。API 会立即返回一个 job ID。 
// 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}`);
替换为你的 API Token要替换上述示例中的 YOUR_API_TOKEN 占位符，你需要在 krea.ai/settings/api-tokens 生成一个 API token。如果需要帮助，请参考 API Keys & Billing 页面上的说明。
示例响应 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_time": "60-120 seconds"
}

​
步骤 2：轮询结果

视频生成比图像生成耗时更长。每 5 秒轮询一次 /jobs/{job_id} 以检查进度。
Webhook 可用！设置 webhook，可在任务完成时收到通知。参见 Webhooks 指南 开始使用。
// 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"]
  }
}
Webhook 可用！设置 webhook，可在任务完成时收到通知。参见 Webhooks 指南 开始使用。

​
常用参数

要查看所有模型的详细参数列表，请访问 Model APIs 页面。
参数类型说明
promptstring视频内容的详细描述
durationnumber视频时长（秒）。可选值取决于具体模型。
aspect_ratiostring视频宽高比，例如 16:9、9:16 或 1:1
start_imagestring可选，图像生成视频模型的源图像 URL
end_imagestring可选，支持的模型的结束帧 URL
modestring可选，部分模型公开的质量模式
modelstring要使用的视频生成模型
获得更好视频的提示词技巧：
  • 具体描述运动和相机运动
  • 描述场景、光照和氛围
  • 提及时间感（例如”缓慢平移”、“快速拉近”）
  • 加入风格参考（例如”电影感”、“纪录片风格”）
视频生成的费用比图像生成更高。请查看 API Keys & Billing，了解各模型定价和如何为 API 余额充值。