人気のモデル
動画生成は通常、画像生成よりも時間がかかります。動画の長さや品質設定によって処理時間が長くなることがあります。
ステップ 1: 動画を生成する
/generate/video/kling/kling-2.5 にプロンプトと動画パラメータを指定して POST リクエストを送信します。API は即座にジョブ 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}`);
{
"job_id": "550e8400-e29b-41d4-a716-446655440000",
"status": "queued",
"created_at": "2025-01-15T10:30:00.000Z",
"estimated_time": "60-120 seconds"
}
ステップ 2: 結果をポーリングする
動画生成は画像生成よりも時間がかかります。/jobs/{job_id} を 5 秒ごとにポーリングして進捗を確認してください。
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 ガイド をご覧ください。
共通パラメータ
| パラメータ | 型 | 説明 |
|---|
prompt | string | 動画内容の詳細な説明 |
duration | number | 秒単位の動画の長さ。対応値はモデルによって異なります。 |
aspect_ratio | string | 16:9、9:16、1:1 などの動画のアスペクト比 |
start_image | string | 画像から動画のモデル用のオプションのソース画像 URL |
end_image | string | 対応モデル用のオプションの終了フレーム URL |
mode | string | 対応モデル用のオプションの品質モード |
model | string | 使用する動画生成モデル |
より良い動画のためのプロンプトのヒント:
- モーションやカメラの動きを具体的に指定する
- シーン、ライティング、雰囲気を描写する
- タイミングを盛り込む(例: 「ゆっくりパン」「素早くズーム」)
- スタイルリファレンスを含める(例: 「映画的」「ドキュメンタリースタイル」)
