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

Scail 2

التكامل

معرّف النموذج scail-2
# 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/scail-2?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

الحصول على مفتاح API
Open model من فيديو إلى فيديو حتى 704p #stylized#transform

يحرّك صورة شخصية مرجعية بحركة من فيديو قيادة، أو يستبدلها في المشهد الأصلي

Open model · فيديو

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

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

إنشاء طلب

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

•مطلوب

موجّه يحدد فيديو المخرج المطلوب.

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

عنوان URL لصورة مرجعية للشخصية توفر الشخصية المراد تحريكها أو استبدالها بموضوع، بينما يحدد الفيديو المحرّك التحريك أو الاستبدال.

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

وفّر فيديو محرّكًا للحركة عبر عنوان URL، يظهر فيه إنسان واحد أو عدة أشخاص أو حيوان.

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

دقة المخرج مع تحديد الاتجاه تلقائيًا وفق نسبة أبعاد الصورة المرجعية. في الاتجاه الأفقي، تُحوّل 512p إلى 896x512 و704p إلى 1280x704؛ ويستخدم الاتجاه الرأسي 512x896 و704x1280 على التوالي.

متقدم mode · driving_type · subject_type · num_inference_steps · guidance_scale · shift · seed · enable_safety_checker
mode الافتراضي animation

اختر كيفية استخدام الشخصية المرجعية: يحافظ `replacement` على المشهد الأصلي لكنه يستبدل الشخصية بالموضوع المحرّك؛ ويطبّق `animation` حركة الفيديو المحرّك على الشخصية.

driving_type الافتراضي end_to_end

تأتي حركة التحريك مباشرةً من فيديو محرّك مقنّع بواسطة SAM3 مع `end_to_end`، وهو الخيار الافتراضي والموصى به لتحقيق أعلى متانة. بديلًا عن ذلك، يستخدم `pose` ‏NLF/DWPose لرسم هيكل عظمي صريح من ذلك الفيديو، ما يوفر تحكمًا أكبر مع المدخلات الصعبة.

subject_type الافتراضي human

اختيار موضوع الفيديو المحرّك، حيث يضبط `animal` موجّه كشف SAM3 للموضوعات غير-`human`.

الافتراضي 40

عدد خطوات أخذ عينات الانتشار. تؤدي زيادته إلى تحسين الجودة، لكنها تستغرق وقتًا أطول.

الافتراضي 5

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

الافتراضي 3

إزاحة جدول الضوضاء لمطابقة التدفق، مع إعداد موصى به قدره 3.0 عند استخدام 512p.

بذرة التوليد المضمنة في الاستجابة، سواء أُرسلت صراحةً أو اختيرت عشوائيًا لأن المدخل تُرك فارغًا.

POST /run/scail-2?wait=20 عرض السعر → ⁨‏2.00 $⁩
# 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/scail-2?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",
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Scail 2

يستقبل `image_url` لشخصية مرجعية و`video_url` لفيديو قيادة يظهر إنسانًا أو عدة أشخاص أو حيوانًا. في وضع `animation` تؤدي الشخصية الحركة الموجودة في فيديو القيادة؛ وفي وضع `replacement` تستبدل العنصر مع الحفاظ على المشهد. الدقة 512p أو 704p، ويُحدَّد الاتجاه من الصورة. يمكن لـ `driving_type` استخدام قيادة مباشرة من البداية إلى النهاية أو هيكل وضعية صريح.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
موجّه يحدد فيديو المخرج المطلوب.
image_urlمطلوب image
النوعurl · image
عنوان URL لصورة مرجعية للشخصية توفر الشخصية المراد تحريكها أو استبدالها بموضوع، بينما يحدد الفيديو المحرّك التحريك أو الاستبدال.
video_urlمطلوب video
النوعurl · video
وفّر فيديو محرّكًا للحركة عبر عنوان URL، يظهر فيه إنسان واحد أو عدة أشخاص أو حيوان.
modeاختياري
النوعenum
الافتراضيanimation
animationreplacement
اختر كيفية استخدام الشخصية المرجعية: يحافظ `replacement` على المشهد الأصلي لكنه يستبدل الشخصية بالموضوع المحرّك؛ ويطبّق `animation` حركة الفيديو المحرّك على الشخصية.
driving_typeاختياري
النوعenum
الافتراضيend_to_end
end_to_endpose
تأتي حركة التحريك مباشرةً من فيديو محرّك مقنّع بواسطة SAM3 مع `end_to_end`، وهو الخيار الافتراضي والموصى به لتحقيق أعلى متانة. بديلًا عن ذلك، يستخدم `pose` ‏NLF/DWPose لرسم هيكل عظمي صريح من ذلك الفيديو، ما يوفر تحكمًا أكبر مع المدخلات الصعبة.
subject_typeاختياري
النوعenum
الافتراضيhuman
humananimal
اختيار موضوع الفيديو المحرّك، حيث يضبط `animal` موجّه كشف SAM3 للموضوعات غير-`human`.
resolutionاختياري
النوعenum
الافتراضي512p
512p704p
دقة المخرج مع تحديد الاتجاه تلقائيًا وفق نسبة أبعاد الصورة المرجعية. في الاتجاه الأفقي، تُحوّل 512p إلى 896x512 و704p إلى 1280x704؛ ويستخدم الاتجاه الرأسي 512x896 و704x1280 على التوالي.
num_inference_stepsاختياري
النوعinteger
الافتراضي40
2 – 50
عدد خطوات أخذ عينات الانتشار. تؤدي زيادته إلى تحسين الجودة، لكنها تستغرق وقتًا أطول.
guidance_scaleاختياري
النوعnumber
الافتراضي5
1 – 10
قوة التوجيه الخالي من المصنّف، التي توازن بين الالتزام بالموجّه والإبداع.
shiftاختياري
النوعnumber
الافتراضي3
1 – 10
إزاحة جدول الضوضاء لمطابقة التدفق، مع إعداد موصى به قدره 3.0 عند استخدام 512p.
seedاختياري
النوعinteger | null
بذرة التوليد المضمنة في الاستجابة، سواء أُرسلت صراحةً أو اختيرت عشوائيًا لأن المدخل تُرك فارغًا.
enable_safety_checkerاختياري
النوعboolean
الافتراضيtrue
يمكن تخفيف الفحص بضبط القيمة على false، شريطة أن يكون المستدعي مخولًا بذلك.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "scail-2",
  "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": 2000,
    "usd": "2.00",
    "charged": 2000,
    "refunded": 0
  },
  "input": {
    "prompt": "A red fox trots through fresh snow at sunrise, soft golden light, shallow depth of field",
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg",
    "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,
    "preprocessing_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
    },
    "preprocessing_mask_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
    }
  },
  "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البذرة المستخدمة لتوليد الفيديو.
preprocessing_video
object {url, content_type, file_name, file_size} | nullفيديو تصحيح يتضمن مدخل تكييف الوضعية Stage-A المقدم إلى نموذج الانتشار، وهو متاح فقط مع `output_preprocessing=true`. يعتمد محتواه على `driving_type`: يستخدم `end_to_end` لقطات محرّكة مقنّعة بواسطة SAM3، بينما يستخدم `driving_type=pose` هيكلًا عظميًا مرسومًا بواسطة NLF/DWPose.
preprocessing_mask_video
object {url, content_type, file_name, file_size} | nullفيديو قناع القيادة Stage-A للتصحيح، وهو متاح فقط مع `output_preprocessing=true`.

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