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

Ltx 2.3 Quality · Outpaint · LoRA

التكامل

معرّف النموذج ltx-2.3-quality/outpaint/lora
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/ltx-2.3-quality/outpaint/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

توسيع فيديو حسب نسبة العرض إلى الارتفاع مع تطبيق ما يصل إلى 3 من LoRAs المخصصة

Lightricks · فيديو

ستظهر نتيجتك الأولى هنا

أنشئ طلبًا أدناه وشغّله باستخدام مفتاح API الخاص بك. تُنسخ المخرجات إلى تخزيننا، وتُحفظ إلى الأبد أو لمدة 7 أيام مجانًا.

إنشاء طلب

تُنشأ عناصر التحكم من مخطط النموذج. يتحدّث الرمز والسعر عند تغييرها.

•مطلوب

نص يوجه توليد المناطق الموسعة خارج إطار الفيديو.

•مطلوب video_url
أفلت ملفًا، أو

الفيديو المصدر الذي ستُمدد حدوده المكانية عبر التوسيع خارج الإطار.

aspect_ratio الافتراضي 16:9

نسبة أبعاد التوسيع خارج الإطار؛ فمثلًا يمكن توسيع مدخل 4:3 إلى 16:9. اختر نسبة مختلفة عن نسبة المصدر لتمديد الإطار بسلاسة.

output_resolution الافتراضي 720p

فئة دقة المخرج، وتكون افتراضيًا خيار 720p المتوازن. اختر 480p لتوليد أسرع أو 1080p لمساحة أكبر، بشرط توافقها مع حدود LTX.

resolution الافتراضي landscape_16_9

أبعاد دقيقة للوحة باستخدام الإعداد القديم، محتفظ بها للتوافق مع الإصدارات السابقة. يجب أن تستخدم الطلبات الجديدة `aspect_ratio` مع `output_resolution` بدلًا من ذلك.

الافتراضي 121

عدد الإطارات في المخرج المولّد.

•مطلوب

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

متقدم negative_prompt · video_quality · video_write_mode · source_scale · video_strength · frames_per_second · num_inference_steps · guidance_scale · seed · enable_prompt_expansion · enable_safety_checker
الافتراضي color distortion, ove...

موجّه سلبي يحدد ما يجب أن يتجنبه التوليد.

video_quality الافتراضي high

إعداد الجودة المطبق على فيديو المخرج.

video_write_mode الافتراضي balanced

وضع كتابة الفيديو الناتج.

الافتراضي 1

مقياس فيديو المصدر داخل اللوحة المستهدفة قبل التوسيع الخارجي؛ يؤدي تقليله إلى إدخال إطار ناتج عن التصغير ويجعل النتائج أقل استقرارًا. لتوسيع نسبة العرض إلى الارتفاع فعليًا، مثل التحويل من 4:3 إلى 16:9، يُوصى بالإعداد 1.0 لملاءمة المصدر بأكبر حجم ممكن داخل اللوحة.

الافتراضي 1

التحكم في الاحتفاظ بالفيديو الأصلي داخل اللوحة الموسعة خارجيًا عبر توجيه فيديو IC-LoRA؛ تؤدي زيادة شدته إلى الحفاظ على المصدر بدرجة أكبر.

الافتراضي 24

معدل إطارات فيديو المخرج، مقاسًا بالإطارات في الثانية.

الافتراضي 15

حدد عدد خطوات الاستدلال المراد تشغيلها، بحد أقصى 30؛ ويؤدي تركه دون تغيير إلى استخدام 15.

الافتراضي 1

اضبط التوجيه الخالي من المصنف باستخدام هذا المقياس؛ ويستهدف ضبطه الافتراضي جودة عالية وتوليدًا سريعًا.

بذرة تجعل التوليد قابلًا لإعادة الإنتاج. يؤدي ضبطها على None إلى اختيار بذرة عشوائيًا.

POST /run/ltx-2.3-quality/outpaint/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.com/v1/run/ltx-2.3-quality/outpaint/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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Ltx 2.3 Quality · Outpaint · LoRA

يوسّع الفيديو على لوحة أكبر ويتطلب قائمة `loras` تضم ما يصل إلى 3 من LoRAs المخصصة (3 GB لكل منها). اضبط `aspect_ratio` (من 21:9 إلى 9:21) و`output_resolution` (480p أو 720p أو 1080p)، إضافةً إلى `prompt` للمناطق الجديدة. يتراوح `source_scale` من 0.25 إلى 1، ويحافظ `video_strength` على المحتوى الأصلي.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
نص يوجه توليد المناطق الموسعة خارج إطار الفيديو.
video_urlمطلوب video
النوعurl · video
الفيديو المصدر الذي ستُمدد حدوده المكانية عبر التوسيع خارج الإطار.
aspect_ratioاختياري
النوعenum
الافتراضي16:9
21:916:94:31:13:49:169:21
نسبة أبعاد التوسيع خارج الإطار؛ فمثلًا يمكن توسيع مدخل 4:3 إلى 16:9. اختر نسبة مختلفة عن نسبة المصدر لتمديد الإطار بسلاسة.
output_resolutionاختياري
النوعenum
الافتراضي720p
480p720p1080p
فئة دقة المخرج، وتكون افتراضيًا خيار 720p المتوازن. اختر 480p لتوليد أسرع أو 1080p لمساحة أكبر، بشرط توافقها مع حدود LTX.
resolutionاختياري
النوعobject
الافتراضيlandscape_16_9
autosquare_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9
أبعاد دقيقة للوحة باستخدام الإعداد القديم، محتفظ بها للتوافق مع الإصدارات السابقة. يجب أن تستخدم الطلبات الجديدة `aspect_ratio` مع `output_resolution` بدلًا من ذلك.
source_scaleاختياري
النوعnumber
الافتراضي1
0.25 – 1
مقياس فيديو المصدر داخل اللوحة المستهدفة قبل التوسيع الخارجي؛ يؤدي تقليله إلى إدخال إطار ناتج عن التصغير ويجعل النتائج أقل استقرارًا. لتوسيع نسبة العرض إلى الارتفاع فعليًا، مثل التحويل من 4:3 إلى 16:9، يُوصى بالإعداد 1.0 لملاءمة المصدر بأكبر حجم ممكن داخل اللوحة.
video_strengthاختياري
النوعnumber
الافتراضي1
0 – 1
التحكم في الاحتفاظ بالفيديو الأصلي داخل اللوحة الموسعة خارجيًا عبر توجيه فيديو IC-LoRA؛ تؤدي زيادة شدته إلى الحفاظ على المصدر بدرجة أكبر.
num_framesاختياري
النوعinteger
الافتراضي121
9 – 481
عدد الإطارات في المخرج المولّد.
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/outpaint/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.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/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/outpaint/lora.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt