Bỏ qua đến nội dung

Ltx 2.3 Quality · Reference Video to Video · LoRA

Tích hợp

Id mô hình ltx-2.3-quality/reference-video-to-video/lora
# 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/lora?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",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

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

Các tệp như ví dụ: 0,304 $ 304 tín dụng API · ≈ 32,70 ₽ tệp của bạn được đo trước khi chạy Chạy trên trang này

Lấy khóa API
Lightricks · Video

Kết quả đầu tiên của bạn sẽ xuất hiện ở đây

Tạo một yêu cầu bên dưới và chạy bằng khóa API của bạn. Đầu ra được sao chép vào bộ lưu trữ của chúng tôi, giữ vĩnh viễn hoặc 7 ngày miễn phí.

Tạo một yêu cầu

Các điều khiển được tạo từ lược đồ mô hình. Mã và giá sẽ cập nhật khi bạn thay đổi chúng.

•bắt buộc

Lời nhắc dùng để định hướng tạo sinh.

•bắt buộc video_url
Thả tệp hoặc

URL trỏ đến video tham chiếu dùng để hướng dẫn chuyển động và cấu trúc.

resolution mặc định auto

Kích thước video đầu ra, đồng thời ảnh hưởng đến thời lượng ổn định: kích thước nhỏ hơn cho phép nhiều khung hình hơn, còn kích thước lớn hơn làm giảm mức tối đa. Việc ước tính điều khiển tích hợp giữ kích thước gần với quy trình điều khiển chính thức; điều khiển trực tiếp qua `skip_control_preprocess` và `control_video_url` thay vào đó tôn trọng kích thước rõ ràng với căn chỉnh 64px. Ở chế độ điều khiển trực tiếp, `auto` kế thừa kích thước và tỷ lệ khung hình nguồn trong giới hạn LTX.

mặc định 121

Số khung hình đầu ra, chịu giới hạn ổn định IC-LoRA dựa trên tích của độ phân giải và số khung hình. Phản hồi 422 nghĩa là đã vượt giới hạn đó: hãy giảm độ phân giải hoặc `num_frames`. Giới hạn cho phép khoảng 150 khung hình ở kích thước tương đương 720p và nhiều hơn ở kích thước nhỏ hơn.

•bắt buộc

Các phần bổ sung LoRA cho LTX-2.3, mỗi phần tối đa 3 GB và cho phép tối đa 3 mục. Việc tải chỉ diễn ra sau khi trình tải an toàn SSRF của registry truy xuất từng đường dẫn.

Nâng cao 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
mặc định color distortion, ove...

Lời nhắc phủ định chỉ rõ những gì quá trình tạo sinh cần tránh.

Thả tệp hoặc

Video điều khiển được tính toán trước, tùy chọn, dùng thay cho việc ước tính điều khiển tích hợp khi được cung cấp cùng `skip_control_preprocess`. Video trở thành tín hiệu điều khiển trực tiếp sau khi được lấy mẫu lại để khớp kích thước đầu ra và số khung hình. Ví dụ, video có thể chứa tổng hợp độ sâu, cạnh hoặc tư thế đã được kết xuất sẵn.

image_url
Thả tệp hoặc

Kiểu neo hình ảnh hoặc danh tính nhân vật tùy chọn ở khung hình đầu tiên.

Thả tệp hoặc

Diện mạo neo hình ảnh tùy chọn gần điểm giữa clip, bổ sung cho khung hình neo `image_url` ban đầu. Tùy chọn này giúp diện mạo bám theo chuyển động máy quay thay vì bị trôi; yêu cầu `image_url`.

end_image_url
Thả tệp hoặc

Diện mạo neo hình ảnh tùy chọn ở khung hình cuối của clip. Hữu ích khi chuyển động máy quay kết thúc tại vị trí khác với hình ảnh ban đầu; yêu cầu `image_url`.

video_quality mặc định high

Thiết lập chất lượng áp dụng cho video đầu ra.

video_write_mode mặc định balanced

Chế độ ghi của video kết quả.

mặc định 0.6

Mức tự do thay đổi chuyển động và cấu trúc từ video tham chiếu được kiểm soát bởi cường độ điều kiện này: thiết lập nhỏ hơn cho phép thay đổi nhiều hơn.

mặc định 1

Điều khiển khử nhiễu cho việc lấy mẫu video-từ-video tham chiếu, với tác động phụ thuộc vào `preserve_original_video`. Khi chế độ này tắt, nó chỉ rút ngắn lịch khử nhiễu; khi bật, nó điều khiển việc biến đổi điểm ảnh nguồn, trong đó 1.0 tái tạo mọi thứ còn giá trị thấp hơn giữ lại nhiều hơn (ví dụ: 0.5 giữ khoảng 50%).

mặc định 24

Tốc độ khung hình video đầu ra, tính bằng khung hình trên giây.

mặc định 15

Đặt số bước suy luận cần chạy, tối đa 30; giữ nguyên giá trị này sẽ dùng 15.

mặc định 1

Điều chỉnh classifier-free guidance bằng thang đo này; tinh chỉnh mặc định hướng đến chất lượng cao và tạo sinh nhanh.

Seed giúp quá trình tạo sinh có thể tái lập. Đặt thành None sẽ chọn seed ngẫu nhiên.

POST /run/ltx-2.3-quality/reference-video-to-video/lora?wait=20 báo giá → 0,304 $
# 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/lora?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",
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ]
  }'

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

Chạy yêu cầu này

Key của bạn vẫn nằm trong trình duyệt này: key chỉ được gửi đến Doitong API và chỉ được lưu trong localStorage nếu bạn chọn Ghi nhớ. Nhận khóa API

Giới thiệu về Ltx 2.3 Quality · Reference Video to Video · LoRA

Tạo video từ `prompt` bắt buộc và `video_url` tham chiếu cho chuyển động cùng cấu trúc, đồng thời yêu cầu `loras`, tối đa 3 tệp LoRA với mỗi tệp không quá 3 GB. Hình ảnh khung hình chính đầu, giữa và cuối tùy chọn (`image_url`, `mid_image_url`, `end_image_url`) neo diện mạo. `video_strength` và `strength` nằm trong khoảng từ 0 đến 1, còn `num_frames` từ 9 đến 481.

Tham số

Gửi tên chuẩn hoặc tên gốc, không gửi cả hai. Tên chuẩn

TênKiểu Mặc địnhĐược phép Mô tả
promptbắt buộc
Kiểustring
Lời nhắc dùng để định hướng tạo sinh.
video_urlbắt buộc video
Kiểuurl · video
URL trỏ đến video tham chiếu dùng để hướng dẫn chuyển động và cấu trúc.
control_video_urltùy chọn
Kiểuurl · video
Video điều khiển được tính toán trước, tùy chọn, dùng thay cho việc ước tính điều khiển tích hợp khi được cung cấp cùng `skip_control_preprocess`. Video trở thành tín hiệu điều khiển trực tiếp sau khi được lấy mẫu lại để khớp kích thước đầu ra và số khung hình. Ví dụ, video có thể chứa tổng hợp độ sâu, cạnh hoặc tư thế đã được kết xuất sẵn.
skip_control_preprocesstùy chọn
Kiểuboolean
Mặc địnhfalse
Chế độ điều khiển trực tiếp dùng `control_video_url` thay vì ước tính độ sâu, cạnh hoặc tư thế nội bộ; nếu không có URL đó, thiết lập này bị bỏ qua. Việc định cỡ đầu ra ở chế độ này tôn trọng kích thước rõ ràng với căn chỉnh 64 để giữ video RGB và video điều khiển đồng nhất, còn `auto` lấy kích thước và tỷ lệ khung hình nguồn trong giới hạn LTX.
preserve_original_videotùy chọn
Kiểuboolean
Mặc địnhfalse
Chế độ giữ lại video gốc, chỉ khả dụng với `skip_control_preprocess`, `video_url` và `control_video_url`. Theo mặc định bị tắt, chế độ này giữ nguyên xử lý điều khiển tiêu chuẩn; khi bật, quá trình tạo sinh bắt đầu từ `video_url` đồng thời giữ hướng dẫn cấu trúc từ `control_video_url`. Khử nhiễu qua `strength` đặt lượng được giữ lại; giá trị thấp hơn giữ nhiều điểm ảnh gốc hơn.
image_urltùy chọn image
Kiểuurl · image
Kiểu neo hình ảnh hoặc danh tính nhân vật tùy chọn ở khung hình đầu tiên.
mid_image_urltùy chọn
Kiểuurl · image
Diện mạo neo hình ảnh tùy chọn gần điểm giữa clip, bổ sung cho khung hình neo `image_url` ban đầu. Tùy chọn này giúp diện mạo bám theo chuyển động máy quay thay vì bị trôi; yêu cầu `image_url`.
end_image_urltùy chọn end_image
Kiểuurl · image
Diện mạo neo hình ảnh tùy chọn ở khung hình cuối của clip. Hữu ích khi chuyển động máy quay kết thúc tại vị trí khác với hình ảnh ban đầu; yêu cầu `image_url`.
video_strengthtùy chọn
Kiểunumber
Mặc định0.6
0 – 1
Mức tự do thay đổi chuyển động và cấu trúc từ video tham chiếu được kiểm soát bởi cường độ điều kiện này: thiết lập nhỏ hơn cho phép thay đổi nhiều hơn.
strengthtùy chọn
Kiểunumber
Mặc định1
0 – 1
Điều khiển khử nhiễu cho việc lấy mẫu video-từ-video tham chiếu, với tác động phụ thuộc vào `preserve_original_video`. Khi chế độ này tắt, nó chỉ rút ngắn lịch khử nhiễu; khi bật, nó điều khiển việc biến đổi điểm ảnh nguồn, trong đó 1.0 tái tạo mọi thứ còn giá trị thấp hơn giữ lại nhiều hơn (ví dụ: 0.5 giữ khoảng 50%).
num_framestùy chọn
Kiểuinteger
Mặc định121
9 – 481
Số khung hình đầu ra, chịu giới hạn ổn định IC-LoRA dựa trên tích của độ phân giải và số khung hình. Phản hồi 422 nghĩa là đã vượt giới hạn đó: hãy giảm độ phân giải hoặc `num_frames`. Giới hạn cho phép khoảng 150 khung hình ở kích thước tương đương 720p và nhiều hơn ở kích thước nhỏ hơn.
resolutiontùy chọn
Kiểuobject
Mặc địnhauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Kích thước video đầu ra, đồng thời ảnh hưởng đến thời lượng ổn định: kích thước nhỏ hơn cho phép nhiều khung hình hơn, còn kích thước lớn hơn làm giảm mức tối đa. Việc ước tính điều khiển tích hợp giữ kích thước gần với quy trình điều khiển chính thức; điều khiển trực tiếp qua `skip_control_preprocess` và `control_video_url` thay vào đó tôn trọng kích thước rõ ràng với căn chỉnh 64px. Ở chế độ điều khiển trực tiếp, `auto` kế thừa kích thước và tỷ lệ khung hình nguồn trong giới hạn LTX.
frames_per_secondtùy chọn
Kiểunumber
Mặc định24
1 – 60
Tốc độ khung hình video đầu ra, tính bằng khung hình trên giây.
num_inference_stepstùy chọn
Kiểuinteger
Mặc định15
8 – 30
Đặt số bước suy luận cần chạy, tối đa 30; giữ nguyên giá trị này sẽ dùng 15.
guidance_scaletùy chọn
Kiểunumber
Mặc định1
1 – 20
Điều chỉnh classifier-free guidance bằng thang đo này; tinh chỉnh mặc định hướng đến chất lượng cao và tạo sinh nhanh.
generate_audiotùy chọn
Kiểuboolean
Mặc địnhtrue
Bật/tắt bản âm thanh cho MP4 trả về: tắt tạo tệp chỉ có video, bật sẽ bao gồm âm thanh.
negative_prompttùy chọn
Kiểustring
Mặc địnhcolor 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
Lời nhắc phủ định chỉ rõ những gì quá trình tạo sinh cần tránh.
seedtùy chọn
Kiểuinteger | null
Seed giúp quá trình tạo sinh có thể tái lập. Đặt thành None sẽ chọn seed ngẫu nhiên.
enable_prompt_expansiontùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc bật mở rộng lời nhắc.
enable_safety_checkertùy chọn
Kiểuboolean
Mặc địnhtrue
Kiểm soát việc bật kiểm tra an toàn.
video_qualitytùy chọn
Kiểuenum
Mặc địnhhigh
lowmediumhighmaximum
Thiết lập chất lượng áp dụng cho video đầu ra.
video_write_modetùy chọn
Kiểuenum
Mặc địnhbalanced
fastbalancedsmall
Chế độ ghi của video kết quả.
lorasbắt buộc
Kiểuobject[]
≤ 3 mục
Các phần bổ sung LoRA cho LTX-2.3, mỗi phần tối đa 3 GB và cho phép tối đa 3 mục. Việc tải chỉ diễn ra sau khi trình tải an toàn SSRF của registry truy xuất từng đường dẫn.
loras[].pathbắt buộc
Kiểustring
≤ 2048 characters
URL HTTP(S) trực tiếp đến tệp LoRA .safetensors không lớn hơn 3 GB. Việc tải được thực hiện sau khi truy xuất bằng trình tải an toàn SSRF.
loras[].scaletùy chọn
Kiểunumber
Mặc định1
0 – 2
Ảnh hưởng của LoRA lên video tạo sinh tăng khi độ mạnh tăng trong phạm vi 0.0–2.0.
loras[].transformertùy chọn
Kiểuenum
Mặc địnhboth
highlowboth
Cờ lựa chọn Transformer: 'both' phù hợp với hầu hết người dùng LTX-2.3 vì mô hình chỉ có một transformer. Cờ này tồn tại để hỗ trợ các kiến trúc tương lai có nhiều transformer.
bắt buộc Tên chuẩn, cũng được chấp nhận

Các tham số tệp nhận URL https:// công khai, URI data: tối đa 10 MB hoặc file_url của một tệp tải lên. Tệp

Đầu ra

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "ltx-2.3-quality/reference-video-to-video/lora",
  "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": 304,
    "usd": "0.304",
    "charged": 304,
    "refunded": 0
  },
  "input": {
    "loras": [
      {
        "path": "https://example.com/your-file.safetensors"
      }
    ],
    "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"
  }
}
Tệp của bạn, lựa chọn của bạnMỗi outputs[].url là một bản sao trên bộ lưu trữ của chúng tôi: được giữ vĩnh viễn (tính phí theo GB-tháng) hoặc 7 ngày miễn phí, theo cài đặt tài khoản hoặc ?storage=.
Cùng một cấu trúc trên mọi mô hìnhtype, url, content_type, width, height và duration cho hình ảnh, video và âm thanh. output là đối tượng kết quả riêng của mô hình.
Các trường đầu ra
video
object {url, content_type, file_name, file_size}Video do mô hình tạo ra.
seed
integerSeed thực tế được áp dụng trong quá trình tạo sinh.
prompt
stringLời nhắc tạo sinh, bao gồm mọi phần mở rộng được áp dụng trước khi sử dụng.

Thêm mô hình: Video sang video

Dành cho tác nhân AI: trang này ở dạng Markdown tại https://doitong.com/vi/developers/models/ltx-2.3-quality/reference-video-to-video/lora.md. Tất cả mô hình và hướng dẫn: https://doitong.com/developers/llms.txt