跳转到主要内容

​
热门模型

图生视频会将您输入的图像与运动生成相结合。输出视频在与源图像保持视觉一致性的同时,加入逼真的运动效果。

​
第 1 步:准备您的图像

首先,您需要提供源图像。您可以上传文件、引用 URL,或提供 base64 数据 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 步:生成视频

携带您的图像和运动参数,向 /generate/video/kling/kling-2.5 发起 POST 请求。 
// 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 Token要替换上述示例中的 YOUR_API_TOKEN 占位符,您需要在 krea.ai/settings/api-tokens 生成一个 API token。如需帮助,请参阅 API 密钥与计费页面。
响应示例 
{
  "job_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued",
  "created_at": "2025-01-15T10:30:00.000Z",
  "estimated_time": "60-120 seconds"
}

​
第 3 步:轮询结果

每 5 秒轮询一次 /jobs/{job_id},以检查视频生成进度。 
// 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 指南开始使用。

​
常用参数

如需查看所有模型的详细参数列表,请参阅模型 API 页面。
参数类型描述
start_imagestring源图像的 URL
promptstring期望的运动和镜头移动的描述
durationnumber视频时长(秒)。支持的取值取决于具体模型。
aspect_ratiostring视频宽高比,例如 16:9、9:16 或 1:1
end_imagestring可选的结束帧 URL(仅部分模型支持)
modestring可选的质量模式(仅部分模型提供)
运动提示词技巧:
  • 描述镜头运动(平移、缩放、推拉、俯仰)
  • 指明运动方向与速度
  • 提及景深和视差效果
  • 对细微动画使用克制的镜头语言
  • 对强烈效果使用更有力的动作动词