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

Editto

التكامل

معرّف النموذج editto
# 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/editto?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

الحصول على مفتاح API
Open model من فيديو إلى فيديو حتى 720p #video-edit#wan-vace

تحرير فيديو قائم على التعليمات يعيد صياغة فيديو مصدر انطلاقًا من موجه، مع التحكم في الإطارات ومعدل الإطارات والدقة

Open model · فيديو

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

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

إنشاء طلب

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

•مطلوب

تعليمات نصية لتوجيه توليد الفيديو.

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

عنوان URL لملف فيديو المصدر؛ مطلوب عند إجراء inpainting.

resolution الافتراضي auto

دقة الفيديو الناتج.

aspect_ratio الافتراضي auto

نسبة العرض إلى الارتفاع للفيديو الناتج.

الافتراضي 81

عدد إطارات المخرج، ضمن نطاق شامل من 81–241.

الافتراضي 0

عدد الاستيفاءات: تترك القيمة 0 الإطارات الأصلية دون استيفاء؛ وتحدد القيم الأخرى عدد الإطارات الوسيطة المطلوب توليدها بينها.

متقدم negative_prompt · sampler · acceleration · video_quality · video_write_mode · frames_per_second · num_inference_steps · guidance_scale · shift · temporal_downsample_factor · seed · match_input_frames_per_second · enable_safety_checker · enable_auto_downsample · return_frames_zip
الافتراضي letterboxing, borders...

الموجّه السلبي المطبق عند توليد فيديو.

sampler الافتراضي unipc

أداة أخذ العينات المستخدمة عند توليد الفيديو.

acceleration الافتراضي regular

إعداد تسريع الاستدلال، مع الاختيار بين 'none' و'regular': توفر المعالجة المسرّعة تحسنًا كبيرًا في السرعة مقابل تغيير طفيف جدًا في المخرج.

video_quality الافتراضي high

مستوى جودة الفيديو الناتج.

video_write_mode الافتراضي balanced

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

الافتراضي 16

معدل إطارات الفيديو المُولّد، ويُطبَّق فقط عندما لا تكون `match_input_frames_per_second` مساوية لـ true؛ والقيم المقبولة هي 5–30 إطارًا في الثانية.

الافتراضي 30

عدد خطوات أخذ العينات، حيث تُبادَل مدة المعالجة الأطول بجودة أفضل مع زيادة العدد.

الافتراضي 5

قوة محاذاة الموجّه التي تُضبط عبر التوجيه الخالي من المصنّف؛ تؤدي زيادة المقياس إلى تشجيع الصور المُولّدة على اتباع النص بدقة أكبر.

الافتراضي 5

إعداد الإزاحة المطبق عند توليد الفيديو.

الافتراضي 0

معامل تخطي إطارات الفيديو، ويُعبَّر عنه كعدد صحيح، مع تطبيق زيادة أخذ عينات تلقائية مرة واحدة لكل معامل خفض لأخذ العينات. استخدم 0 لتعطيل خفض أخذ العينات الزمني.

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

POST /run/editto?wait=20 عرض السعر → ⁨‏0.405 $⁩
# 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/editto?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.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

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

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

حول Editto

يحرر فيديو موجودًا مقدّمًا عبر `video_url` وموجّهًا بواسطة `prompt` نصي. يمكن أن يتبع الإخراج عدد إطارات الإدخال ومعدل إطاراته، أو يستخدم `num_frames` (من 17 إلى 241) و`frames_per_second` (من 5 إلى 30). تتراوح الدقة من 240p إلى 720p، ويمكن أن تكون نسبة العرض إلى الارتفاع auto أو 16:9 أو 1:1 أو 9:16، كما يمكن إرجاع ZIP للإطارات.

المعاملات

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

الاسمالنوع الافتراضيمسموح الوصف
promptمطلوب
النوعstring
تعليمات نصية لتوجيه توليد الفيديو.
negative_promptاختياري
النوعstring
الافتراضيletterboxing, borders, black bars, bright colors, overexposed, static, blurred details, subtitles, style, artwork, painting, picture, still, overall gray, worst quality, low quality, JPEG compression residue, ugly, incomplete, extra fingers, poorly drawn hands, poorly drawn faces, deformed, disfigured, malformed limbs, fused fingers, still picture, cluttered background, three legs, many people in the background, walking backwards
الموجّه السلبي المطبق عند توليد فيديو.
match_input_num_framesاختياري
النوعboolean
الافتراضيfalse
مصدر عدد إطارات الفيديو المُولّد: تستخدم false القيمة `num_frames`، بينما تنسخ true عدد إطارات فيديو المدخل.
num_framesاختياري
النوعinteger
الافتراضي81
17 – 241
عدد إطارات المخرج، ضمن نطاق شامل من 81–241.
match_input_frames_per_secondاختياري
النوعboolean
الافتراضيfalse
مصدر معدل إطارات الفيديو المُولّد: تستخدم false القيمة `frames_per_second`، بينما تنسخ true معدل إطارات فيديو المدخل.
frames_per_secondاختياري
النوعinteger | null
الافتراضي16
5 – 30
معدل إطارات الفيديو المُولّد، ويُطبَّق فقط عندما لا تكون `match_input_frames_per_second` مساوية لـ true؛ والقيم المقبولة هي 5–30 إطارًا في الثانية.
seedاختياري
النوعinteger | null
بذرة تجعل التوليد قابلًا لإعادة الإنتاج. يؤدي ضبطها على None إلى اختيار بذرة عشوائيًا.
resolutionاختياري
النوعenum
الافتراضيauto
auto240p360p480p580p720p
دقة الفيديو الناتج.
aspect_ratioاختياري
النوعenum
الافتراضيauto
auto16:91:19:16
نسبة العرض إلى الارتفاع للفيديو الناتج.
num_inference_stepsاختياري
النوعinteger
الافتراضي30
2 – 50
عدد خطوات أخذ العينات، حيث تُبادَل مدة المعالجة الأطول بجودة أفضل مع زيادة العدد.
guidance_scaleاختياري
النوعnumber
الافتراضي5
1 – 10
قوة محاذاة الموجّه التي تُضبط عبر التوجيه الخالي من المصنّف؛ تؤدي زيادة المقياس إلى تشجيع الصور المُولّدة على اتباع النص بدقة أكبر.
samplerاختياري
النوعenum
الافتراضيunipc
unipcdpm++euler
أداة أخذ العينات المستخدمة عند توليد الفيديو.
shiftاختياري
النوعnumber
الافتراضي5
1 – 15
إعداد الإزاحة المطبق عند توليد الفيديو.
video_urlمطلوب video
النوعurl · video
عنوان URL لملف فيديو المصدر؛ مطلوب عند إجراء inpainting.
enable_safety_checkerاختياري
النوعboolean
الافتراضيfalse
مفتاح فحص الأمان الذي يتطلب إعداد إيقافه تفويض الحساب. من دون هذا التفويض، يُفحص كل طلب بغض النظر عن الإعداد؛ وتفعّل true أداة الفحص.
accelerationاختياري
النوعenum
الافتراضيregular
nonelowregular
إعداد تسريع الاستدلال، مع الاختيار بين 'none' و'regular': توفر المعالجة المسرّعة تحسنًا كبيرًا في السرعة مقابل تغيير طفيف جدًا في المخرج.
video_qualityاختياري
النوعenum
الافتراضيhigh
lowmediumhighmaximum
مستوى جودة الفيديو الناتج.
video_write_modeاختياري
النوعenum
الافتراضيbalanced
fastbalancedsmall
وضع كتابة الفيديو الناتج.
num_interpolated_framesاختياري
النوعinteger
الافتراضي0
0 – 5
عدد الاستيفاءات: تترك القيمة 0 الإطارات الأصلية دون استيفاء؛ وتحدد القيم الأخرى عدد الإطارات الوسيطة المطلوب توليدها بينها.
temporal_downsample_factorاختياري
النوعinteger
الافتراضي0
0 – 5
معامل تخطي إطارات الفيديو، ويُعبَّر عنه كعدد صحيح، مع تطبيق زيادة أخذ عينات تلقائية مرة واحدة لكل معامل خفض لأخذ العينات. استخدم 0 لتعطيل خفض أخذ العينات الزمني.
enable_auto_downsampleاختياري
النوعboolean
الافتراضيfalse
التكيّف التلقائي لعدد الإطارات: يتيح تفعيله للنموذج معالجة فيديو مخفّض العينات زمنيًا بطول مناسب، ثم يعيد الاستيفاء عدد الإطارات الأصلي.
return_frames_zipاختياري
النوعboolean
الافتراضيfalse
يتحكم في ما إذا كان سيُعاد أيضًا أرشيف ZIP يحتوي على كل إطار مُولّد؛ ويُفعَّل عند كون القيمة true.
مطلوب الاسم الأساسي، مقبول أيضًا

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

المخرجات

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "editto",
  "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": 405,
    "usd": "0.405",
    "charged": 405,
    "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,
      "width": 1024,
      "height": 768,
      "fps": 1.0,
      "duration": 5,
      "num_frames": 1
    },
    "prompt": "Make it a Pixel Art video.",
    "seed": 42,
    "frames_zip": {
      "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, width, height, fps, duration, num_frames}ملف الفيديو المُولّد من الصورة.
prompt
stringالموجّه المستخدم لتوليد المخرج.
seed
integerقيمة البذرة المطبّقة أثناء التوليد.
frames_zip
object {url, content_type, file_name, file_size} | nullأرشيف ZIP يحتوي على كل إطار فيديو، ويُعاد عند طلبه.

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