LTX 2.3 Spicy API

LTX 2.3 Spicy 動画延長は、手元にあるクリップの続きを作ります。video_url にクリップを渡し、続きを誘導したいときはプロンプトを添えてください。クリップの最後のフレームが 3〜20 秒の新しい LTX 2.3 Spicy 画像から動画ショットの開始フレームになり、両者は 1 本の MP4 につながります。元の動画が先、続きが後で、つなぎ目で重複するフレームは取り除かれます。新しい区間も単独のファイルとして返るので、さらに延長したり、部分ごとに編集したりできます。

連続性は最後のフレームから生まれます。衣装、セット、光、人物の立ち位置が引き継がれるのは、新しい区間が文字どおりあなたの最後のフレームから始まるからです。動きは同じようには引き継がれません。モデルが見るのはクリップ全体ではなく静止画 1 枚なので、速さや向きがそのまま続くと考えず、続けたい動きを書いてください。

返るのは 1 本のファイルと、新しい部分の単体です。つないだ MP4 は元のクリップのフレームレートと構図を保ち、黒帯は入りません。つなぎ目を合わせるため、画面の端が数パーセント程度切り取られたり調整されたりすることがあります。モデルが返した映像の縦横比が大きく異なる場合は、新しい区間を画面いっぱいに拡大して中央に合わせ、はみ出した部分を切り取ります。ファイルは H.264 の MP4 と AAC の音声で書き出されます。LTX 2.3 Spicy には音声フィールドがないため、新しい区間は無音か小さな音で返ることがよくあります。元の動画の音は残ります。片方に音がないときは、つないだファイルを無音で埋め、両方に音があるときは、つなぎ目で短いクロスフェードで重ねます。出力の 2 つ目のアセットは新しい区間だけで、次の延長や編集にそのまま使えます。

それ以外はすべて LTX 2.3 Spicy 画像から動画と同じです。新しい区間は画像から動画のエンドポイントと同じルート、同じ内容の許容範囲、同じ秒単価で生成され、生成に失敗したときの返金も同じです。プリセットのフィールドも画像から動画と同じように動きます。生成は成功したのにつなぎ合わせだけができなかった場合も、タスクは失敗となり料金は返金されます。

終わるのが早すぎたショットを伸ばせます。ラベルがカメラを向く前に止まった商品の回転台や、人物がドアに着く前に切れた歩きのカットです。数秒延長して、残りの動きだけを書いてください。

長いシーケンスを一段ずつ組み立てられます。最初のショットを作って延長し、つないだ結果をさらに延長します。どの段も課金されるのは追加した秒数だけです。各段は 1 枚のフレームから始まるので、次を重ねる前につなぎ目を確認してください。

# 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.3-spicy/video-extend",
  "input": {
    "duration_seconds": 5,
    "preset": "tuned",
    "resolution": "480p",
    "video_url": "https://example.com/reference.mp4"
  }
}'

# 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 リファレンスを参照してください。