mcpField
F
fal-text-to-video

fal-text-to-video

github.com/josiahsiegelクリエイティブ・メディア5980 回インストール19 週間前に更新
リポジトリ

fal-text-to-video について

fal-text-to-videoは、fal.aiのモデルでテキストから動画を生成するためのリファレンススキルです。モデル選びや動きを表すプロンプトの作成に加え、対応モデルの長さ、画角、解像度、音声設定を案内します。

主な機能

  1. 01複数のfal.ai動画モデルを紹介
  2. 02速度と品質に応じたモデル選択
  3. 03動きやカメラのプロンプト構成
  4. 04長さとアスペクト比の設定
  5. 05対応モデルの音声オプション

活用シーン

  1. 01テキスト説明から動画を生成
  2. 02プレビューや完成版向けのモデル選択
  3. 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 Profal-ai/kling-video/v2.6/pro/text-to-video5-10sはい遅い
Sora 2fal-ai/sora5-20s任意遅い
LTX-2 Profal-ai/ltx-2-pro5sはい中程度
Runway Turbofal-ai/runway-gen3/turbo/text-to-video5-10sいいえ速い
Lumafal-ai/luma-dream-machine5sいいえ中程度
アスペクト比値用途
横向き"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のパラメーター:

パラメーター型値説明
promptstring-動画の説明
durationstring"5", "10"秒単位の長さ
aspect_ratiostring"16:9", "9:16", "1:1"動画の寸法
negative_promptstring-避ける内容

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のパラメーター:

パラメーター型値説明
promptstring-動画の詳細な説明
durationnumber5-20秒単位の長さ
aspect_ratiostring"16:9", "9:16", "1:1"動画の寸法
resolutionstring"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のパラメーター:

パラメーター型デフォルト説明
promptstring-動画の説明
negative_promptstring-避ける内容
num_inference_stepsnumber30品質を調整するステップ数
guidance_scalenumber7.5プロンプトへの忠実度
resolutionstring"720p""720p"または"480p"
aspect_ratiostring"16:9"動画の寸法
enable_audiobooleanfalse音声を生成する(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 のパラメーター:

パラメーター型説明
promptstring動画の説明
prompt_optimizerbooleanプロンプトを自動で改善

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 のパラメーター:

パラメーター型値説明
promptstring-動画の説明
durationnumber5, 10秒
ratiostring"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 のパラメーター:

パラメーター型説明
promptstring動画の説明
aspect_ratiostring"16:9", "9:16", "1:1"
loopbooleanループ動画を作成

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-10s1080p映画風
Sora 2オプション5-20s1080p創造的な動画
LTX-2 Proあり5s720p高品質な高速生成
Runway Turboなし5-10s720p反復
MiniMaxなし6s720pバランス重視
Lumaなし5s720p芸術的な動画
速度の比較(概算)
モデル生成時間の目安(5s の動画)
Runway Gen-3 Turbo30-60s
LTX Video45-90s
MiniMax60-120s
Kling 2.5 Pro120-180s
Kling 2.6 Pro150-240s
Sora 2180-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 にあります。モデル選択のガイダンスを実行可能な生成コードに落とし込む際は、このリファレンスを読み込んでください。

ベストプラクティス

  1. run()ではなくsubscribe()を使用する - 動画生成には時間がかかります
  2. まずプレビューから始める - プロンプトを調整するには、より高速なモデルを使用します
  3. 動きについて具体的に記述する - 何がどのように動くかを説明します
  4. カメラの向きを含める - 視覚的な視点を指定します
  5. ネガティブプロンプトを使用する - よくあるアーティファクトを避けます
  6. 用途に合ったモデルを選ぶ - テストにプレミアムモデルは使用しません
  7. 音声キーワードを含める - 音声生成に対応したモデルの場合

コメント