Skip to main content
ltx/ltx-2-5-pro の API リファレンスです。Comfy Router が LTX から提供しています。

クイックスタート

Comfy ワークスペースでキーを作成し、COMFY_API_KEY としてエクスポートします。Python と TypeScript のスニペットは Comfy SDK(pip install comfy-sdknpm install @comfyorg/sdk)を使用しています。cURL のスニペットは、同じ呼び出しを生の HTTP で行うものです。 モデル ID: ltx/ltx-2-5-pro エンドポイント: POST https://api.comfy.org/v2/models/ltx/ltx-2-5-pro

スキーマ

入力

integer
必須
ビデオの再生時間(秒単位、最大値は解像度とフレームレートによって異なります)指定可能な値: 234568101214161820
integer
デフォルト:"25"
フレームレート(1秒あたりのフレーム数)指定可能な値: 24254850
boolean
デフォルト:"true"
ビデオのオーディオを生成します
string
生成に使用するモデル。Comfy Router のルート POST /v2/models/ltx/{model} では、このフィールドはパスから渡されるため省略できます。この操作で LTX が提供する表記(Comfy Router が ltx/<model> として扱う集合)は ltx-2-5-fast と ltx-2-5-pro です。これらは上記のコメントに記載された理由により enum に制約せず、ここに直接記載しています。それぞれがどの解像度を受け付けるかは、下記 resolution プロパティの x-comfy-model-resolutions マトリクスに示されています。
string
必須
生成したいビデオの内容を記述するテキストプロンプト
string
必須
出力ビデオの解像度。enum はすべてのモデルの和集合であり、対応する集合はモデルごとに異なります。対応ペア: ltx-2-5-fast: 1280x720、720x1280、1920x1080、1080x1920、2560x1440、1440x2560、3840x2160、2160x3840、ltx-2-5-pro: 1280x720、720x1280、1920x1080、1080x1920。その他の (model, resolution) のペアは対応していません。v2 ルートではこれらを 400 で拒否します。同じマトリクスは、このプロパティの x-comfy-model-resolutions 拡張として機械可読な形式でも公開されています。指定可能な値: 1280x720720x12801920x10801080x19202560x14401440x25603840x21602160x3840
Router が GET /v2/models/ltx/ltx-2-5-pro/openapi.json で提供するスキーマから生成されています。これは、リクエストがプロバイダーに到達する前に Router が呼び出しを検証する際に使用する同一のドキュメントです。

出力

string
ジョブの完了タイムスタンプ(ISO 8601)
string
ジョブの作成タイムスタンプ(ISO 8601)
object
status が failed の場合に存在します
string
string
string
一意のジョブ識別子
object
status が completed の場合に存在します。出力 URL は完了から 24 時間後に失効します
string
生成されたビデオの URL
string
ジョブのステータス(pending、processing、completed、failed)

入力

出力

出荷前の確認

SDK は Idempotency-Key を生成し、自動リトライで再利用します。手動リトライでは元のキーを再利用してください。Router は最大 10 分間接続を保持できます。 リクエストが失敗すると、Router は理由を示す X-Comfy-Error-Type レスポンスヘッダーを送信します。422 は、プロバイダーを呼び出す前に Router が入力を拒否したことを意味します。生成されたアセットは 結果 URL の有効期限 があるため、早めにダウンロードしてください。

ヘッダー

認証、冪等性、リクエスト ID、エラー分類、リトライ間隔、支出上限。

Router API の利用

モデルの検出、バリデーションエラー、リトライ、課金。

制限事項

Router が現在対応していないことと、代替手段。