跳至內容

Ltx 2.3 Quality · Reference Video to Video

整合

模型 id ltx-2.3-quality/reference-video-to-video
# 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/ltx-2.3-quality/reference-video-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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"

像範例一樣的檔案: $0.27 270 API 點數 · ≈ ₽28.97 您的檔案會在執行前計量 在此頁面執行

取得 API 金鑰
Lightricks · 影片

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

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

建立請求

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

•必填

用於引導生成的提示詞。

•必填 video_url
拖放檔案,或

指向用於引導動態與結構之參考影片的 URL。

resolution 預設 auto

輸出影片尺寸,也會影響穩定時長:較小尺寸允許更多影格,較大尺寸則降低上限。內建控制估算會使尺寸接近官方控制流程;透過 `skip_control_preprocess` 與 `control_video_url` 的直接控制則遵循明確尺寸並以 64px 對齊。直接控制模式中,`auto` 會在 LTX 限制內沿用來源尺寸與長寬比。

預設 121

輸出影格數,受以解析度乘以影格數計算的 IC-LoRA 穩定性預算限制。422 回應表示超出預算:請降低解析度或 `num_frames`。此預算約允許 720p 等級尺寸下的 150 個影格,較小尺寸則可更多。

進階 negative_prompt · control_video_url · image · mid_image_url · end_image · video_quality · video_write_mode · video_strength · strength · frames_per_second · num_inference_steps · guidance_scale · seed · skip_control_preprocess · preserve_original_video · enable_prompt_expansion · enable_safety_checker
預設 color distortion, ove...

指定生成應避免內容的負面提示詞。

拖放檔案,或

選用的預先計算控制影片;與 `skip_control_preprocess` 一起提供時,會取代內建控制估算。重新取樣以符合輸出尺寸與影格數後,會成為直接控制訊號。例如,影片可以包含已算好的深度、邊緣或姿勢合成結果。

image_url
拖放檔案,或

作為第一個影格關鍵影格的選用圖像錨定風格或角色身分。

拖放檔案,或

片段中點附近的選用圖像錨定外觀,用於補充初始的 `image_url` 關鍵影格。可協助外觀跟隨鏡頭移動而非逐漸偏移;需要 `image_url`。

end_image_url
拖放檔案,或

片段最終影格的選用圖像錨定外觀。當鏡頭移動結束於不同於起始圖像的位置時很有用;需要 `image_url`。

video_quality 預設 high

套用至輸出影片的品質預設。

video_write_mode 預設 balanced

結果影片的寫入模式。

預設 0.6

此條件強度控制可從參考影片改變動態與結構的自由度:較小的值允許更大的變化。

預設 1

參考影片轉影片取樣的去噪控制,其效果取決於 `preserve_original_video`。模式關閉時只會縮短去噪排程;啟用時則控制來源像素的轉換,1.0 會全部重新生成,較低的值會保留更多內容(例如 0.5 約保留 50%)。

預設 24

輸出影片影格率,以每秒影格數表示。

預設 15

設定要執行的推論步驟數,最多 30;維持不變時使用 15。

預設 1

使用此尺度調整無分類器引導;預設調校同時以高品質和快速生成為目標。

使生成結果可重現的種子。設為 None 會隨機選擇種子。

POST /run/ltx-2.3-quality/reference-video-to-video?wait=20 報價 → $0.27
# 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/ltx-2.3-quality/reference-video-to-video?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  }'

# 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 Quality · Reference Video to Video

根據必要的 `prompt` 與提供動態和結構的參考 `video_url` 建立新影片。可選的 `image_url`、`mid_image_url` 與 `end_image_url` 會固定開頭、中間與結尾的外觀。`video_strength` 與 `strength`(皆為 0 至 1)控制跟隨或保留來源的程度,而 `control_video_url` 可提供預先計算的控制訊號。`resolution` 提供 auto 或固定預設值,例如正方形及 16:9 直向或橫向。

參數

請傳送標準名稱或原生名稱其中之一,不要同時傳送兩者。 標準名稱

名稱類型 預設值允許值 說明
prompt必填
類型string
用於引導生成的提示詞。
video_url必填 video
類型url · video
指向用於引導動態與結構之參考影片的 URL。
control_video_url選填
類型url · video
選用的預先計算控制影片;與 `skip_control_preprocess` 一起提供時,會取代內建控制估算。重新取樣以符合輸出尺寸與影格數後,會成為直接控制訊號。例如,影片可以包含已算好的深度、邊緣或姿勢合成結果。
skip_control_preprocess選填
類型boolean
預設值false
使用 `control_video_url` 的直接控制模式,不在內部估算深度、邊緣或姿勢;未提供該 URL 時會忽略此設定。此模式的輸出尺寸遵循明確指定的尺寸並以 64 對齊,以保持 RGB 與控制影片一致;`auto` 則在 LTX 限制內採用來源尺寸與長寬比。
preserve_original_video選填
類型boolean
預設值false
原始影片保留模式,僅適用於 `skip_control_preprocess`、`video_url` 與 `control_video_url`。預設停用時會維持標準控制處理;啟用後會從 `video_url` 開始生成,同時保留 `control_video_url` 的結構引導。透過 `strength` 設定去噪程度,以控制保留量;較低的值會保留更多原始像素。
image_url選填 image
類型url · image
作為第一個影格關鍵影格的選用圖像錨定風格或角色身分。
mid_image_url選填
類型url · image
片段中點附近的選用圖像錨定外觀,用於補充初始的 `image_url` 關鍵影格。可協助外觀跟隨鏡頭移動而非逐漸偏移;需要 `image_url`。
end_image_url選填 end_image
類型url · image
片段最終影格的選用圖像錨定外觀。當鏡頭移動結束於不同於起始圖像的位置時很有用;需要 `image_url`。
video_strength選填
類型number
預設值0.6
0 – 1
此條件強度控制可從參考影片改變動態與結構的自由度:較小的值允許更大的變化。
strength選填
類型number
預設值1
0 – 1
參考影片轉影片取樣的去噪控制,其效果取決於 `preserve_original_video`。模式關閉時只會縮短去噪排程;啟用時則控制來源像素的轉換,1.0 會全部重新生成,較低的值會保留更多內容(例如 0.5 約保留 50%)。
num_frames選填
類型integer
預設值121
9 – 481
輸出影格數,受以解析度乘以影格數計算的 IC-LoRA 穩定性預算限制。422 回應表示超出預算:請降低解析度或 `num_frames`。此預算約允許 720p 等級尺寸下的 150 個影格,較小尺寸則可更多。
resolution選填
類型object
預設值auto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
輸出影片尺寸,也會影響穩定時長:較小尺寸允許更多影格,較大尺寸則降低上限。內建控制估算會使尺寸接近官方控制流程;透過 `skip_control_preprocess` 與 `control_video_url` 的直接控制則遵循明確尺寸並以 64px 對齊。直接控制模式中,`auto` 會在 LTX 限制內沿用來源尺寸與長寬比。
frames_per_second選填
類型number
預設值24
1 – 60
輸出影片影格率,以每秒影格數表示。
num_inference_steps選填
類型integer
預設值15
8 – 30
設定要執行的推論步驟數,最多 30;維持不變時使用 15。
guidance_scale選填
類型number
預設值1
1 – 20
使用此尺度調整無分類器引導;預設調校同時以高品質和快速生成為目標。
generate_audio選填
類型boolean
預設值true
返回 MP4 的音訊軌切換:關閉會產生僅含影片的檔案,開啟則包含音訊。
negative_prompt選填
類型string
預設值color distortion, overexposure, static, blurry details, subtitles, style, artwork, painting, frame, still, dim overall tone, worst quality, low quality, JPEG compression artifacts, ugly, mutilated, extra fingers, poorly drawn hands, poorly drawn face, deformed, disfigured, malformed limbs, fused fingers, motionless frame, cluttered background, three legs, crowded background, walking backwards
指定生成應避免內容的負面提示詞。
seed選填
類型integer | null
使生成結果可重現的種子。設為 None 會隨機選擇種子。
enable_prompt_expansion選填
類型boolean
預設值true
控制是否啟用提示詞擴展。
enable_safety_checker選填
類型boolean
預設值true
控制是否啟用安全性檢查。
video_quality選填
類型enum
預設值high
lowmediumhighmaximum
套用至輸出影片的品質預設。
video_write_mode選填
類型enum
預設值balanced
fastbalancedsmall
結果影片的寫入模式。
必填 標準名稱,也可使用

檔案參數接受公開的 https:// URL、最大 10 MB 的 data: URI,或上傳檔案的 file_url。 檔案

輸出

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx-2.3-quality/reference-video-to-video",
  "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": 270,
    "usd": "0.27",
    "charged": 270,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "video_url": "https://content.doitong.com/video/showcase/v3/gen_fox_cartoon.mp4"
  },
  "output": {
    "video": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_name": "0-output.mp4",
      "file_size": 1843200
    },
    "seed": 42,
    "prompt": "string"
  },
  "outputs": [
    {
      "type": "video",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.mp4",
      "content_type": "video/mp4",
      "file_size": 1843200,
      "width": 1280,
      "height": 720,
      "duration": 5,
      "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}模型產生的影片。
seed
integer生成期間實際套用的種子。
prompt
string生成提示詞,包括使用前套用的任何擴寫內容。

更多模型:影片轉影片

給 AI 代理程式:此頁面的 Markdown 位於 https://doitong.com/zh-TW/developers/models/ltx-2.3-quality/reference-video-to-video.md. 所有模型與指南: https://doitong.com/developers/llms.txt