Skip to main content
ltx/ltx-2-5-fast のAPIリファレンス。LTX から Comfy Router によって提供されています。

クイックスタート

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

スキーマ

入力

integer
必須
ビデオの再生時間(秒単位、最大値は解像度とフレームレートによって異なります)指定可能な値: 2, 3, 4, 5, 6, 8, 10, 12, 14, 16, 18, 20
integer
デフォルト:"25"
フレームレート(1 秒あたりのフレーム数)指定可能な値: 24, 25, 48, 50
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 拡張として機械可読な形式で公開されています。指定可能な値: 1280x720, 720x1280, 1920x1080, 1080x1920, 2560x1440, 1440x2560, 3840x2160, 2160x3840
Router が GET /v2/models/ltx/ltx-2-5-fast/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 が現在対応していないことと、代替手段。