Pro API: プロンプトからサウンド付き動画を生成する
プロンプトからクリップを生成するか、アップロードした静止画をアニメーション化します。出力ファイルはMP4形式で、リクエスト時にサウンドを付けることもできます。
動画を送信する
POST /videos
{ "prompt": "a woman in a white linen dress walks along a beach at sunset, wind in her hair, she turns and smiles at the camera",
"width": 1080, "height": 1920, "audio": true }
| フィールド | 型 | デフォルト | 説明 |
|---|---|---|---|
prompt | string | 必須 | 動き、雰囲気、光の様子を記述します。動作を具体的に説明してください。 |
width, height | int | 720 x 1280 | デフォルトは縦向きです。下記の料金表を参照してください。 |
mode | string | ltx25 | ltx25: エンジン2.5（サウンド対応、自動デュレーション、1080p、終了フレーム指定可）。turbo: 480pの高速・低コストレーン、終了フレーム指定不可。 |
duration_auto | bool | true | エンジンがプロンプトから長さを自動決定し、lengthは上限として機能します。固定長にするにはfalseを指定してください。 |
length | int | 121 | フレーム数による長さ（または上限）。24fps基準で常に8n+1の形式: 73（3秒）、121（5秒）、241（10秒）、361（15秒）、481（20秒）。 |
audio | bool | false | 映像と同時にサウンドを生成します（環境音、音声など）。 |
image | string | base64形式の開始フレーム: この画像をアニメーション化します。 | |
end_image | string | base64形式の終了フレーム。imageと併用することで、開始フレームから終了フレームへのトランジションを生成します（エンジン2.5のみ対応）。 | |
lora, lora_strength | string, number | アカウントに登録済みの学習済みキャラクター（GET /lorasのnameフィールド）と、その強度（0〜1）。 | |
lora2, lora2_strength | string, number | 2人目のキャラクター。 | |
steps | int | エンジン依存 | 通常は空のままにしてください。 |
レスポンス:
{ "jobId": "...", "seed": 908172, "cost": 30 }
コストは送信時に計算・提示されます。課金はその後に行われます。
フォーマットと料金
動画は長さに関わらずフォーマットごとに一律料金で課金されます。基本料金: 5クレジット。
| フォーマット | 短辺 | サイズ例 | サウンドなし | サウンドあり |
|---|---|---|---|---|
| 480p | 480 | 480 x 832, 832 x 480 | 5 | 10 |
| 720p | 720 | 720 x 1280, 1280 x 720 | 10 | 20 |
| 1080p | 1080 | 1080 x 1920, 1920 x 1080 | 15 | 30 |
turboレーンは異なる料金体系です: 480p、2.5秒ごとに1クレジット（5秒 = 2クレジット、10秒 = 4クレジット）。サウンド込み、終了フレーム指定不可。
ポーリング、ダウンロード、キャンセル
/videos以下のルートは画像と同じ仕様です。
GET /videos/{jobId}:pending/completed/failed、フィールドも同一。GET /videos/{jobId}/file: MP4ファイルを取得します（Content-Type: video/mp4）。POST /videos/{jobId}/cancel: キャンセルします。この場合、課金は発生しません。
動画の生成には1〜5分かかります。エンジンのコールドスタート時はさらに時間がかかる場合があります。3秒ごとにポーリングし、ステータスがcompletedになり次第すぐにダウンロードしてください。ファイルはアーカイブされません。