はじめに
LTX 2.5 画像から動画 は、あなたが用意した開始フレームを 5〜20 秒（整数秒）動かし、720p / 1080p / 2K / 4K で出力します。必須は image_url と prompt で、last_image_url を加えると任意の終了フレームを指定できます。duration_seconds、resolution、seed はテキストから動画と同じように働きます。aspect_ratio フィールドはありません。開始フレームが被写体と構図を決め、出力の形も決めます。クリップには生成されたサウンドトラックが付き、タスクは非同期で実行されます。使用する権限のある画像だけをアップロードしてください。出力の使い方についてはご自身の責任となります。
開始素材に応じてモードを選ぶ
| 開始素材 | モード |
|---|---|
| 書いたブリーフから、場面、行動、カメラ、必要に応じて音を組み立てます。 | LTX 2.5 テキストから動画 |
| 承認済みの開始画像が被写体と構図を決め、指示文がその後の動きを導きます。 | LTX 2.5 画像から動画 |
主な機能とハイライト
開始フレームに忠実に従います
人物、衣装、セット、光は image_url から取られ、そのフレームに忠実に従います。文字どおりの結果を得る確実な方法で、露出のある開始フレームも和らげられずにそのまま返ってきます。見た目はすでに画像が担っているので、prompt ではその後に変わることだけを書けば十分です。
ショットの着地点を決める任意のフレーム
last_image_url は最後の構図を固定し、image_url と一緒に送る場合にのみ有効です。制約されるのは終わりであって、そこまでの道筋ではありません。2 枚のあいだの動きは引き続き生成されるため、長いクリップでは中盤が大きく逸れることがあります。光や衣装が食い違う 2 枚を渡すと、両者のあいだで折り合いをつけようとする様子が画面に表れるので、連続した 1 組として用意してください。
尺、解像度、音はテキストのエンドポイントと共通です
duration_seconds は 5〜20 の整数秒で、クリップが長いほど指定した終了フレームから離れやすくなります。resolution は 720p（既定）、1080p、2k（幅およそ 2560 px）、4k から選べます。出力には生成された音声トラックが含まれ、無効にするフィールドはありません。自前のミックスが必要なら、編集でミュートするか差し替える前提で進めてください。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | 必須です。フレームのあとに変わるもの——動作、カメラ、光——を書いてください。 1 文字以上 |
image_url | はい | 開始フレームです。被写体と構図を固定し、出力の形も決めます。 |
last_image_url | いいえ | 任意の終了フレームで、 |
resolution | いいえ | 720p、1080p、2k、4k から選びます。2k は横幅およそ 2560 px で返ります。 |
duration_seconds | いいえ | 5〜20 の整数秒。長いクリップほど、渡した終了フレームから遠くへ彷徨います。 |
seed | いいえ | 解像度を上げるときは固定して、変わった変数が 1 つだけになるようにしてください。 |
料金
| 仕様 | 料金 |
|---|---|
| $0.09 / 秒 |
| $0.13 / 秒 |
| $0.19 / 秒 |
| $0.30 / 秒 |
ユースケース
承認済みの 2 枚で時間帯を移り変わらせる
beach-to-bonfire の例では、image_url が夕暮れの浜辺にいるカップル、last_image_url が夜に焚き火のそばで 1 枚の毛布にくるまる同じ 2 人を写しています。リクエストは 1080p で 10 秒、prompt は行き先ではなく道のり、つまり日が沈み焚き火の明かりが取って代わる過程を描いています。終わりを固定しておけば、モデルは中盤を自由に作りながらも、承認済みのフレームを越えて逸れることがありません。
編集のための絵コンテからコンテへのショット
ショットをある絵コンテのコマで始め、別のコマで終える必要があるときは、両方を image_url と last_image_url として送ります。出ていく構図が次のカットとつながるので、生成したクリップを単独の作品としてだけでなく、タイムラインの中で使えるようになります。
仕上がった静止画に動きを加える
candlelit-tub のフレームにはすでにろうそく、ほうろう、濡れたエメラルドのシルクが写っているため、prompt は変化だけを書いています。湯に沈み、濡れた髪に両手を通し、カメラに向かって目を開ける、という流れです。一方 deco-pool-backfall の例は物理的な一瞬で、後ろ向きに水へ倒れ込み、泡が昇り、コースティクスが柱を這い、カメラも一緒に沈んでいきます。
プロンプトガイドと実践のヒント
すでにあるものではなく、変わることを書く
開始フレームに見えているものはすべて画像が決めます。prompt は、誰が、どの方向へ、どんな速さで動くかに使い、続いてカメラと光の変化を書いてください。candlelit-tub の prompt は最初の動作（「She pushes up off the rim of the tub」）から始まり、「Slow drift-in, warm candle light only」で終わります。
終了フレームを送るときは着地点を言葉にする
last_image_url を使う場合は、ショットが渡した最終フレームで終わることを prompt に書き、途中で起きることを説明します。焚き火のブリーフはまさにそうしており、「Begin on the two of them on the beach at sunset and end on the supplied final frame」と書いています。書き始める前に、2 枚のあいだで被写体、衣装、光をそろえておいてください。
移動の距離に合わせて尺を決める
動作が 1 つだけの例は 5 秒、夕暮れから夜への移り変わりは 10 秒を使っています。まず短いクリップで始め、出力全体を通して被写体、輪郭、光、カメラの連続性を確認してから尺を伸ばしてください。プールの例のような水のショットは 1 コマずつ確認しましょう。静止画を動かすとき、最も破綻しやすいのが水だからです。
音を演出し、seed を固定する
音声は必ず生成されるので、音も prompt に書き込みます。プールのブリーフは「no music, only muffled underwater tone」と指定しています。動きが決まったら seed と prompt をそのままにして、resolution だけを上げてください。seed は実行どうしを比較可能にするもので、フレーム単位で同一にするものではないため、最終レンダーはフル解像度であらためて確認してください。
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "lightricks/ltx-2.5/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
