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

ID-V2V Relight

التكامل

معرّف النموذج id-v2v/relight
# 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/id-v2v/relight?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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"

ملفات مثل المثال: ⁨‏1.013 $⁩ 1,013 رصيد API تُقاس ملفاتك قبل التشغيل تشغيله في هذه الصفحة

الحصول على مفتاح API
Open model من فيديو إلى فيديو حتى 720p #relighting#editing#cinematic

إعادة إضاءة للفيديو تنشر إضاءة إطار مرجعي مُعاد إضاءته عبر المقطع

Open model · فيديو

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

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

إنشاء طلب

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

•مطلوب

موجّه يحدد الفيديو المطلوب إعادة تصميمه.

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

مرجع الحركة والتأطير للتوليد، ويُقدّم كعنوان URL للفيديو المصدر.

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

مرجع الهوية والأسلوب لإعادة توليد الفيديو، ويُقدّم كعنوان URL يشير إلى الإطار الأول المُعاد تصميمه.

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

اختر 720p لمخرج 1280×720 أو 720×1280، أو 480p لمخرج 832×480 أو 480×832. يحدد اتجاه الفيديو المصدر الأبعاد المنطبقة.

الافتراضي 81

حدّد عدد الإطارات المراد إنتاجها؛ إذا احتوى المصدر على إطارات أقل، يصبح عدد إطاراته الحد الأعلى.

متقدم num_inference_steps · guidance_scale · vace_scale · seed · enable_safety_checker · keyframes
الافتراضي 30

تحكم في جودة المقطع وسرعته، معبّرًا عنه بعدد خطوات أخذ عينات الانتشار لكل مقطع: تحسّن الخطوات الأكثر الجودة لكنها تستغرق وقتًا أطول.

الافتراضي 5

قوة التوجيه الخالي من المصنّف، التي توازن بين الالتزام بالموجّه والإبداع.

الافتراضي 1

الالتزام البنيوي بالفيديو المصدر، ويُضبط عبر مقياس تهيئة VACE.

بذرة عشوائية مشتركة بين جميع المقاطع عند توليد مقاطع متعددة، ما يتيح توليدًا قابلًا لإعادة الإنتاج.

مراسي هوية اختيارية للفيديوهات الطويلة: وفّر إطارات رئيسية مُعاد تصميمها مع مؤشرات إطارات المخرج التي يجب أن تظهر فيها.

POST /run/id-v2v/relight?wait=20 عرض السعر → ⁨‏1.013 $⁩
# 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/id-v2v/relight?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# 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

حول ID-V2V Relight

يغيّر إضاءة فيديو مصدر (`video_url`) باستخدام إطار أول مُعاد إضاءته (`image_url`) و`prompt` مع الحفاظ على المشهد والأداء. يمكن تثبيت ما يصل إلى 5 من `keyframes`. الدقة 480p أو 720p، و`num_frames` من 17 إلى 241، ويحدد `vace_scale` (من 0 إلى 2) مدى تقييد بنية المصدر للإخراج. لا يتوفر موجه تقسيم.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
موجّه يحدد الفيديو المطلوب إعادة تصميمه.
video_urlمطلوب video
النوعurl · video
مرجع الحركة والتأطير للتوليد، ويُقدّم كعنوان URL للفيديو المصدر.
image_urlمطلوب image
النوعurl · image
مرجع الهوية والأسلوب لإعادة توليد الفيديو، ويُقدّم كعنوان URL يشير إلى الإطار الأول المُعاد تصميمه.
keyframesاختياري
النوعobject[]
≤ 5 عناصر
مراسي هوية اختيارية للفيديوهات الطويلة: وفّر إطارات رئيسية مُعاد تصميمها مع مؤشرات إطارات المخرج التي يجب أن تظهر فيها.
keyframes[].image_urlمطلوب
النوعurl · image
عنوان URL لصورة مُعاد تصميمها لمرساة هوية في فيديو طويل؛ يجب ألا تختلف نسبة أبعاد الصورة عن المخرج بأكثر من 0.1. تظهر الصورة دون تعديل عند `frame_index`.
keyframes[].frame_indexمطلوب
النوعinteger
≥ 1
ضع الإطار الرئيسي عند موضع مخرج لا يقل عن 1 وأقل من إجمالي عدد إطارات المخرج، باستخدام الفهرسة التي تبدأ من 0. الموضع 0 محجوز للإطار الابتدائي المُعاد تصميمه من `image_url`.
resolutionاختياري
النوعenum
الافتراضي720p
480p720p
اختر 720p لمخرج 1280×720 أو 720×1280، أو 480p لمخرج 832×480 أو 480×832. يحدد اتجاه الفيديو المصدر الأبعاد المنطبقة.
num_framesاختياري
النوعinteger
الافتراضي81
17 – 241
حدّد عدد الإطارات المراد إنتاجها؛ إذا احتوى المصدر على إطارات أقل، يصبح عدد إطاراته الحد الأعلى.
num_inference_stepsاختياري
النوعinteger
الافتراضي30
2 – 40
تحكم في جودة المقطع وسرعته، معبّرًا عنه بعدد خطوات أخذ عينات الانتشار لكل مقطع: تحسّن الخطوات الأكثر الجودة لكنها تستغرق وقتًا أطول.
guidance_scaleاختياري
النوعnumber
الافتراضي5
1 – 10
قوة التوجيه الخالي من المصنّف، التي توازن بين الالتزام بالموجّه والإبداع.
vace_scaleاختياري
النوعnumber
الافتراضي1
0 – 2
الالتزام البنيوي بالفيديو المصدر، ويُضبط عبر مقياس تهيئة VACE.
seedاختياري
النوعinteger | null
بذرة عشوائية مشتركة بين جميع المقاطع عند توليد مقاطع متعددة، ما يتيح توليدًا قابلًا لإعادة الإنتاج.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكّن فحوصات السلامة على كل من المداخل والمخارج.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "id-v2v/relight",
  "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": 1013,
    "usd": "1.013",
    "charged": 1013,
    "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",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "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
  },
  "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قيمة البذرة المطبّقة أثناء التوليد.

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

لوكلاء الذكاء الاصطناعي: تتوفر هذه الصفحة بصيغة Markdown على https://doitong.com/ar/developers/models/id-v2v/relight.md. جميع النماذج والأدلة: https://doitong.com/developers/llms.txt