跳至內容

LTX 2.3 Trainer (V2) - Spatial Outpainting

整合

模型 id ltx23-trainer-v2/outpaint
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx23-trainer-v2/outpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "training_data_url": "https://example.com/your-file.zip",
    "crop_top_left": [
      0,
      0
    ],
    "crop_bottom_right": [
      512,
      512
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

此請求: $12.00 12,000 API 點數 · ≈ ₽1,290.96 在此頁面執行

取得 API 金鑰
Lightricks · 檔案

您的第一個結果會顯示在這裡

在下方建立請求,並使用您的 API 金鑰執行。輸出會複製到我們的儲存空間,可永久保留或免費保留 7 天。

建立請求

控制項是根據模型結構描述生成的。變更設定時,程式碼和價格會同步更新。

resolution 預設 medium

訓練解析度。提高解析度會增加記憶體需求。

aspect_ratio 預設 1:1

訓練長寬比。

•必填

包含訓練資料的 `.zip` URL,資料依選取的訓練模式組織。每個媒體檔案可搭配具有相同基本名稱的 `.txt` 說明檔。

預設 2000

訓練步驟總數。

•必填

要保留的內部矩形左上角 (x1, y1),會對齊至由解析度 × `aspect_ratio` 選定的訓練解析度桶中的 32px 潛在網格。裁切會在調整至該桶後進行,因此座標不使用上傳影片的原生尺寸。

•必填

定義要保留之內部矩形的右下角座標 (x2, y2);模型會生成其外部的所有內容。以訓練解析度像素表示,此角點必須位於訓練影格內,並符合 x2 > x1 及 y2 > y1。

進階 validation_negative_prompt · rank · validation_resolution · validation_aspect_ratio · trigger_phrase · learning_rate · number_of_frames · frame_rate · split_input_duration_threshold · validation_number_of_frames · validation_frame_rate · stg_scale · auto_scale_input · split_input_into_scenes · debug_dataset · validation
預設 blurry, out of focus,...

驗證期間套用的負面提示詞;驗證使用單階段預覽流程。由於該流程近似兩階段的蒸餾生產推論,其引導方式與預覽品質會不同於最終結果。

rank 預設 32

LoRA 適配階數;設定越高,記憶體消耗越大,但容量也越高。

validation_resolution 預設 high

驗證期間使用的解析度。

validation_aspect_ratio 預設 1:1

驗證期間使用的長寬比。

預設

LoRA 風格啟用片語,訓練時插入說明的開頭。

預設 0.0002

最佳化學習率。

預設 89

每個訓練樣本的影格數。將數量除以 8 後餘數必須為 1;例如 1、9、17、25、33、41、49、57、65、73、81、89、97。

預設 24

訓練影片的目標影格率(每秒影格數)。LTX-2.3 的原生速率為 24。

預設 30

以秒數表示的場景分割觸發門檻:只有長於該門檻的影片才會分割。

預設 89

每部驗證影片的影格數。

預設 24

驗證影片的目標影格率(每秒影格數);LTX-2.3 的原生速率為 24。

預設 1

時空引導(STG)比例;建議使用 1.0,0.0 會關閉 STG。

預設 []

外繪的驗證資料,以包含提示詞和完整畫布影片的項目清單提供。

POST /run/ltx23-trainer-v2/outpaint?wait=20 報價 → $12.00
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.ru/v1/run/ltx23-trainer-v2/outpaint?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "training_data_url": "https://example.com/your-file.zip",
    "crop_top_left": [
      0,
      0
    ],
    "crop_bottom_right": [
      512,
      512
    ]
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.ru/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

執行此請求

您的金鑰會保留在此瀏覽器中:只會傳送至 Doitong API,且只有在勾選「記住」時才會儲存至 localStorage。 取得 API 金鑰

關於 LTX 2.3 Trainer (V2) - Spatial Outpainting

訓練用於空間延伸繪圖的 LoRA,固定內部矩形,並由模型生成其周圍區域。`crop_top_left` 與 `crop_bottom_right` 是保留矩形所需的(x, y)角點,座標以 `resolution` 與 `aspect_ratio` 設定的訓練解析度像素表示,且必須位於影格內。每個驗證樣本都使用完整畫布的影片。

參數

名稱類型 預設值允許值 說明
training_data_url必填
類型string
包含訓練資料的 `.zip` URL,資料依選取的訓練模式組織。每個媒體檔案可搭配具有相同基本名稱的 `.txt` 說明檔。
rank選填
類型enum
預設值32
8163264128
LoRA 適配階數;設定越高,記憶體消耗越大,但容量也越高。
number_of_steps選填
類型integer
預設值2000
100 – 10,000
訓練步驟總數。
learning_rate選填
類型number
預設值0.0002
0.000001 – 1
最佳化學習率。
number_of_frames選填
類型integer
預設值89
9 – 121
每個訓練樣本的影格數。將數量除以 8 後餘數必須為 1;例如 1、9、17、25、33、41、49、57、65、73、81、89、97。
frame_rate選填
類型integer
預設值24
8 – 60
訓練影片的目標影格率(每秒影格數)。LTX-2.3 的原生速率為 24。
resolution選填
類型enum
預設值medium
lowmediumhigh
訓練解析度。提高解析度會增加記憶體需求。
aspect_ratio選填
類型enum
預設值1:1
16:91:19:16
訓練長寬比。
trigger_phrase選填
類型string
預設值
LoRA 風格啟用片語,訓練時插入說明的開頭。
auto_scale_input選填
類型boolean
預設值false
啟用後自動調整影片,以符合要求的 FPS 與影格數;圖像資料集不會變更。
split_input_into_scenes選填
類型boolean
預設值true
超過時長門檻之影片的場景分割,為 true 時啟用。
split_input_duration_threshold選填
類型number
預設值30
1 – 60
以秒數表示的場景分割觸發門檻:只有長於該門檻的影片才會分割。
debug_dataset選填
類型boolean
預設值false
預處理檢查模式,用於完整訓練前檢查影片、圖像與說明。啟用後,訓練器會將處理過的訓練資料集放入可下載的封存檔,供手動檢查。
crop_top_left必填
類型any[]
≤ 2 個項目≥ 2 個項目
要保留的內部矩形左上角 (x1, y1),會對齊至由解析度 × `aspect_ratio` 選定的訓練解析度桶中的 32px 潛在網格。裁切會在調整至該桶後進行,因此座標不使用上傳影片的原生尺寸。
crop_bottom_right必填
類型any[]
≤ 2 個項目≥ 2 個項目
定義要保留之內部矩形的右下角座標 (x2, y2);模型會生成其外部的所有內容。以訓練解析度像素表示,此角點必須位於訓練影格內,並符合 x2 > x1 及 y2 > y1。
validation選填
類型object[]
預設值[]
≤ 2 個項目
外繪的驗證資料,以包含提示詞和完整畫布影片的項目清單提供。
validation[].prompt必填
類型string
驗證期間使用的提示詞。
validation[].video_url必填
類型url · video
≥ 1 characters
用於外繪周圍區域的完整畫布影片 URL。
validation_negative_prompt選填
類型string
預設值blurry, out of focus, overexposed, underexposed, low contrast, washed out colors, excessive noise, grainy texture, poor lighting, flickering, motion blur, distorted proportions, unnatural skin tones, deformed facial features, asymmetrical face, missing facial features, extra limbs, disfigured hands, wrong hand count, artifacts around text, inconsistent perspective, camera shake, incorrect depth of field, background too sharp, background clutter, distracting reflections, harsh shadows, inconsistent lighting direction, color banding, cartoonish rendering, 3D CGI look, unrealistic materials, uncanny valley effect, incorrect ethnicity, wrong gender, exaggerated expressions, wrong gaze direction, mismatched lip sync, silent or muted audio, distorted voice, robotic voice, echo, background noise, off-sync audio, incorrect dialogue, added dialogue, repetitive speech, jittery movement, awkward pauses, incorrect timing, unnatural transitions, inconsistent framing, tilted camera, flat lighting, inconsistent tone, cinematic oversaturation, stylized filters, or AI artifacts.
驗證期間套用的負面提示詞;驗證使用單階段預覽流程。由於該流程近似兩階段的蒸餾生產推論,其引導方式與預覽品質會不同於最終結果。
validation_number_of_frames選填
類型integer
預設值89
9 – 121
每部驗證影片的影格數。
validation_frame_rate選填
類型integer
預設值24
8 – 60
驗證影片的目標影格率(每秒影格數);LTX-2.3 的原生速率為 24。
validation_resolution選填
類型enum
預設值high
lowmediumhigh
驗證期間使用的解析度。
validation_aspect_ratio選填
類型enum
預設值1:1
16:91:19:16
驗證期間使用的長寬比。
stg_scale選填
類型number
預設值1
0 – 3
時空引導(STG)比例;建議使用 1.0,0.0 會關閉 STG。
必填

輸出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx23-trainer-v2/outpaint",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 12000,
    "usd": "12.00",
    "charged": 12000,
    "refunded": 0
  },
  "input": {
    "training_data_url": "https://example.com/your-file.zip",
    "crop_top_left": [
      0,
      0
    ],
    "crop_bottom_right": [
      512,
      512
    ]
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "audio": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "lora_file": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "config_file": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    },
    "debug_dataset": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200
    }
  },
  "outputs": [
    {
      "type": "file",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.ru/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
您的檔案,由您選擇每個 outputs[].url 都是儲存空間中的副本:可永久保留(按 GB-月計費),或免費保留 7 天;可透過帳戶設定或 ?storage= 設定。
所有模型使用相同結構圖片、影片和音訊皆包含 type、url、content_type、width、height 和 duration。output 是模型自己的結果物件。
輸出欄位
video
object {url, content_type, file_name, file_size} | null驗證產生的合併影片預覽;對可產生影片的端點,若有提供則包含此欄位。
audio
object {url, content_type, file_name, file_size} | null驗證產生的合併音訊;對以下音訊專用路由,若有提供則作為預覽:/audio-inpaint、/audio-extend-suffix、/audio-extend-prefix、/t2a、/a2a 與 /v2a。
lora_file
object {url, content_type, file_name, file_size}`.safetensors` 格式訓練 LoRA 權重的 URL。
config_file
object {url, content_type, file_name, file_size}推論端點設定的組態。
debug_dataset
object {url, content_type, file_name, file_size} | null啟用 `debug_dataset` 時可用的除錯輸出:可下載且包含預處理後訓練資料的封存檔。

更多模型:訓練

給 AI 代理程式:此頁面的 Markdown 位於 https://doitong.com/zh-TW/developers/models/ltx23-trainer-v2/outpaint.md. 所有模型與指南: https://doitong.com/developers/llms.txt