Lompat ke konten

Ltx 2.3 Quality · Reference Video to Video · LoRA

Integrasikan

ID model 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"

File seperti contoh: $0,304 304 kredit API · ≈ ₽32,70 file Anda diukur sebelum dijalankan Jalankan di halaman ini

Dapatkan kunci API
Lightricks · Video

Hasil pertama Anda akan muncul di sini

Buat permintaan di bawah ini dan jalankan dengan kunci API Anda. Output disalin ke penyimpanan kami, disimpan selamanya atau 7 hari gratis.

Buat permintaan

Kontrol dibuat dari skema model. Kode dan harga diperbarui saat Anda mengubahnya.

•wajib

Prompt yang digunakan untuk mengarahkan pembuatan.

•wajib video_url
Jatuhkan file, atau

URL yang mengarah ke video referensi untuk memandu gerakan dan struktur.

resolution bawaan auto

Dimensi video output, yang juga memengaruhi durasi stabil: ukuran lebih kecil memungkinkan lebih banyak bingkai, sedangkan ukuran lebih besar menurunkan maksimum. Estimasi kontrol bawaan menjaga ukuran tetap dekat dengan alur kerja kontrol resmi; kontrol langsung melalui `skip_control_preprocess` dan `control_video_url` mengikuti dimensi eksplisit dengan perataan 64px. Dalam mode kontrol langsung, `auto` mewarisi dimensi dan rasio aspek sumber dalam batas LTX.

bawaan 121

Jumlah bingkai output, bergantung pada anggaran stabilitas IC-LoRA yang didasarkan pada resolusi dikalikan jumlah bingkai. Respons 422 berarti anggaran tersebut terlampaui: kurangi resolusi atau `num_frames`. Anggaran ini memungkinkan sekitar 150 bingkai pada dimensi kelas 720p dan lebih banyak pada ukuran yang lebih kecil.

•wajib

Tambahan LoRA untuk LTX-2.3, masing-masing dibatasi hingga 3 GB, dengan maksimal 3 entri. Pemuatan hanya dilakukan setelah pengunduh aman SSRF milik registry mengambil setiap path.

Lanjutan 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
bawaan color distortion, ove...

Prompt negatif yang menentukan hal-hal yang harus dihindari dalam pembuatan.

Jatuhkan file, atau

Video kontrol yang telah dihitung sebelumnya secara opsional, digunakan sebagai pengganti estimasi kontrol bawaan jika diberikan bersama `skip_control_preprocess`. Video ini menjadi sinyal kontrol langsung setelah diubah ukurannya agar sesuai dengan dimensi output dan jumlah bingkai. Video tersebut dapat berisi, misalnya, komposit kedalaman, tepi, atau pose yang telah dirender.

image_url
Jatuhkan file, atau

Gaya penjangkaran gambar atau identitas karakter secara opsional sebagai keyframe bingkai pertama.

Jatuhkan file, atau

Tampilan penjangkaran gambar secara opsional di dekat titik tengah klip, melengkapi keyframe `image_url` awal. Ini membantu tampilan mengikuti pergerakan kamera alih-alih bergeser; memerlukan `image_url`.

end_image_url
Jatuhkan file, atau

Tampilan penjangkaran gambar secara opsional pada bingkai terakhir klip. Berguna saat pergerakan kamera berakhir di lokasi yang berbeda dari gambar awal; memerlukan `image_url`.

video_quality bawaan high

Preset kualitas yang diterapkan pada video output.

video_write_mode bawaan balanced

Mode penulisan untuk video yang dihasilkan.

bawaan 0.6

Kebebasan untuk mengubah gerakan dan struktur dari video referensi dikontrol oleh kekuatan conditioning ini: pengaturan yang lebih kecil memungkinkan perubahan yang lebih besar.

bawaan 1

Kontrol denoising untuk sampling video-ke-video berbasis video referensi, yang efeknya bergantung pada `preserve_original_video`. Saat mode tersebut nonaktif, pengaturan ini hanya mempersingkat jadwal denoising; saat aktif, pengaturan ini mengontrol transformasi piksel sumber, dengan 1.0 membuat ulang semuanya dan pengaturan lebih rendah mempertahankan lebih banyak (misalnya, 0.5 mempertahankan sekitar 50%).

bawaan 24

Laju bingkai video output, diukur dalam bingkai per detik.

bawaan 15

Atur jumlah langkah inferensi yang dijalankan, hingga 30; jika tidak diubah, nilainya 15.

bawaan 1

Sesuaikan classifier-free guidance menggunakan skala ini; penyetelan bawaannya menargetkan kualitas tinggi sekaligus pembuatan cepat.

Seed yang membuat pembuatan dapat direproduksi. Mengaturnya ke None akan memilih seed secara acak.

POST /run/ltx-2.3-quality/reference-video-to-video/lora?wait=20 estimasi harga → $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"

Jalankan permintaan ini

Key Anda tetap berada di browser ini: key hanya dikirim ke Doitong API dan disimpan (localStorage) hanya jika Anda mencentang Ingat. Dapatkan kunci API

Tentang Ltx 2.3 Quality · Reference Video to Video · LoRA

Menghasilkan video dari `prompt` wajib dan `video_url` referensi untuk gerakan serta struktur, dan juga memerlukan `loras`, hingga 3 file LoRA dengan ukuran masing-masing maksimal 3 GB. Gambar keyframe awal, tengah, dan akhir opsional (`image_url`, `mid_image_url`, `end_image_url`) mengunci tampilan. `video_strength` dan `strength` berkisar dari 0 hingga 1, sedangkan `num_frames` dari 9 hingga 481.

Parameter

Kirim nama kanonis atau nama asli, bukan keduanya. Nama kanonis

NamaTipe BawaanDiizinkan Deskripsi
promptwajib
Tipestring
Prompt yang digunakan untuk mengarahkan pembuatan.
video_urlwajib video
Tipeurl · video
URL yang mengarah ke video referensi untuk memandu gerakan dan struktur.
control_video_urlopsional
Tipeurl · video
Video kontrol yang telah dihitung sebelumnya secara opsional, digunakan sebagai pengganti estimasi kontrol bawaan jika diberikan bersama `skip_control_preprocess`. Video ini menjadi sinyal kontrol langsung setelah diubah ukurannya agar sesuai dengan dimensi output dan jumlah bingkai. Video tersebut dapat berisi, misalnya, komposit kedalaman, tepi, atau pose yang telah dirender.
skip_control_preprocessopsional
Tipeboolean
Bawaanfalse
Mode kontrol langsung menggunakan `control_video_url` alih-alih memperkirakan kedalaman, tepi, atau pose secara internal; tanpa URL tersebut, pengaturan ini diabaikan. Penentuan ukuran output dalam mode ini mematuhi dimensi eksplisit dengan perataan 64 agar video RGB dan kontrol tetap cocok, sedangkan `auto` menggunakan dimensi dan rasio aspek sumber dalam batas LTX.
preserve_original_videoopsional
Tipeboolean
Bawaanfalse
Mode pelestarian video asli, hanya tersedia dengan `skip_control_preprocess`, `video_url`, dan `control_video_url`. Dinonaktifkan secara bawaan, mode ini mempertahankan pemrosesan kontrol standar; saat diaktifkan, pembuatan dimulai dari `video_url` sambil mempertahankan panduan struktural dari `control_video_url`. Denoising melalui `strength` menentukan jumlah yang dipertahankan, dengan pengaturan lebih rendah mempertahankan lebih banyak piksel asli.
image_urlopsional image
Tipeurl · image
Gaya penjangkaran gambar atau identitas karakter secara opsional sebagai keyframe bingkai pertama.
mid_image_urlopsional
Tipeurl · image
Tampilan penjangkaran gambar secara opsional di dekat titik tengah klip, melengkapi keyframe `image_url` awal. Ini membantu tampilan mengikuti pergerakan kamera alih-alih bergeser; memerlukan `image_url`.
end_image_urlopsional end_image
Tipeurl · image
Tampilan penjangkaran gambar secara opsional pada bingkai terakhir klip. Berguna saat pergerakan kamera berakhir di lokasi yang berbeda dari gambar awal; memerlukan `image_url`.
video_strengthopsional
Tipenumber
Bawaan0.6
0 – 1
Kebebasan untuk mengubah gerakan dan struktur dari video referensi dikontrol oleh kekuatan conditioning ini: pengaturan yang lebih kecil memungkinkan perubahan yang lebih besar.
strengthopsional
Tipenumber
Bawaan1
0 – 1
Kontrol denoising untuk sampling video-ke-video berbasis video referensi, yang efeknya bergantung pada `preserve_original_video`. Saat mode tersebut nonaktif, pengaturan ini hanya mempersingkat jadwal denoising; saat aktif, pengaturan ini mengontrol transformasi piksel sumber, dengan 1.0 membuat ulang semuanya dan pengaturan lebih rendah mempertahankan lebih banyak (misalnya, 0.5 mempertahankan sekitar 50%).
num_framesopsional
Tipeinteger
Bawaan121
9 – 481
Jumlah bingkai output, bergantung pada anggaran stabilitas IC-LoRA yang didasarkan pada resolusi dikalikan jumlah bingkai. Respons 422 berarti anggaran tersebut terlampaui: kurangi resolusi atau `num_frames`. Anggaran ini memungkinkan sekitar 150 bingkai pada dimensi kelas 720p dan lebih banyak pada ukuran yang lebih kecil.
resolutionopsional
Tipeobject
Bawaanauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensi video output, yang juga memengaruhi durasi stabil: ukuran lebih kecil memungkinkan lebih banyak bingkai, sedangkan ukuran lebih besar menurunkan maksimum. Estimasi kontrol bawaan menjaga ukuran tetap dekat dengan alur kerja kontrol resmi; kontrol langsung melalui `skip_control_preprocess` dan `control_video_url` mengikuti dimensi eksplisit dengan perataan 64px. Dalam mode kontrol langsung, `auto` mewarisi dimensi dan rasio aspek sumber dalam batas LTX.
frames_per_secondopsional
Tipenumber
Bawaan24
1 – 60
Laju bingkai video output, diukur dalam bingkai per detik.
num_inference_stepsopsional
Tipeinteger
Bawaan15
8 – 30
Atur jumlah langkah inferensi yang dijalankan, hingga 30; jika tidak diubah, nilainya 15.
guidance_scaleopsional
Tipenumber
Bawaan1
1 – 20
Sesuaikan classifier-free guidance menggunakan skala ini; penyetelan bawaannya menargetkan kualitas tinggi sekaligus pembuatan cepat.
generate_audioopsional
Tipeboolean
Bawaantrue
Sakelar trek audio untuk MP4 yang dikembalikan: nonaktif menghasilkan file khusus video, sedangkan aktif menyertakan audio.
negative_promptopsional
Tipestring
Bawaancolor 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
Prompt negatif yang menentukan hal-hal yang harus dihindari dalam pembuatan.
seedopsional
Tipeinteger | null
Seed yang membuat pembuatan dapat direproduksi. Mengaturnya ke None akan memilih seed secara acak.
enable_prompt_expansionopsional
Tipeboolean
Bawaantrue
Mengontrol apakah perluasan prompt diaktifkan.
enable_safety_checkeropsional
Tipeboolean
Bawaantrue
Mengontrol apakah pemeriksaan keamanan diaktifkan.
video_qualityopsional
Tipeenum
Bawaanhigh
lowmediumhighmaximum
Preset kualitas yang diterapkan pada video output.
video_write_modeopsional
Tipeenum
Bawaanbalanced
fastbalancedsmall
Mode penulisan untuk video yang dihasilkan.
loraswajib
Tipeobject[]
≤ 3 item
Tambahan LoRA untuk LTX-2.3, masing-masing dibatasi hingga 3 GB, dengan maksimal 3 entri. Pemuatan hanya dilakukan setelah pengunduh aman SSRF milik registry mengambil setiap path.
loras[].pathwajib
Tipestring
≤ 2048 characters
URL HTTP(S) langsung untuk file LoRA .safetensors berukuran tidak lebih dari 3 GB. Pemuatan didahului pengambilan menggunakan pengunduh aman SSRF.
loras[].scaleopsional
Tipenumber
Bawaan1
0 – 2
Pengaruh LoRA pada video yang dibuat meningkat seiring naiknya kekuatan ini dalam rentang 0.0–2.0.
loras[].transformeropsional
Tipeenum
Bawaanboth
highlowboth
Flag pemilihan Transformer: 'both' cocok untuk hampir semua pengguna LTX-2.3 karena model hanya memiliki satu transformer. Flag ini ada untuk mendukung arsitektur mendatang dengan beberapa transformer.
wajib Nama kanonis, juga diterima

Parameter file menerima URL publik https://, URI data: hingga 10 MB, atau file_url dari unggahan. File

Output

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"
  }
}
File Anda, pilihan AndaSetiap outputs[].url adalah salinan di penyimpanan kami: disimpan selamanya (dikenai biaya per GB-bulan) atau 7 hari gratis, sesuai setelan akun atau ?storage=.
Struktur sama di setiap modeltype, url, content_type, width, height, dan duration, untuk gambar, video, dan audio. output adalah objek hasil milik model.
Field output
video
object {url, content_type, file_name, file_size}Video yang dihasilkan model.
seed
integerSeed aktual yang diterapkan selama pembuatan.
prompt
stringPrompt pembuatan, termasuk ekspansi yang diterapkan sebelum digunakan.

Model lainnya: Video ke Video

Untuk agen AI: halaman ini dalam Markdown tersedia di https://doitong.com/id/developers/models/ltx-2.3-quality/reference-video-to-video/lora.md. Semua model dan panduan: https://doitong.com/developers/llms.txt