تخطّي إلى المحتوى

Ltx 2.3 Quality · Reference Video to Video · LoRA

التكامل

معرّف النموذج 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"

ملفات مثل المثال: ⁨‏0.304 $⁩ 304 أرصدة API · ≈ ⁨‏32.70 ₽⁩ تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Lightricks من فيديو إلى فيديو صوت أصلي

إنشاء اعتمادًا على فيديو مرجعي مثل الإصدار الأساسي، مع تطبيق ما يصل إلى 3 من LoRAs المخصصة

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 وبعدد أكبر عند الأحجام الأصغر.

•مطلوب

إضافات LoRA لـ LTX-2.3، يقتصر كل منها على 3 GB، مع السماح بحد أقصى 3 إدخالات. لا يحدث التحميل إلا بعد أن يسترد برنامج التنزيل الآمن من SSRF الخاص بالسجل كل مسار.

متقدم 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/lora?wait=20 عرض السعر → ⁨‏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"

تشغيل هذا الطلب

يبقى مفتاحك في هذا المتصفح: لا يُرسل إلا إلى Doitong API ويُحفظ في localStorage فقط إذا فعّلت خيار التذكّر. الحصول على مفتاح API

حول Ltx 2.3 Quality · Reference Video to Video · LoRA

ينشئ فيديو من `prompt` مطلوب و`video_url` مرجعي للحركة والبنية، ويتطلب أيضًا `loras`، أي ما يصل إلى 3 ملفات LoRA بحجم أقصى 3 GB لكل منها. تثبّت صور الإطارات المفتاحية الأولى والوسطى والأخيرة الاختيارية (`image_url` و`mid_image_url` و`end_image_url`) المظهر. يتراوح `video_strength` و`strength` من 0 إلى 1، و`num_frames` من 9 إلى 481.

المعاملات

أرسل الاسم الأساسي أو الاسم الأصلي، وليس كليهما. الأسماء الأساسية

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
الموجّه المستخدم لتوجيه التوليد.
video_urlمطلوب video
النوعurl · video
عنوان URL يشير إلى فيديو مرجعي يُستخدم لتوجيه الحركة والبنية.
control_video_urlاختياري
النوعurl · video
فيديو تحكم اختياري محسوب مسبقًا، يُستخدم بدلًا من تقدير التحكم المضمّن عند تقديمه مع `skip_control_preprocess`. يصبح إشارة التحكم المباشرة بعد إعادة تحجيمه لمطابقة أبعاد المخرج وعدد الإطارات. قد يحتوي الفيديو، مثلًا، على تركيب عمق أو حواف أو وضعية مُصيّر مسبقًا.
skip_control_preprocessاختياري
النوعboolean
الافتراضيfalse
وضع تحكم مباشر باستخدام `control_video_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
اضبط التوجيه الخالي من المصنف باستخدام هذا المقياس؛ ويستهدف ضبطه الافتراضي جودة عالية وتوليدًا سريعًا.
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
وضع كتابة الفيديو الناتج.
lorasمطلوب
النوعobject[]
≤ 3 عناصر
إضافات LoRA لـ LTX-2.3، يقتصر كل منها على 3 GB، مع السماح بحد أقصى 3 إدخالات. لا يحدث التحميل إلا بعد أن يسترد برنامج التنزيل الآمن من SSRF الخاص بالسجل كل مسار.
loras[].pathمطلوب
النوعstring
≤ 2048 characters
عنوان URL مباشر من HTTP(S) لملف LoRA ‏.safetensors لا يتجاوز حجمه 3 GB. يسبق التحميلَ الاستردادُ باستخدام برنامج تنزيل آمن من SSRF.
loras[].scaleاختياري
النوعnumber
الافتراضي1
0 – 2
يزداد تأثير LoRA في الفيديو المولّد مع ارتفاع هذه القوة ضمن النطاق 0.0–2.0.
loras[].transformerاختياري
النوعenum
الافتراضيboth
highlowboth
علامة اختيار Transformer: يناسب 'both' تقريبًا جميع مستخدمي LTX-2.3 لأن النموذج يحتوي على Transformer واحد فقط. توجد العلامة لدعم البنى المستقبلية التي تحتوي على Transformers متعددة.
مطلوب الاسم الأساسي، مقبول أيضًا

تقبل معاملات الملفات عنوان URL عامًا يبدأ بـ https://، أو URI من نوع data: يصل حجمه إلى 10 MB، أو file_url لملف تم تحميله. الملفات

المخرجات

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"
  }
}
ملفاتك، خيارككل outputs[].url هو نسخة على تخزيننا: تُحفظ إلى الأبد (مع الدفع لكل غيغابايت-شهر) أو لمدة 7 أيام مجانًا، وفق إعداد حسابك أو ?storage=.
البنية نفسها في كل نموذجtype وurl وcontent_type وwidth وheight وduration للصور والفيديو والصوت على حد سواء. output هو كائن النتائج الخاص بالنموذج.
حقول المخرجات
video
object {url, content_type, file_name, file_size}الفيديو الذي أنتجه النموذج.
seed
integerالبذرة الفعلية المطبقة أثناء التوليد.
prompt
stringموجّه التوليد، بما في ذلك أي توسيع طُبق قبل الاستخدام.

مزيد من النماذج: من فيديو إلى فيديو

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/ltx-2.3-quality/reference-video-to-video/lora.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt