LTX-2 AI
LTX-2 開発者リファレンス

LTX-2 API ドキュメント

テキストまたは画像から非同期の動画タスクを作成し、返されたタスク ID を動画完成までポーリングします。

ベース URLhttps://ltx-2ai.com
API キーを管理

認証

API キーを Bearer Token として送信します。JSON 本文を送る場合は Content-Type: application/json も指定してください。

HTTP headers
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

動画生成は非同期です。status は 5〜10 秒間隔で確認してください。短い間隔でも完了は早くなりません。

動画タスクを作成

POSThttps://ltx-2ai.com/api/video/ltx-2/generate

LTX-2 タスクを作成し、task_id をすぐに返します。このリファレンスはテキスト・画像からの動画生成を対象にします。

生成モード

テキストから動画

image なしで prompt を送信します。出力比率は aspect_ratio で指定します。

画像から動画

prompt と公開アクセス可能な画像 URL を送信します。出力比率は入力画像で決まります。

パラメータ

名前型必須説明
typestringいいえ任意：text-to-video または image-to-video。image がある場合は image-to-video になります。
promptstringはい動画の説明（3〜2000 文字）。両モードで必須です。
imagestringいいえ公開画像 URL。image-to-video では必須。image_url と imageUrl も利用できます。
resolutionstringいいえ480p、720p、1080p。既定値：720p。
aspect_ratiostringいいえtext-to-video では 16:9 または 9:16。既定値：16:9。
durationintegerいいえ動画の長さは 5〜20 秒。既定値：5。
seedintegerいいえランダムシード。-1 でランダムな結果になります。
publicbooleanいいえタスクを公開ギャラリーに表示できるかどうか。

リクエスト例

cURL
curl --request POST \
  --url https://ltx-2ai.com/api/video/ltx-2/generate \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "type": "image-to-video",
    "prompt": "The subject turns toward the camera and smiles naturally",
    "image": "https://example.com/input.jpg",
    "resolution": "720p",
    "duration": 5,
    "seed": -1
  }'

レスポンス例

200 OK
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n50abc123def456ltx2",
    "status": "IN_PROGRESS",
    "consumed_credits": 24
  }
}

タスク状態を確認

GEThttps://ltx-2ai.com/api/video/ltx-2/status

GET クエリで task_id を送信します。JSON 本文の POST も利用できます。IN_PROGRESS の間は確認を続けます。

パラメータ

名前型必須説明
task_idstringはいgenerate エンドポイントが返すタスク ID。

リクエスト例

cURL
curl --request GET \
  --url 'https://ltx-2ai.com/api/video/ltx-2/status?task_id=n50abc123def456ltx2' \
  --header 'Authorization: Bearer YOUR_API_KEY'

レスポンス例

200 OK
{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "n50abc123def456ltx2",
    "status": "SUCCESS",
    "consumed_credits": 24,
    "error_message": null,
    "created_at": "2026-08-07T12:00:00Z",
    "request": {
      "type": "image-to-video",
      "prompt": "The subject turns toward the camera and smiles naturally",
      "image": "https://example.com/input.jpg",
      "resolution": "720p",
      "duration": 5
    },
    "response": [
      "https://cdn.example.com/video.mp4"
    ]
  }
}

ステータス値

IN_PROGRESS

動画は待機中または生成中です。ポーリングを続けてください。

SUCCESS

生成完了です。response 配列に動画 URL が含まれます。

FAILED

生成に失敗しました。error_message を確認してください。消費済みクレジットは返還されます。

エラーレスポンス

HTTP説明
400必須パラメータがないか、値が無効です。
401Bearer API キーがないか無効です。
404指定した task_id のタスクがありません。
405このエンドポイントでは HTTP メソッドがサポートされていません。
500一時的な生成または状態取得エラーです。後で再試行するかサポートへ連絡してください。