인기 모델
이미지 투 비디오 생성은 입력 이미지와 모션 생성을 결합합니다. 출력은 원본 이미지와의 시각적 일관성을 유지하면서 사실적인 움직임을 더합니다.
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}`);
{
"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"]
}
}
웹훅을 사용할 수 있습니다!작업이 완료되면 알림을 받도록 웹훅을 설정하세요. 시작하려면 웹훅 가이드를 참조하세요.
공통 매개변수
모든 모델의 상세 매개변수 목록은 모델 API 페이지를 참조하세요. | 매개변수 | 타입 | 설명 |
|---|
start_image | string | 원본 이미지의 URL |
prompt | string | 원하는 움직임과 카메라 워크에 대한 설명 |
duration | number | 비디오 길이(초). 지원되는 값은 모델에 따라 다릅니다. |
aspect_ratio | string | 비디오 화면 비율(예: 16:9, 9:16, 1:1) |
end_image | string | 지원 모델용 종료 프레임 URL(선택 사항) |
mode | string | 지원 모델용 품질 모드(선택 사항) |
모션 프롬프트 팁:
- 카메라 움직임(팬, 줌, 돌리, 틸트)을 설명하세요
- 움직임의 방향과 속도를 지정하세요
- 깊이감과 시차 효과를 언급하세요
- 미세한 애니메이션에는 절제된 카메라 표현을 사용하세요
- 극적인 효과에는 강한 동작 동사를 사용하세요
