Langkau ke kandungan

Ltx 2.3 Quality · Reference Video to Video

Integrasikan

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

Fail seperti contoh: $0.27 270 kredit API · ≈ ₽29.05 fail anda diukur sebelum dijalankan Jalankan pada halaman ini

Dapatkan kunci API
Lightricks · Video

Hasil pertama anda akan muncul di sini

Bina permintaan di bawah dan jalankannya dengan kunci API anda. Output disalin ke storan kami, disimpan selama-lamanya atau 7 hari secara percuma.

Bina permintaan

Kawalan dijana daripada skema model. Kod dan harga dikemas kini apabila anda mengubahnya.

•diperlukan

Prompt yang digunakan untuk mengarahkan penjanaan.

•diperlukan video_url
Lepaskan fail, atau

URL yang merujuk kepada video rujukan untuk memandu gerakan dan struktur.

resolution lalai auto

Dimensi video output, yang turut mempengaruhi tempoh stabil: saiz lebih kecil membenarkan lebih banyak bingkai, manakala saiz lebih besar mengurangkan maksimum. Anggaran kawalan terbina dalam mengekalkan saiz hampir dengan aliran kerja kawalan rasmi; kawalan langsung melalui `skip_control_preprocess` dan `control_video_url` sebaliknya mematuhi dimensi eksplisit dengan penjajaran 64px. Dalam mod kawalan langsung, `auto` mewarisi dimensi dan nisbah aspek sumber dalam had LTX.

lalai 121

Kiraan bingkai output, tertakluk pada belanjawan kestabilan IC-LoRA berdasarkan resolusi didarab dengan bingkai. Respons 422 bermaksud belanjawan itu telah melebihi had: kurangkan resolusi atau `num_frames`. Belanjawan membenarkan kira-kira 150 bingkai pada dimensi kelas 720p dan lebih banyak pada saiz lebih kecil.

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

Prompt negatif yang menyatakan perkara yang perlu dielakkan oleh penjanaan.

Lepaskan fail, atau

Video kawalan prapengiraan pilihan, digunakan dan bukannya anggaran kawalan terbina dalam apabila dibekalkan bersama `skip_control_preprocess`. Video ini menjadi isyarat kawalan langsung selepas pensampelan semula agar sepadan dengan dimensi output dan kiraan bingkai. Video tersebut boleh mengandungi, contohnya, komposit kedalaman, tepi atau pose yang telah dirender.

image_url
Lepaskan fail, atau

Gaya penambatan imej atau identiti watak pilihan sebagai bingkai kunci bingkai pertama.

Lepaskan fail, atau

Penampilan penambatan imej pilihan berhampiran titik tengah klip, melengkapi bingkai kunci `image_url` awal. Ia membantu penampilan menjejaki pergerakan kamera dan bukannya menyimpang; memerlukan `image_url`.

end_image_url
Lepaskan fail, atau

Penampilan penambatan imej pilihan pada bingkai akhir klip. Berguna apabila pergerakan kamera berakhir di lokasi yang berbeza daripada imej permulaan; memerlukan `image_url`.

video_quality lalai high

Praset kualiti yang digunakan pada video output.

video_write_mode lalai balanced

Mod penulisan untuk video yang terhasil.

lalai 0.6

Kebebasan untuk mengubah gerakan dan struktur daripada video rujukan dikawal oleh kekuatan pengkondisian ini: tetapan lebih kecil membenarkan perubahan yang lebih besar.

lalai 1

Kawalan penyahbisingan untuk pensampelan video-ke-video video rujukan yang kesannya bergantung pada `preserve_original_video`. Apabila mod itu dimatikan, ia hanya memendekkan jadual penyahbisingan; apabila dihidupkan, ia mengawal transformasi piksel sumber, dengan 1.0 menjana semula semuanya dan tetapan lebih rendah mengekalkan lebih banyak (contohnya, 0.5 mengekalkan kira-kira 50%).

lalai 24

Kadar bingkai video output, diukur dalam bingkai sesaat.

lalai 15

Tetapkan jumlah langkah inferens untuk dijalankan, sehingga 30; membiarkannya tidak berubah menggunakan 15.

lalai 1

Laraskan panduan tanpa pengelas menggunakan skala ini; penalaan lalainya menyasarkan kualiti tinggi dan penjanaan pantas.

Seed yang menjadikan penjanaan boleh diulang. Menetapkannya kepada None memilih seed secara rawak.

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

Jalankan permintaan ini

Kunci anda kekal dalam pelayar ini: ia hanya dihantar kepada Doitong API dan disimpan (localStorage) hanya jika anda menanda Ingat. Dapatkan kunci API

Tentang Ltx 2.3 Quality · Reference Video to Video

Mencipta video baharu daripada `prompt` yang diperlukan dan `video_url` rujukan yang menyediakan gerakan serta struktur. `image_url`, `mid_image_url` dan `end_image_url` pilihan menetapkan rupa pada permulaan, pertengahan dan penghujung. `video_strength` dan `strength` (kedua-duanya 0 hingga 1) mengawal sejauh mana sumber diikuti atau dikekalkan, manakala `control_video_url` boleh menyediakan isyarat kawalan yang telah dikira. `resolution` menawarkan pratetap automatik atau tetap seperti segi empat sama serta potret atau landskap 16:9.

Parameter

Hantar sama ada nama kanonik atau nama natif, bukan kedua-duanya. Nama kanonik

NamaJenis LalaiDibenarkan Penerangan
promptdiperlukan
Jenisstring
Prompt yang digunakan untuk mengarahkan penjanaan.
video_urldiperlukan video
Jenisurl · video
URL yang merujuk kepada video rujukan untuk memandu gerakan dan struktur.
control_video_urlpilihan
Jenisurl · video
Video kawalan prapengiraan pilihan, digunakan dan bukannya anggaran kawalan terbina dalam apabila dibekalkan bersama `skip_control_preprocess`. Video ini menjadi isyarat kawalan langsung selepas pensampelan semula agar sepadan dengan dimensi output dan kiraan bingkai. Video tersebut boleh mengandungi, contohnya, komposit kedalaman, tepi atau pose yang telah dirender.
skip_control_preprocesspilihan
Jenisboolean
Lalaifalse
Mod kawalan langsung menggunakan `control_video_url` dan bukannya menganggar kedalaman, tepi atau pose secara dalaman; tanpa URL tersebut, tetapan ini diabaikan. Pensaizan output dalam mod ini mematuhi dimensi eksplisit dengan penjajaran 64 untuk memastikan video RGB dan kawalan sepadan, manakala `auto` menggunakan dimensi dan nisbah aspek sumber dalam had LTX.
preserve_original_videopilihan
Jenisboolean
Lalaifalse
Mod pengekalan video asal, hanya tersedia dengan `skip_control_preprocess`, `video_url` dan `control_video_url`. Dilumpuhkan secara lalai, mod ini mengekalkan pemprosesan kawalan standard; apabila didayakan, penjanaan bermula daripada `video_url` sambil mengekalkan panduan struktur daripada `control_video_url`. Penyahbisingan melalui `strength` menetapkan jumlah yang dikekalkan, dengan tetapan lebih rendah mengekalkan lebih banyak piksel asal.
image_urlpilihan image
Jenisurl · image
Gaya penambatan imej atau identiti watak pilihan sebagai bingkai kunci bingkai pertama.
mid_image_urlpilihan
Jenisurl · image
Penampilan penambatan imej pilihan berhampiran titik tengah klip, melengkapi bingkai kunci `image_url` awal. Ia membantu penampilan menjejaki pergerakan kamera dan bukannya menyimpang; memerlukan `image_url`.
end_image_urlpilihan end_image
Jenisurl · image
Penampilan penambatan imej pilihan pada bingkai akhir klip. Berguna apabila pergerakan kamera berakhir di lokasi yang berbeza daripada imej permulaan; memerlukan `image_url`.
video_strengthpilihan
Jenisnumber
Lalai0.6
0 – 1
Kebebasan untuk mengubah gerakan dan struktur daripada video rujukan dikawal oleh kekuatan pengkondisian ini: tetapan lebih kecil membenarkan perubahan yang lebih besar.
strengthpilihan
Jenisnumber
Lalai1
0 – 1
Kawalan penyahbisingan untuk pensampelan video-ke-video video rujukan yang kesannya bergantung pada `preserve_original_video`. Apabila mod itu dimatikan, ia hanya memendekkan jadual penyahbisingan; apabila dihidupkan, ia mengawal transformasi piksel sumber, dengan 1.0 menjana semula semuanya dan tetapan lebih rendah mengekalkan lebih banyak (contohnya, 0.5 mengekalkan kira-kira 50%).
num_framespilihan
Jenisinteger
Lalai121
9 – 481
Kiraan bingkai output, tertakluk pada belanjawan kestabilan IC-LoRA berdasarkan resolusi didarab dengan bingkai. Respons 422 bermaksud belanjawan itu telah melebihi had: kurangkan resolusi atau `num_frames`. Belanjawan membenarkan kira-kira 150 bingkai pada dimensi kelas 720p dan lebih banyak pada saiz lebih kecil.
resolutionpilihan
Jenisobject
Lalaiauto
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
Dimensi video output, yang turut mempengaruhi tempoh stabil: saiz lebih kecil membenarkan lebih banyak bingkai, manakala saiz lebih besar mengurangkan maksimum. Anggaran kawalan terbina dalam mengekalkan saiz hampir dengan aliran kerja kawalan rasmi; kawalan langsung melalui `skip_control_preprocess` dan `control_video_url` sebaliknya mematuhi dimensi eksplisit dengan penjajaran 64px. Dalam mod kawalan langsung, `auto` mewarisi dimensi dan nisbah aspek sumber dalam had LTX.
frames_per_secondpilihan
Jenisnumber
Lalai24
1 – 60
Kadar bingkai video output, diukur dalam bingkai sesaat.
num_inference_stepspilihan
Jenisinteger
Lalai15
8 – 30
Tetapkan jumlah langkah inferens untuk dijalankan, sehingga 30; membiarkannya tidak berubah menggunakan 15.
guidance_scalepilihan
Jenisnumber
Lalai1
1 – 20
Laraskan panduan tanpa pengelas menggunakan skala ini; penalaan lalainya menyasarkan kualiti tinggi dan penjanaan pantas.
generate_audiopilihan
Jenisboolean
Lalaitrue
Togol trek audio untuk MP4 yang dikembalikan: mati menghasilkan fail video sahaja, manakala hidup menyertakan audio.
negative_promptpilihan
Jenisstring
Lalaicolor 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 menyatakan perkara yang perlu dielakkan oleh penjanaan.
seedpilihan
Jenisinteger | null
Seed yang menjadikan penjanaan boleh diulang. Menetapkannya kepada None memilih seed secara rawak.
enable_prompt_expansionpilihan
Jenisboolean
Lalaitrue
Mengawal sama ada pengembangan prompt didayakan.
enable_safety_checkerpilihan
Jenisboolean
Lalaitrue
Mengawal sama ada pemeriksaan keselamatan didayakan.
video_qualitypilihan
Jenisenum
Lalaihigh
lowmediumhighmaximum
Praset kualiti yang digunakan pada video output.
video_write_modepilihan
Jenisenum
Lalaibalanced
fastbalancedsmall
Mod penulisan untuk video yang terhasil.
diperlukan Nama kanonik, turut diterima

Parameter fail menerima URL awam https://, URI data: sehingga 10 MB, atau file_url bagi muat naik. Fail

Output

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"
  }
}
Fail anda, pilihan andaSetiap outputs[].url ialah salinan pada storan kami: disimpan selama-lamanya (dibayar setiap GB-bulan) atau 7 hari secara percuma, mengikut tetapan akaun anda atau ?storage=.
Bentuk yang sama pada setiap modeltype, url, content_type, width, height dan duration, untuk imej, video dan audio. output ialah objek hasil model itu sendiri.
Medan output
video
object {url, content_type, file_name, file_size}Video yang dihasilkan oleh model.
seed
integerSeed sebenar yang digunakan semasa penjanaan.
prompt
stringPrompt penjanaan, termasuk sebarang pengembangan yang digunakan sebelum pemprosesan.

Lebih banyak model: Video ke Video

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