fal-text-to-video について
fal-text-to-videoは、fal.aiのモデルでテキストから動画を生成するためのリファレンススキルです。モデル選びや動きを表すプロンプトの作成に加え、対応モデルの長さ、画角、解像度、音声設定を案内します。
主な機能
- 01複数のfal.ai動画モデルを紹介
- 02速度と品質に応じたモデル選択
- 03動きやカメラのプロンプト構成
- 04長さとアスペクト比の設定
- 05対応モデルの音声オプション
活用シーン
- 01テキスト説明から動画を生成
- 02プレビューや完成版向けのモデル選択
- 03音声付きの縦長・横長動画を作成
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ josiahsiegel/ claude-plugin-marketplace --skill fal-text-to-videoインストール後、Claude Code で/fal-text-to-videoを入力して読み込まれたか確認します。
同梱ファイルreferences/workflow-examples.md
詳細
クイックリファレンス
| モデル | エンドポイント | 長さ | 音声 | 速度 |
|---|---|---|---|---|
| Kling 2.6 Pro | fal-ai/kling-video/v2.6/pro/text-to-video | 5-10s | はい | 遅い |
| Sora 2 | fal-ai/sora | 5-20s | 任意 | 遅い |
| LTX-2 Pro | fal-ai/ltx-2-pro | 5s | はい | 中程度 |
| Runway Turbo | fal-ai/runway-gen3/turbo/text-to-video | 5-10s | いいえ | 速い |
| Luma | fal-ai/luma-dream-machine | 5s | いいえ | 中程度 |
| アスペクト比 | 値 | 用途 |
|---|---|---|
| 横向き | "16:9" | 標準的な動画 |
| 縦向き | "9:16" | ソーシャルメディア/モバイル |
| 正方形 | "1:1" | ソーシャルメディアの投稿 |
| プロンプトの構成 | 例 |
|---|---|
| 被写体+動作 | "A woman walks" |
| +設定 | "through a forest" |
| +スタイル | "cinematic lighting" |
| +カメラ | "tracking shot" |
このスキルを使う場面
テキストから動画を生成する場合に使います:
- テキストの説明から動画を作成する
- 品質/速度の段階に応じてモデルを選ぶ
- 動きを重視したプロンプトを作成する
- ネイティブ音声付きの動画を生成する
- プレビューのワークフロー(高速)→最終版(高品質)
関連スキル:
- 画像から動画を生成する場合:
fal-image-to-videoを参照 - 動画を編集する場合:
fal-video-to-videoを参照 - モデルを比較する場合:
fal-model-guideを参照
fal.ai テキストから動画を生成するモデル
fal.aiで利用できる、テキストから動画を生成するすべてのモデルの完全なリファレンスです。
Kling Video モデル
Kling 2.0 Standard
エンドポイント: fal-ai/kling-video/v2.0/text-to-video
最適な用途: 高品質かつコスト効率に優れた動画
import { fal } from "@fal-ai/client";
const result = await fal.subscribe("fal-ai/kling-video/v2.0/text-to-video", {
input: {
prompt: "A majestic eagle soaring over snow-capped mountains at golden hour, cinematic lighting",
duration: "5", // "5" or "10" seconds
aspect_ratio: "16:9",
negative_prompt: "blurry, distorted, low quality"
}
});
console.log(result.video.url);
import fal_client
result = fal_client.subscribe(
"fal-ai/kling-video/v2.0/text-to-video",
arguments={
"prompt": "A majestic eagle soaring over mountains",
"duration": "5",
"aspect_ratio": "16:9",
"negative_prompt": "blurry, distorted"
}
)
print(result["video"]["url"])
Kling 2.5 Pro
エンドポイント: fal-ai/kling-video/v2.5/pro/text-to-video
最適な用途: プロ品質の動画
const result = await fal.subscribe("fal-ai/kling-video/v2.5/pro/text-to-video", {
input: {
prompt: "A luxury car driving through a mountain road, drone shot, cinematic",
duration: "5",
aspect_ratio: "16:9",
negative_prompt: "shaky, amateur, blurry"
}
});
Kling 2.6 Pro(最新)
エンドポイント: fal-ai/kling-video/v2.6/pro/text-to-video
最適な用途: ネイティブ音声生成に対応した最高品質
音声生成機能を内蔵した最新のKlingモデルです。
const result = await fal.subscribe("fal-ai/kling-video/v2.6/pro/text-to-video", {
input: {
prompt: "Ocean waves crashing on rocky cliffs at sunset, seagulls flying, ambient sounds",
duration: "5",
aspect_ratio: "16:9",
negative_prompt: "static, boring, low quality"
}
});
console.log(result.video.url);
console.log(result.audio?.url); // Native audio included
Klingのパラメーター:
| パラメーター | 型 | 値 | 説明 |
|---|---|---|---|
prompt | string | - | 動画の説明 |
duration | string | "5", "10" | 秒単位の長さ |
aspect_ratio | string | "16:9", "9:16", "1:1" | 動画の寸法 |
negative_prompt | string | - | 避ける内容 |
Sora 2
Sora(OpenAI)
エンドポイント: fal-ai/sora
最適な用途: 高度でクリエイティブな動画生成
const result = await fal.subscribe("fal-ai/sora", {
input: {
prompt: "A stylish woman walks down a Tokyo street filled with warm glowing neon and animated city signage. She wears a black leather jacket, a long red dress, and black boots. She carries a black purse. She wears sunglasses and red lipstick. She walks confidently. The street is damp and reflective, creating a mirror effect of the colorful lights.",
duration: 10,
aspect_ratio: "16:9",
resolution: "1080p"
}
});
console.log(result.video.url);
Soraのパラメーター:
| パラメーター | 型 | 値 | 説明 |
|---|---|---|---|
prompt | string | - | 動画の詳細な説明 |
duration | number | 5-20 | 秒単位の長さ |
aspect_ratio | string | "16:9", "9:16", "1:1" | 動画の寸法 |
resolution | string | "720p", "1080p" | 出力解像度 |
LTX Video モデル
LTX Video(オリジナル)
エンドポイント: fal-ai/ltx-video
最適な用途: 高速で効率的な生成
const result = await fal.subscribe("fal-ai/ltx-video", {
input: {
prompt: "A beautiful sunset over the ocean with gentle waves",
negative_prompt: "low quality, blurry, distorted",
num_inference_steps: 30,
guidance_scale: 7.5,
aspect_ratio: "16:9"
}
});
LTX Video v2
エンドポイント: fal-ai/ltx-video/v2
最適な用途: v1より品質が向上
const result = await fal.subscribe("fal-ai/ltx-video/v2", {
input: {
prompt: "A futuristic city with flying cars and neon lights",
negative_prompt: "ugly, distorted",
num_inference_steps: 35,
guidance_scale: 7.0,
resolution: "720p"
}
});
LTX-2 Pro
エンドポイント: fal-ai/ltx-2-pro
最適な用途: 音声に対応した高忠実度の生成
const result = await fal.subscribe("fal-ai/ltx-2-pro", {
input: {
prompt: "A jazz band performing in a dimly lit club, smooth music, intimate atmosphere",
negative_prompt: "worst quality, inconsistent motion, blurry",
num_inference_steps: 30,
guidance_scale: 3.5,
resolution: "720p",
enable_audio: true // Generate matching audio
}
});
console.log(result.video.url);
console.log(result.audio?.url); // Audio track if enabled
LTXのパラメーター:
| パラメーター | 型 | デフォルト | 説明 |
|---|---|---|---|
prompt | string | - | 動画の説明 |
negative_prompt | string | - | 避ける内容 |
num_inference_steps | number | 30 | 品質を調整するステップ数 |
guidance_scale | number | 7.5 | プロンプトへの忠実度 |
resolution | string | "720p" | "720p"または"480p" |
aspect_ratio | string | "16:9" | 動画の寸法 |
enable_audio | boolean | false | 音声を生成する(LTX-2 Pro) |
Wan Video
Wan v2.1 1.3B
エンドポイント: fal-ai/wan/v2.1/1.3b/text-to-video
最適な用途: 軽量で高速な生成
const result = await fal.subscribe("fal-ai/wan/v2.1/1.3b/text-to-video", {
input: {
prompt: "A cat playing with a ball of yarn, cute, playful",
num_frames: 81, // Number of frames
resolution: "480p"
}
});
Wan v2.1 14B
エンドポイント: fal-ai/wan/v2.1/14b/text-to-video
最適な用途: 大規模モデルによる高品質な生成
const result = await fal.subscribe("fal-ai/wan/v2.1/14b/text-to-video", {
input: {
prompt: "A professional chef preparing sushi, precise movements, high-end restaurant",
num_frames: 81,
resolution: "720p"
}
});
MiniMax Video
MiniMax Text-to-Video
エンドポイント: fal-ai/minimax-video/text-to-video
最適な用途: 品質と速度のバランス
const result = await fal.subscribe("fal-ai/minimax-video/text-to-video", {
input: {
prompt: "A butterfly emerging from a cocoon, macro shot, nature documentary style",
prompt_optimizer: true // Enhance prompt automatically
}
});
MiniMax のパラメーター:
| パラメーター | 型 | 説明 |
|---|---|---|
prompt | string | 動画の説明 |
prompt_optimizer | boolean | プロンプトを自動で改善 |
Runway Gen-3
Runway Gen-3 Turbo
エンドポイント: fal-ai/runway-gen3/turbo/text-to-video
最適な用途: 高速な反復、プレビュー
const result = await fal.subscribe("fal-ai/runway-gen3/turbo/text-to-video", {
input: {
prompt: "A dancer performing ballet in an empty theater, spotlight, graceful movements",
duration: 5,
ratio: "16:9"
}
});
Runway のパラメーター:
| パラメーター | 型 | 値 | 説明 |
|---|---|---|---|
prompt | string | - | 動画の説明 |
duration | number | 5, 10 | 秒 |
ratio | string | "16:9", "9:16", "1:1" | アスペクト比 |
Luma Dream Machine
Luma Text-to-Video
エンドポイント: fal-ai/luma-dream-machine
最適な用途: 創造的、芸術的な動画
const result = await fal.subscribe("fal-ai/luma-dream-machine", {
input: {
prompt: "A magical forest with glowing mushrooms and fireflies at night",
aspect_ratio: "16:9",
loop: false
}
});
Luma のパラメーター:
| パラメーター | 型 | 説明 |
|---|---|---|
prompt | string | 動画の説明 |
aspect_ratio | string | "16:9", "9:16", "1:1" |
loop | boolean | ループ動画を作成 |
CogVideoX
CogVideoX Text-to-Video
エンドポイント: fal-ai/cogvideox
最適な用途: オープンソースの代替モデル
const result = await fal.subscribe("fal-ai/cogvideox", {
input: {
prompt: "A timelapse of a flower blooming, from bud to full bloom",
num_inference_steps: 50,
guidance_scale: 6.0
}
});
CogVideoX-5B
エンドポイント: fal-ai/cogvideox-5b
最適な用途: より高品質なオープンソースモデル
const result = await fal.subscribe("fal-ai/cogvideox-5b", {
input: {
prompt: "An astronaut floating in space with Earth in the background",
num_inference_steps: 50,
guidance_scale: 6.0,
num_frames: 49
}
});
HunyuanVideo
Hunyuan Video
エンドポイント: fal-ai/hunyuan-video
最適な用途: 中国語モデル、高品質
const result = await fal.subscribe("fal-ai/hunyuan-video", {
input: {
prompt: "A traditional Chinese dragon dance during festival celebration",
num_inference_steps: 50,
guidance_scale: 6.0
}
});
モデルの比較
品質ランキング
| ティア | モデル | 品質 | 速度 | コスト |
|---|---|---|---|---|
| プレミアム | Kling 2.6 Pro, Sora 2 | 最高 | 遅い | $$$ |
| プロフェッショナル | Kling 2.5 Pro, LTX-2 Pro | 高い | 中程度 | $$ |
| 標準 | Kling 2.0, Runway Turbo | 良好 | 速い | $ |
| 低価格 | LTX v1, CogVideoX | 許容範囲 | 速い | $ |
機能の比較
| モデル | 音声 | 長さ | 解像度 | 最適な用途 |
|---|---|---|---|---|
| Kling 2.6 Pro | ネイティブ | 5-10s | 1080p | 映画風 |
| Sora 2 | オプション | 5-20s | 1080p | 創造的な動画 |
| LTX-2 Pro | あり | 5s | 720p | 高品質な高速生成 |
| Runway Turbo | なし | 5-10s | 720p | 反復 |
| MiniMax | なし | 6s | 720p | バランス重視 |
| Luma | なし | 5s | 720p | 芸術的な動画 |
速度の比較(概算)
| モデル | 生成時間の目安(5s の動画) |
|---|---|
| Runway Gen-3 Turbo | 30-60s |
| LTX Video | 45-90s |
| MiniMax | 60-120s |
| Kling 2.5 Pro | 120-180s |
| Kling 2.6 Pro | 150-240s |
| Sora 2 | 180-300s |
動画向けプロンプトエンジニアリング
プロンプトの構成
[Subject] + [Action] + [Setting] + [Style] + [Camera/Technical]
例:
// Good: Specific, action-oriented
"A golden retriever running through autumn leaves in a forest, slow motion, cinematic, warm lighting, tracking shot"
// Bad: Vague, static
"A dog in a forest"
動きに関するキーワード
| キーワード | 効果 |
|---|---|
| "walking", "running", "jumping" | 被写体の動き |
| "slow motion", "timelapse" | 速度の変更 |
| "tracking shot", "pan", "zoom" | カメラの動き |
| "floating", "flying", "falling" | 空間内の動き |
| "dancing", "spinning", "waving" | リズミカルな動き |
スタイルに関するキーワード
| キーワード | 効果 |
|---|---|
| "cinematic" | 映画のような品質 |
| "documentary" | リアルなスタイル |
| "anime" | アニメーションスタイル |
| "noir" | 暗く、コントラストの強い映像 |
| "vibrant" | 彩度の高い色彩 |
カメラワーク
| 用語 | 説明 |
|---|---|
| "tracking shot" | カメラが被写体を追う |
| "pan left/right" | カメラを水平方向に動かす |
| "tilt up/down" | カメラを垂直方向に動かす |
| "zoom in/out" | 焦点距離を変更 |
| "drone shot" | 空撮視点 |
| "POV shot" | 一人称視点 |
| "dolly shot" | カメラがレール上を移動 |
パラメーターの完全なリファレンス
interface TextToVideoInput {
// Required
prompt: string;
// Duration (varies by model)
duration?: number | string; // seconds
// Dimensions
aspect_ratio?: "16:9" | "9:16" | "1:1" | "4:3" | "21:9";
resolution?: "480p" | "720p" | "1080p";
// Quality control
negative_prompt?: string;
num_inference_steps?: number;
guidance_scale?: number;
// Reproducibility
seed?: number;
// Model-specific
prompt_optimizer?: boolean; // MiniMax
enable_audio?: boolean; // LTX-2 Pro, Kling 2.6
loop?: boolean; // Luma
num_frames?: number; // Wan, CogVideoX
}
ワークフローの例
Runway Turbo での高速なプレビュー反復や Kling Pro での最終レンダリングなど、fal.ai のテキストから動画を生成するモデルの本番ワークフローとバッチ生成の例は、references/workflow-examples.md にあります。モデル選択のガイダンスを実行可能な生成コードに落とし込む際は、このリファレンスを読み込んでください。
ベストプラクティス
run()ではなくsubscribe()を使用する - 動画生成には時間がかかります- まずプレビューから始める - プロンプトを調整するには、より高速なモデルを使用します
- 動きについて具体的に記述する - 何がどのように動くかを説明します
- カメラの向きを含める - 視覚的な視点を指定します
- ネガティブプロンプトを使用する - よくあるアーティファクトを避けます
- 用途に合ったモデルを選ぶ - テストにプレミアムモデルは使用しません
- 音声キーワードを含める - 音声生成に対応したモデルの場合