ข้ามไปยังเนื้อหา

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 · ≈ ₽29.05 ไฟล์ของคุณจะถูกวัดก่อนเรียกใช้ เรียกใช้ในหน้านี้

รับคีย์ API
Lightricks วิดีโอเป็นวิดีโอ เสียงในตัว

การสร้างวิดีโอตามพรอมต์โดยใช้วิดีโออ้างอิง พร้อมภาพคีย์เฟรมแรก กลาง และท้ายที่ระบุได้

Lightricks · วิดีโอ

ผลลัพธ์แรกของคุณจะแสดงที่นี่

สร้างคำขอด้านล่างและเรียกใช้ด้วยคีย์ API ของคุณ เอาต์พุตจะถูกคัดลอกไปยังพื้นที่จัดเก็บของเรา และเก็บไว้ตลอดไปหรือฟรี 7 วัน

สร้างคำขอ

ตัวควบคุมสร้างจากสคีมาของโมเดล โค้ดและราคาจะอัปเดตเมื่อคุณเปลี่ยนค่า

•จำเป็น

พรอมต์ที่ใช้กำกับการสร้าง

•จำเป็น video_url
วางไฟล์ หรือ

URL ที่ชี้ไปยังวิดีโออ้างอิงซึ่งใช้เป็นแนวทางสำหรับการเคลื่อนไหวและโครงสร้าง

resolution ค่าเริ่มต้น auto

ขนาดวิดีโอเอาต์พุต ซึ่งส่งผลต่อระยะเวลาที่เสถียรด้วย ขนาดเล็กจะรองรับเฟรมได้มากขึ้น ส่วนขนาดใหญ่จะลดจำนวนสูงสุด การประเมินการควบคุมในตัวจะรักษาขนาดให้ใกล้เคียงเวิร์กโฟลว์การควบคุมอย่างเป็นทางการ ส่วนการควบคุมโดยตรงผ่าน `skip_control_preprocess` และ `control_video_url` จะเคารพขนาดที่ระบุอย่างชัดเจน โดยจัดแนวที่ 64px ในโหมดควบคุมโดยตรง `auto` จะสืบทอดขนาดและอัตราส่วนภาพของต้นฉบับภายในขีดจำกัดของ LTX

ค่าเริ่มต้น 121

จำนวนเฟรมเอาต์พุต ซึ่งอยู่ภายใต้งบประมาณความเสถียรของ IC-LoRA ที่คำนวณจากความละเอียดคูณด้วยจำนวนเฟรม การตอบกลับ 422 หมายความว่าเกินงบประมาณดังกล่าว ให้ลดความละเอียดหรือ `num_frames` งบประมาณรองรับประมาณ 150 เฟรมที่ขนาดระดับ 720p และรองรับได้มากขึ้นเมื่อใช้ขนาดเล็กลง

ขั้นสูง 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

ปรับ classifier-free guidance ด้วยสเกลนี้ โดยการปรับค่าเริ่มต้นมุ่งให้ได้ทั้งคุณภาพสูงและการสร้างที่รวดเร็ว

Seed ที่ทำให้การสร้างได้ผลลัพธ์ซ้ำเดิม การตั้งค่าเป็น None จะสุ่มเลือก seed

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` มีตัวเลือกอัตโนมัติหรือค่าคงที่ เช่น สี่เหลี่ยมจัตุรัส และแนวตั้งหรือแนวนอน 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` งบประมาณรองรับประมาณ 150 เฟรมที่ขนาดระดับ 720p และรองรับได้มากขึ้นเมื่อใช้ขนาดเล็กลง
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
ปรับ classifier-free guidance ด้วยสเกลนี้ โดยการปรับค่าเริ่มต้นมุ่งให้ได้ทั้งคุณภาพสูงและการสร้างที่รวดเร็ว
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
Seed ที่ทำให้การสร้างได้ผลลัพธ์ซ้ำเดิม การตั้งค่าเป็น None จะสุ่มเลือก seed
enable_prompt_expansionไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นtrue
ควบคุมว่าจะเปิดใช้การขยายพรอมต์หรือไม่
enable_safety_checkerไม่บังคับ
ประเภทboolean
ค่าเริ่มต้นtrue
ควบคุมว่าจะเปิดใช้การตรวจสอบความปลอดภัยหรือไม่
video_qualityไม่บังคับ
ประเภทenum
ค่าเริ่มต้นhigh
lowmediumhighmaximum
ค่าตั้งล่วงหน้าด้านคุณภาพที่ใช้กับวิดีโอเอาต์พุต
video_write_modeไม่บังคับ
ประเภทenum
ค่าเริ่มต้นbalanced
fastbalancedsmall
โหมดการเขียนสำหรับวิดีโอผลลัพธ์
จำเป็น ชื่อมาตรฐาน ซึ่งรองรับเช่นกัน

พารามิเตอร์ไฟล์รับ URL https:// สาธารณะ, data: URI ขนาดไม่เกิน 10 MB หรือ 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ค่า seed จริงที่ใช้ระหว่างการสร้าง
prompt
stringพรอมต์การสร้าง รวมถึงการขยายใด ๆ ที่ใช้ก่อนนำไปใช้

โมเดลเพิ่มเติม: วิดีโอเป็นวิดีโอ

สำหรับเอเจนต์ AI: หน้า Markdown นี้อยู่ที่ https://doitong.com/th/developers/models/ltx-2.3-quality/reference-video-to-video.md. โมเดลและคู่มือทั้งหมด: https://doitong.com/developers/llms.txt